Skip to main content

change-traceability-review

Use for change traceability review across specs, commits, PRs, branches, local diffs, and git history, including Spec Preparation, Review Readiness Checks, and Review Retrospectives, to generate or verify Story-linked specs, commit-message evidence, test evidence, risk signals, AI involvement, and review-flow improvement suggestions.

Source facts

Repository
QoderAI/better-harness
Last source activity
July 27, 2026 at 08:18
Detected SKILL.md language
English
Stars
2,383
Forks
193

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
6 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
change-traceability-review
description
Use for change traceability review across specs, commits, PRs, branches, local diffs, and git history, including Spec Preparation, Review Readiness Checks, and Review Retrospectives, to generate or verify Story-linked specs, commit-message evidence, test evidence, risk signals, AI involvement, and review-flow improvement suggestions.
# Change Traceability Review Review the traceability behind a change, not code style: Story or issue -> Spec -> plan/tasks -> commit/branch/PR -> diff -> tests -> risk. Default to Chinese and keep the report compact and decision-oriented. Treat specs as the review source of truth; code is acceptable when it clearly serves the spec. ## Modes - **Spec Preparation**: before implementation or commit, create or tighten a Story-linked spec and define acceptance scenarios, plan/tasks, tests, and risk evidence that later commits can cite. Load [Spec Contract](references/spec-contract.md). - **Review Readiness Check**: inspect the current diff, staged diff, PR text, branch, or selected commits before review/merge. Load [Mode Rules](references/mode-rules.md) and [Reporting](references/reporting.md). - **Review Retrospective**: inspect recent history, usually latest 30 commits. Identify commit-message habits, weak traceability, missing Spec/Test/Risk evidence, oversized or mixed-scope commits, spec-doc patterns, and rework signals. Load [Mode Rules](references/mode-rules.md) and [Reporting](references/reporting.md). ## Entry and Routing 1. Identify the mode from the user's request or the current review surface. 2. Read repo instructions first: nearest `AGENTS.md`, plugin manifests, and the target spec or diff. 3. Gather bounded local evidence using [Evidence Commands](references/evidence-commands.md). 4. Apply the relevant contract: - Spec Preparation: [Spec Contract](references/spec-contract.md) - Commits: [Commit Contract](references/commit-contract.md) - Any review: [Mode Rules](references/mode-rules.md) 5. Produce the report using [Reporting](references/reporting.md). Keep generated helpers and local experiments outside `SKILL.md` unless they are durable resources the skill must use.
View on GitHub