35 lines
1.2 KiB
Markdown
35 lines
1.2 KiB
Markdown
# Step 0: brief-audit
|
|
|
|
## Read First
|
|
- /AGENTS.md
|
|
- /docs/PRD.md
|
|
- /docs/ARCHITECTURE.md
|
|
- /docs/ADR.md
|
|
- /docs/UI_GUIDE.md
|
|
- /docs/RESEARCH_LOG.md
|
|
- /docs/REPORT_DRAFT.md
|
|
- /docs/FEEDBACK.md
|
|
|
|
## Task
|
|
Audit `docs/PRD.md` for the minimum report inputs: topic, purpose, keywords, direction, audience, output format, required questions, exclusions, and success criteria.
|
|
|
|
If the brief is usable, update `docs/RESEARCH_LOG.md` with a concrete research question list derived from the brief. If a critical input is still a placeholder or empty, update this step in `phases/0-report-generation/index.json` as `blocked` with a concise `blocked_reason` and stop.
|
|
|
|
## Acceptance Criteria
|
|
```bash
|
|
python scripts/validate_workspace.py
|
|
```
|
|
|
|
## Verification
|
|
1. Run the acceptance command.
|
|
2. Confirm the report brief has enough information to guide research.
|
|
3. Confirm `docs/RESEARCH_LOG.md` contains research questions aligned with the brief.
|
|
4. Update this step in `phases/0-report-generation/index.json`:
|
|
- `completed` + `summary`
|
|
- `blocked` + `blocked_reason`
|
|
- `error` + `error_message`
|
|
|
|
## Do Not
|
|
- Do not invent missing report intent because later research will follow the wrong direction.
|
|
- Do not start drafting the report in this step.
|