Skip to content
cccskills
FreePublished on GitHub

vcsdd-convergence-detection

Use this skill during Phase 6 convergence checks. Provides four-dimensional convergence analysis, hallucination detection, and duplicate finding identification.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md1.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

VCSDD Convergence Detection

When to Activate

  • Phase 6 (convergence check)
  • Comparing adversary review iterations
  • Detecting hallucinated file references

Four Convergence Dimensions

1. Finding Diminishment

Compare finding counts across iterations:

Iteration 1: 8 findings
Iteration 2: 4 findings  <- diminishment ok
Iteration 3: 6 findings  <- NOT diminishing (re-review needed)

Convergent when: monotonically decreasing OR zero findings.

2. Finding Specificity (Hallucination Detection)

For every finding, verify evidence.filePath is a real file:

for finding in .vcsdd/features/<name>/reviews/sprint-*/output/findings/*.json; do
  filepath=$(jq -r '.evidence.filePath' "$finding")
  ls "$filepath" 2>/dev/null || echo "HALLUCINATED: $filepath in $finding"
done

Convergent when: zero hallucinated file paths.

3. Criteria Coverage

All contract criteria must have been evaluated:

  • Read contracts/sprint-N.md for all CRIT-XXX IDs
  • Verify each CRIT-XXX appears in grading verdict Convergent when: all criteria evaluated.

4. Duplicate Detection

Compare current findings against previously-addressed findings:

  • A finding is a duplicate if it describes the same issue as a FIND-XXX that has resolution.status = "fixed" Convergent when: zero duplicates.

Convergence Verdict

CONVERGED = all 4 dimensions satisfied
NOT CONVERGED = any dimension fails -> route back to Phase 3
ESCALATE = convergence iteration limit (2) exceeded -> human review

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Use this skill when running or interpreting VCSDD adversarial reviews. Provides calibration guidance for the Adversary agent, finding severity classification, and anti-leniency enforcement patterns.

The English summary is being prepared. Showing the original description.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

Run Phase 3 (adversarial review) for the active VCSDD feature. Spawns a fresh vcsdd-adversary agent with zero Builder context to review implementation against spec. Produces binary PASS/FAIL verdict per dimension.

The English summary is being prepared. Showing the original description.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

Create a git commit for the current VCSDD phase. Auto-generates a conventional commit message from state.json including phase, sprint, gate verdict, and affected bead IDs. Tags with vcsdd/<feature>/phase-<id>.

The English summary is being prepared. Showing the original description.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

Run the strict-mode sprint contract review after Phase 2c. Spawns a fresh vcsdd-adversary instance to review `contracts/sprint-N.md` and writes a PASS/FAIL verdict under `reviews/contracts/sprint-N/output/`.

The English summary is being prepared. Showing the original description.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

Run Phase 6 (convergence check) for the active VCSDD feature. Validates four-dimensional convergence: finding diminishment, finding specificity, criteria coverage, and duplicate detection.

The English summary is being prepared. Showing the original description.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

Architect escalation approval — extend iteration limit for a phase that has hit its cap. Records the approval decision in state and allows the blocked transition to proceed.

The English summary is being prepared. Showing the original description.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

See all skills by sc30gsw

Report a problem with this skill