aidokitwiki
User Docs Wiki

Scenario: Write a PRD/BRD/spec first

Audience-User Status-Shipped v0.5

When to use #

You already have (or want to write) a PRD, BRD, or design spec, and you want Intake to digest it into a citation-backed task list rather than starting from a one-paragraph prompt. The digest sub-stage is the path.

At a glance #

%%{init: {
  "theme": "base",
  "themeVariables": {
    "fontFamily": "ui-sans-serif, system-ui, -apple-system, Segoe UI, sans-serif",
    "fontSize": "14px",
    "primaryColor": "#eff6ff",
    "primaryTextColor": "#0f172a",
    "primaryBorderColor": "#2563eb",
    "lineColor": "#475569",
    "secondaryColor": "#f1f5f9",
    "tertiaryColor": "#ffffff",
    "clusterBkg": "#f8fafc",
    "clusterBorder": "#cbd5e1"
  }
}}%%
flowchart LR
  classDef actor    fill:#ede9fe,stroke:#6d28d9,color:#1e1b4b,stroke-width:1.2px;
  classDef cli      fill:#dbeafe,stroke:#1d4ed8,color:#0c1f4a,stroke-width:1.4px;
  classDef adapter  fill:#cffafe,stroke:#0e7490,color:#083344;
  classDef pack     fill:#dcfce7,stroke:#15803d,color:#052e16;
  classDef core     fill:#fef9c3,stroke:#a16207,color:#422006;
  classDef artifact fill:#f1f5f9,stroke:#475569,color:#0f172a;
  classDef stop     fill:#fee2e2,stroke:#b91c1c,color:#7f1d1d,stroke-dasharray:4 3;
  classDef ok       fill:#ecfdf5,stroke:#047857,color:#064e3b;
  classDef external fill:#fff7ed,stroke:#c2410c,color:#431407;
  you(["you"]):::actor
  prd["docs/prd.md"]:::artifact
  intake["/intake --brownfield"]:::cli
  dig["digest sub-stage"]:::core
  cap["capability decomposition"]:::artifact
  briefs["task briefs"]:::artifact
  impl["/implement-task"]:::cli
  you --> prd --> intake --> dig --> cap --> briefs --> impl

Step-by-step #

1. Place the PRD in the project #

Put PRD/BRD/spec files under docs/ (e.g., docs/prd.md, docs/brd.md). The digest skill scans this tree by default.

Expected: docs/prd.md exists and is committed (or at least staged).

2. Open your AI CLI #

If Claude Code

claude

If Codex

codex

If Copilot

gh copilot

3. Run intake with the PRD as input #

/intake --brownfield "ingest docs/prd.md and propose tasks"

Expected: the digest sub-stage (Researcher skill) fires.

4. Review the digest report #

Path: agent-artifacts/digest-<timestamp>.md.

Expected contents:

5. Approve and let Planner produce briefs #

Once the digest report is approved, Planner produces task briefs under agent-artifacts/briefs/.

Expected: one brief per planned task, each scoped to a single capability.

6. Implement #

/implement-task

Expected: Builder picks the first brief; the rest of the loop is standard.

Common mistakes #

See also #