BMAD-METHOD/src/bmm-skills/2-plan-workflows/bmad-prd/references/headless.md

1.1 KiB

Headless Mode

Load this file when bmad-prd is invoked headless (no interactive user). Follow it for the whole run.

General

Do not ask. Complete the intent using what is provided, what exists in {doc_workspace}, or what you can discover yourself. If intent remains ambiguous after inference, halt with a blocked JSON status and a reason field — do not prompt. Do not greet.

End with a JSON response listing status, intent, and artifact paths. The intent field must match the detected intent: "create", "update", or "validate". Omit keys for artifacts not produced. Full schemas with examples for each intent are in assets/headless-schemas.md. Minimal shape:

{
  "status": "complete",
  "intent": "validate",
  "validation_report": "{doc_workspace}/validation-report.md",
  "offer_to_update": true
}

Mode-specific overrides

Update. Log the reversal to decision-log.md, then apply. Halt blocked if intent is ambiguous.

Validate. Always write validation-report.md to {doc_workspace} regardless of finding count. Always include "offer_to_update": true in the JSON status block.