Skip to main content
These commands install SDLC Harness, audit repository state, and read governance results. Except for init and adopt, they require the current directory to contain files generated by SDLC Harness.

init

Generate the complete SDLC Harness protocol files in the current directory.
On success, init prints the number of files written and returns 0. It exits nonzero for conflicts or write failures. Because --force overwrites existing content, review the conflict list before using it.

adopt

Add SDLC Harness to an existing project while writing only missing files.
This command has no arguments. Existing files remain unchanged. If the repository already has an AGENTS.md, Harness rules are written to AGENTS.sdlc-harness.md, which you must reference from the existing AGENTS.md.

validate

Run all repository governance audits.
This command has no arguments. When every audit passes, it prints All checks passed. and returns 0. If any governance rule fails, it prints categorized errors and returns nonzero. validate audits repository records for compliance; it does not execute the verification commands declared by features.

status

Output a JSON summary of current features, approvals, traceability gaps, and recommended next steps.
This command has no arguments and does not modify the repository. See Status and traceability output for field definitions.

traceability

Build and output the complete traceability matrix.
This command has no arguments and does not modify the repository. When the matrix applies, any actual gap makes the command return nonzero, including uncovered requirements, orphan stories or features, and uncovered or unverified acceptance criteria. It returns 0 when there are no actual gaps. See Status and traceability output for field definitions.