1.1 KiB
1.1 KiB
Step 3: source-review-outline
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
- /phases/0-report-generation/index.json
Task
Review docs/RESEARCH_LOG.md for source quality, source freshness, conflicts, weak claims, and missing evidence. Then create or refine the report outline in docs/REPORT_DRAFT.md.
The outline must reflect the report purpose, keywords, direction, audience, and output format from docs/PRD.md. Include placeholders for key claims, supporting sources, risks, uncertainty, and feedback questions.
Acceptance Criteria
python scripts/validate_workspace.py
Verification
- Run the acceptance command.
- Confirm the outline follows
docs/UI_GUIDE.md. - Confirm major sections have evidence sources or explicit evidence gaps.
- Update this step in
phases/0-report-generation/index.json.
Do Not
- Do not hide source weaknesses because they are inconvenient.
- Do not delete useful research history from
docs/RESEARCH_LOG.md. - Do not write polished conclusions that are not supported by the reviewed sources.