document-intake

Normalize PRDs, RFCs, diagrams, and wiki exports into a repo-grounded intake index.

2|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/iadr-dev/colab --skill document-intake
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-intake
Source: https://github.com/iadr-dev/colab/tree/main/skills/document-intake
Command: npx skills add https://github.com/iadr-dev/colab --skill document-intake

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) and references (resource) components.

What problem does it solve?

It prevents teams from wasting time aligning on requirements scattered across PRDs, RFCs, wiki exports, and pasted snippets by normalizing them into a traced, repo-grounded intake artifact.

Core Features & Use Cases

  • Source inventory with roles: Captures every provided path/URL/paste and tags each item with a requirement role (product, architecture, api, data_flow, design, testing, security, unknown).
  • Repo-first reconciliation and traceability: Loads .ohc/PROJECT.md, compares claims to the codebase, and records conflicts, stale sections, and gaps without hiding uncertainty.
  • Canonical indexing for execution: Writes/updates .ohc/doc-sources.md using assets/doc-sources.template.md, creating a single index that agents use to plan and implement.
  • Plan handoff with a BUILD gate: Produces a narrowed writing-plans handoff that includes unresolved questions and conflicts, then blocks implementation until the user confirms.

Quick Start

Ask your agent to run document-intake for an external PRD set of links so it produces .ohc/doc-sources.md and a plan covering unresolved conflicts.

Frequently Asked Questions about document-intake

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I normalize scattered PRDs and RFCs into a single requirements trace?

Normalizing scattered PRDs and RFCs involves inventorying all provided paths and URLs, tagging each with a requirement role, and reconciling claims against the codebase to produce a canonical `.ohc/doc-sources.md` index.

What is document intake for product planning?

Document intake is the process of consolidating external specifications like wiki exports and diagrams into a repo-grounded artifact that captures source roles, identifies staleness, and prepares a gated handoff plan.

How do I reconcile external requirements against my codebase?

Reconciling external requirements against your codebase involves loading `.ohc/PROJECT.md`, comparing incoming claims to the existing repository state, and explicitly recording unresolved conflicts, stale sections, and gaps.

Can I use document intake for repeated specifications updates?

Yes, document intake supports repeated specifications updates by continuously writing and updating a canonical `.ohc/doc-sources.md` index, allowing subsequent intakes to append or reconcile new sources.

How to handle requirement conflicts before implementation planning?

Handling requirement conflicts before implementation planning involves generating a gated handoff plan under `.ohc/plans/` that includes unresolved questions and blocks build execution until user confirmation.

Does document intake require a build gate for execution?

Yes, document intake requires a build gate for execution because it produces a narrowed writing-plans handoff that blocks implementation until the user reviews conflicts and explicitly confirms.