33 lines
1.1 KiB
Markdown
33 lines
1.1 KiB
Markdown
# 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
|
|
```bash
|
|
python scripts/validate_workspace.py
|
|
```
|
|
|
|
## Verification
|
|
1. Run the acceptance command.
|
|
2. Confirm the outline follows `docs/UI_GUIDE.md`.
|
|
3. Confirm major sections have evidence sources or explicit evidence gaps.
|
|
4. 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.
|