src/bmm-skills/ship/bmad-build/step-05-present.md
{{.communication_language}}. Write any file output in {{.document_output_language}}.Read {baseline_commit} from {spec_file} frontmatter and construct the diff of all changes since that commit.
Append the review order as a ## Suggested Review Order section to {spec_file} after the last existing section. Do not modify the Code Map.
Build the trail as an ordered sequence of stops — clickable path:line references with brief framing — optimized for a human reviewer reading top-down to understand the change:
{spec_file}'s directory to the changed file. Format each stop as a markdown link: [short-name:line](../../path/to/file.ts#L42). Use a #L line anchor. Use the file's basename (or shortest unambiguous suffix) plus line number as the link text. The relative path must be dynamically derived — never hardcode the depth.Format each stop as framing first, link on the next indented line:
## Suggested Review Order
**{Concern name}**
- {one-line framing}
[`file.ts:42`](../../src/path/to/file.ts#L42)
- {one-line framing}
[`other.ts:17`](../../src/path/to/other.ts#L17)
**{Next concern}**
- {one-line framing}
[`file.ts:88`](../../src/path/to/file.ts#L88)
The
../../prefix above is illustrative — compute the actual relative path from{spec_file}'s directory to each target file.
When there is only one concern, omit the bold label — just list the stops directly.
Change {spec_file} status to done in the frontmatter.
Follow [[bmad-snapshot:sync-sprint-status.md]] with target_status = review.
If version control is available and the tree is dirty, create a local commit with a conventional message derived from the spec title.
{workflow.open_spec}
Display summary of your work to the user, including the commit hash if one was created. Any file paths shown in conversation/terminal output must use CWD-relative format (no leading /) with :line notation (e.g., src/path/file.ts:42) for terminal clickability — the goal is to make paths clickable in terminal emulators.
Offer to push and/or create a pull request.
Workflow complete.
If anything appears below, follow it as the final terminal instruction before exiting; otherwise exit normally.
{workflow.on_complete}