From vcsdd
Validates Coherence Graph (CEG) for structural integrity: reference integrity of edge IDs to nodes and cycle detection in dependency graphs from spec frontmatter. Run after coherence-scan or before Phase 2a gates.
npx claudepluginhub sc30gsw/vcsdd-claude-code --plugin vcsddThis skill uses the workspace's default tool permissions.
Validate the CEG for structural integrity:
Rebuilds Conditioned Evidence Graph (CEG) from coherence: or codd: frontmatter in Markdown spec files. Tracks spec-implementation dependencies for current change-impact analysis.
Verifies V-Model artifact graph integrity: checks dead links, backlog completeness, references in Epics, Features, Success Criteria, ADRs, arc42 sections, PLANs, Wayfinder rows, and code. Syntactic mode default; semantic on request.
Reviews GRACE project integrity by validating semantic markup, module contracts, knowledge graph synchronization, and verification plans. Supports scoped-gate, wave-audit, and full-integrity modes.
Share bugs, ideas, or general feedback.
Validate the CEG for structural integrity:
This is run automatically as part of the GATE_PREREQUISITES['2a'] check
when any spec frontmatter declares coherence metadata, or when
coherence.json is already present. You can also invoke it manually at any time.
/vcsdd-coherence-scan to confirm graph integrityconst { refreshAndValidateCoherence } = require('./scripts/lib/vcsdd-coherence');
const featureName = /* active feature */;
const result = refreshAndValidateCoherence(featureName);
if (!result.active) {
// Coherence not active — nothing to validate
return;
}
const summary = result.summary;
If result.validation.ok === true:
✅ Coherence graph is valid
Nodes : <nodeCount> Edges : <edgeCount>
Green : <green> Amber : <amber> Gray : <gray>
If result.recoveredFromCorruption === true:
ℹ coherence.json was corrupted, so VCSDD saved coherence.json.bak and rebuilt the graph from current frontmatter before validating.
If result.validation.ok === false (cycles detected):
❌ Coherence validation failed: Circular dependency detected
Cycle: design:A -> design:B -> design:C -> design:A
To resolve:
1. Review the depends_on / depended_by declarations in the affected specs
2. Break the cycle by removing one of the edges or restructuring the dependency
3. Re-run /vcsdd-coherence-scan then /vcsdd-coherence-validate
If result.validation.ok === false (dangling references / placeholder nodes / invalid frontmatter):
❌ Coherence validation failed: Reference integrity errors
- Edge 3: unknown target node "design:missing-doc"
→ Add the missing node or fix the node_id reference in the spec frontmatter
result.validation.ok === true → proceed to Phase 2a