sdd-review
Independent, traceable code review of one SDD Composy task in review_required against its approved PRD, stories, TechSpec, evidence, and project rules, with stable findings and severities. Use when a
SKILL.mdplugins/sdd-composy/skills/sdd-review/SKILL.md
GitHubSDD Review
This portable skill performs an independent code review of one task in review_required: an
explicit base and target diff scope against the approved contracts (requirements, stories,
architecture), the task evidence, and the project rules. Read templates/codereview.md and render it, keeping its
frontmatter keys and headings exactly (translate prose only).
Language: before writing human-facing prose, run scripts/sdd_language.py <repo-root> and use the persisted language; on not_initialized, return it with next_action: run_init. Localization rules: references/language.md.
Procedure
- Validate that the declared base, target, and changed paths are explicit and confined. Stop on an ambiguous or expanded diff scope.
- Read only the approved contracts, current task evidence, and applicable project rules. Do not change them or infer approval from their existence.
- Run and record the exact verification commands, environment, exit codes, and confined evidence paths.
- Check skill conformity: confirm the change was produced through the SDD task contract and its skills, not around them (no adapter bypass, no edited approvals).
- Record every finding with a stable ID, severity (
BLOCKER,HIGH,MEDIUM,LOW,INFO), file and line, evidence, and rule citations or contract citations. Do not silently fix, hide, or rewrite a finding; an unapproved change requires a new review. - Produce an OKF v0.2
CODE_REVIEWreport. A complete human-approved report recordsscripts/sdd_tasks.py evidence <state> <TASK-ID> review --status approvedand transitions toverify_required; any blocker, missing evidence, scope ambiguity, contract violation, or non-conformity recordsreview --status rejectedand transitions torejected --reason <text>.
Read when
references/quality.md— writing the report (evidence and gate semantics shared with QA).
Output
Return the report path, exact base/target scope, approved contracts consumed, findings and severities, cited rules, commands and exit codes, skill conformity, blocker status, the no-silent-fix result, lifecycle status, and permitted next transition. Keep generation and verification actors separate. Do not edit source, requirements, stories, architecture, task evidence, or the review to make checks pass, and do not stop user-owned services.
Safety: Do not commit, push, or publish. Do not read or expose .env, credentials, tokens, private keys, certificates, or fleet environment files. Full contract: references/safety.md.