Skills › BMAD Method › bmad-walkthrough › step-02-narrative.md
step-02-narrative.md
25 lines · skills/bmad-walkthrough/step-02-narrative.md at bd70c64
1# Step 2: Create review narrative
3Write the review narrative and the review log in a new folder
4`walkthrough-<slug>/` under
5`{{ initiative_folder }}/`: the narrative as
6`walkthrough-<slug>.md`, the log as `walkthrough-<slug>-log.md`.
7`<slug>` is a short review slug; check that the folder name is
8unused before creating it.
10- **Review narrative:** Write blocks in the Block shapes. Use
11 unchecked boxes for unvisited, in-progress, or reopened blocks,
12 labeling their state; check a block when the user indicates they
13 are satisfied with it. Note whether it changed during review and
14 identify the current block. Work performed on a block does not
15 itself mean it is accepted.
16- **Review log:** Read and use `{{ rendered("templates/log-template.md") }}`.
17 Keep findings, decisions, edits, and test results out of the review
18 narrative.
20If you are running in a sidebar of VS Code, Cursor, or another
21editor, open the narrative file in the editor.
Step 2: Create review narrative
Write the review narrative and the review log in a new folder walkthrough-<slug>/ under {{ initiative_folder }}/: the narrative as walkthrough-<slug>.md, the log as walkthrough-<slug>-log.md. <slug> is a short review slug; check that the folder name is unused before creating it.
- Review narrative: Write blocks in the Block shapes. Use unchecked boxes for unvisited, in-progress, or reopened blocks, labeling their state; check a block when the user indicates they are satisfied with it. Note whether it changed during review and identify the current block. Work performed on a block does not itself mean it is accepted.
- Review log: Read and use
{{ rendered("templates/log-template.md") }}. Keep findings, decisions, edits, and test results out of the review narrative.
If you are running in a sidebar of VS Code, Cursor, or another editor, open the narrative file in the editor.
Raw lines 1 to 22