Doc Prd Autopilot

doc-prd-autopilot

Purpose

Automated PRD generation pipeline. From an upstream BRD, a user prompt, or an implementation plan (IPLAN-*), it analyzes the source, derives product scope, generates a complete PRD, validates EARS-readiness, maintains PRD-00_index.md, and drives the audit↔fix cycle to a passing score — for one PRD or a batch.

Layer: 2. Upstream: a BRD (or prompt/IPLAN input). Downstream: a validated PRD + index entry.

Skill Dependencies

Input Contract

Accepts: a target PRD id/path; a source BRD id/path; a free-text prompt; or an IPLAN path. Optional: score threshold (default 90), max fix iterations (default 3), batch list. With no explicit input, treat the request as a prompt. Precedence when multiple are given: IPLAN > BRD/REF > prompt; conflicting objective/scope is blocking and requires user clarification.

Smart Document Detection

For each target, check whether the PRD already exists (nested folder docs/02_PRD/PRD-NN_{slug}/):

• Missing → generate mode (from the source BRD/prompt/IPLAN).
• Exists → review & fix mode (audit, then fix if below threshold).

A BRD-NN input maps to the corresponding PRD: generate if missing, review if it already exists. Determine deliverable_type (code/document/ux/risk/process) inherited from the source BRD.

Model precheck

Advisory, best-effort. Surfaces the model you recommended for this layer; it cannot switch the session model. Before invoking the driver:

1. If .claude/aidoc-flow.config.yaml is absent, or has no model.* keys, skip this section entirely (no output).
2. Resolve the recommended model: model.per_layer.PRD if set, else model.default.
3. Act on model.precheck (warn | silent | block):
   • warn (default) — print one line, then continue to the driver: ℹ PRD recommends model '<rec>'. If you're not on it, run /model <rec> (or set model.precheck: silent to hide this).
   • silent — print nothing; continue.
   • block — print the line above plus precheck=block: confirm you want to draft on the current model, or run /model <rec> first., then wait for the user to confirm before continuing.

Workflow

Saga-driven generation loop (review_mode: team)

Step 1 — Invoke the driver. Period. The harness sets PREV_OUTPUT, ARTIFACT_ID, ARTIFACT_PATH env vars before invoking this SKILL. Your first orchestration action MUST be the Bash tool (the Model precheck above runs first), running exactly:

python3 "${CLAUDE_PLUGIN_ROOT}/tools/saga_driver.py" \
  --layer 02_PRD \
  --allow-skip-permissions

--allow-skip-permissions lets the phases the driver dispatches write files without a permission prompt — unattended autopilot requires it. Drop the flag to run the same loop with Claude Code's normal prompts on.

Use a generous timeout (≥1800s). Do not pre-analyze the input. Do not read the BRD. Do not classify type/scope. The driver and its dispatched subprocesses (/aidoc-flow:doc-prd for draft, /aidoc-flow:doc-prd-audit for review, /aidoc-flow:doc-prd-fixer for fixer) handle all of that. The driver enforces the state machine preemptively per ${CLAUDE_PLUGIN_ROOT}/framework/governance/REVIEW_SAGA.md; this SKILL's job is to invoke it and report.

Step 2 — After the driver returns, report. Read .aidoc/review/02_PRD/${ARTIFACT_ID}/saga.json. Final status MUST be one of CLOSED (PASS), ESCALATED (terminal FAIL), or PARTIAL_TIMEOUT (soft-deadline; resumable). Print the status, the final score from verdict.json if present, and a 1-line summary.

Step 3 — Index update (only on CLOSED). Add a row to docs/02_PRD/PRD-00_index.md referencing the new PRD; update the parent BRD's downstream entry.

That is the entire workflow in team mode. If you find yourself doing anything else here — drafting prose, dispatching Task subagents, invoking other slash commands — STOP, recognize that you are bypassing the driver, and invoke the Bash command above instead.

Linear Pipeline (review_mode: single_pass)

Unchanged legacy behaviour — used when the profile says so, when Task subagent dispatch is unavailable, or at write-time (on_author) where cost is the primary concern. The 5-step in-session pattern below produces the PRD without saga.json; the harness's saga-journal check will then fail the layer, so this mode is only appropriate for manual dry-runs.

1. Input analysis — classify the input (BRD / prompt / IPLAN), locate the source material, and decide generate vs review-and-fix.
2. BRD readiness — when generating from a BRD, confirm it passes ../doc-brd-audit/SKILL.md (PRD-Ready ≥ threshold); read all BRD section files as one document; reserve the next PRD-NN.
3. Generation — produce the PRD per ../doc-prd/SKILL.md: Document Control first (with @brd: reference + EARS-Ready score), all 15 sections, §10 in ≥3 categories, §14 ADR-topic elaboration (no ADR numbers), element IDs PRD.NN.SS.xxxx, cumulative @brd: tags, diagram tags via ../charts-flow/SKILL.md (c4-l2/dfd-l2/sequence-sync with alt/else).
4. Validation — run ../doc-prd-audit/SKILL.md from scratch.
5. Audit ↔ fix cycle — while score < threshold and iterations < max: run ../doc-prd-fixer/SKILL.md, then re-audit. On pass, update docs/02_PRD/PRD-00_index.md and the parent BRD's downstream entry; on exhausting iterations, flag for manual review.

Execution Modes

• Single — one PRD (generate or review-and-fix).
• Batch — multiple PRDs, processed in chunks of 3 to bound context; generate each PRD only after its source BRD is ready.
• Dry-run — report the planned actions (source, sections, IDs) without writing files.

Quality Gates

• Generation does not complete until the audit passes (EARS-Ready ≥ threshold, 0 Tier-1 errors) or the iteration cap is hit (then: manual-review flag).
• The PRD index and parent-BRD downstream entry are updated only after a PRD passes.
• Fresh audit every cycle — no cached scores.

Error Handling

Adaptation

Before applying defaults, read the project adaptation profile (.aidoc/profile.yaml) and apply it in both the generation and the internal audit/fix phases. Honor section_toggles, active_layers, audit_threshold (raise-only — stricter only), and glossary. Ignore any unknown or out-of-surface key; absent a profile, use framework defaults. Authority: ${CLAUDE_PLUGIN_ROOT}/framework/governance/ADAPTATION.md.

Related Resources

• Create: ../doc-prd/SKILL.md · Audit: ../doc-prd-audit/SKILL.md · Fix: ../doc-prd-fixer/SKILL.md
• Authority: ${CLAUDE_PLUGIN_ROOT}/framework/layers/02_PRD/PRD-TEMPLATE.yaml, ${CLAUDE_PLUGIN_ROOT}/framework/layers/02_PRD/README.md, ${CLAUDE_PLUGIN_ROOT}/framework/layers/02_PRD/PRD-00_index.TEMPLATE.md