vcsdd-contract-review | vcsdd | ClaudePluginHub

Skill

vcsdd-contract-review

Runs strict-mode sprint contract review after Phase 2c, spawning fresh vcsdd-adversary to verify contracts/sprint-N.md against specs/tests/source and output PASS/FAIL verdict to reviews/contracts/sprint-N/output/.

$

npx claudepluginhub sc30gsw/vcsdd-claude-code --plugin vcsdd

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Runs the sprint contract review gate. The adversary reviews the current sprint contract, the authoritative specs, and the current test/source artifact set to verify that the contract criteria are concrete, binary-evaluable, and aligned with what Phase 3 will judge.

SKILL.md

Similar Skills

vcsdd-adversary

16

Runs Phase 3 adversarial review for VCSDD feature implementation against spec across 5 dimensions (spec_fidelity, edge_case_coverage, etc.), spawning isolated agent for binary PASS/FAIL verdicts per dimension.

creview-spec

49

Orchestrates multi-agent adversarial review of specs by spawning red team, assumptions auditor, testability auditor, and design contract checker. Requires high intensity; use after /cspec or /cmodel.

9 tools

skill-lookup

159.9k

Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.

Stats

Stars16

Forks0

Last CommitApr 1, 2026

Actions

View Source View Plugin View on GitHub View README

Tags

sprint-contract-review

adversary-review

contract-verification

Help us improve

Share bugs, ideas, or general feedback.

What

Runs the sprint contract review gate. The adversary reviews the current sprint contract, the authoritative specs, and the current test/source artifact set to verify that the contract criteria are concrete, binary-evaluable, and aligned with what Phase 3 will judge.

When

Run after /vcsdd-impl completes Phase 2c and after the builder updates contracts/sprint-N.md. Requires the active feature to still be at phase 2c. Required in strict mode before /vcsdd-adversary. Optional in lean mode when a sprint contract is still being used.

How

Resolve sprint number from state.json.sprintCount
Validate contract exists at contracts/sprint-N.md
- must parse against vcsdd-contract.schema.json
- should normally be in draft or under-review while negotiating
- must contain at least one CRIT-XXX

Write review manifest to reviews/contracts/sprint-N/input/manifest.json:

compute contractDigest from the reviewed contract snapshot with line endings normalized and the status: frontmatter line ignored

{
  "reviewType": "contract",
  "featureName": "...",
  "sprintNumber": 1,
   "contractPath": "contracts/sprint-1.md",
   "contractDigest": "<sha256-of-reviewed-contract-with-status-normalized>",
   "artifactsToReview": {
     "spec": ["specs/behavioral-spec.md", "specs/verification-architecture.md"],
     "tests": ["tests/..."],
     "source": ["src/..."]
   },
  "reviewDimensions": ["spec_fidelity", "edge_case_coverage", "implementation_correctness", "structural_integrity", "verification_readiness"]
}

Create output directories: reviews/contracts/sprint-N/output/findings/
Spawn FRESH vcsdd-adversary agent with zero Builder context
Collect outputs after adversary completes:
- reviews/contracts/sprint-N/output/verdict.json
- reviews/contracts/sprint-N/output/findings/FIND-NNN.json
- contract-review verdicts must set:
  - reviewContext.reviewType = "contract"
  - reviewContext.contractPath = "contracts/sprint-N.md"
  - reviewContext.contractDigest = manifest.contractDigest
  - iteration = negotiationRound + 1
Interpret verdict:
- PASS: the human may update contracts/sprint-N.md to status: approved
  - after PASS, only the status field may change without rerunning review
  - any substantive contract edit changes the digest and requires a new contract review
- FAIL: revise the contract, increment negotiationRound, and rerun
Negotiation limit: maximum 2 rounds before human escalation

Gate Semantics

Strict-mode Phase 3 requires both:

contracts/sprint-N.md with status: approved
reviews/contracts/sprint-N/output/verdict.json with:
- overallVerdict: "PASS"
- matching reviewContext.contractPath
- matching reviewContext.contractDigest
- iteration = negotiationRound + 1

This prevents self-approved or post-review-edited sprint contracts from bypassing the adversarial gate.

Examples

/vcsdd-contract-review
/vcsdd-contract-review --sprint 2