Skip to content
cccskills
FreePublished on GitHub

vcsdd-init

Initialize a VCSDD feature pipeline. Creates the .vcsdd/features/<name>/ directory tree, sets mode (strict|lean), and activates the feature. Must be run before any other VCSDD command.

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

See how to install

Files included (1)

  • SKILL.md2.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

What

Initializes a new VCSDD feature pipeline for the specified feature name. Creates all required directories and state files, sets the operating mode (strict or lean), and marks the feature as active.

When

Run at the start of every new feature development cycle. Must be run before /vcsdd-spec, /vcsdd-tdd, or any other VCSDD command.

How

  1. Parse arguments: <feature-name> [--mode strict|lean] [--language rust|python|typescript|go|cpp]
  2. Validate feature name: must be kebab-case (a-z0-9 and hyphens only)
  3. Create directory structure:
    .vcsdd/
      index.json (created/updated)
      history.jsonl (created if missing)
      features/
        <feature-name>/
          state.json
          specs/
          contracts/
          reviews/
          evidence/
          verification/proof-harnesses/
          verification/fuzz-results/
          verification/mutation-results/
          verification/security-results/
          escalations/
    
  4. Initialize via state library (do not hand-author state.json):
    const path = require('path');
    const pluginRoot = process.env.CLAUDE_PLUGIN_ROOT || path.join(process.env.HOME, '.claude', 'plugins', 'vcsdd-claude-code');
    const { initFeature } = require(path.join(pluginRoot, 'scripts/lib/vcsdd-state.js'));
    // language: optional string rust|python|typescript|go|cpp
    initFeature('<feature-name>', '<strict|lean>', languageOrUndefined);
    
    This writes state.json with currentPhase: "init", mode, optional language field, empty traceability/gates/proofObligations, and updates .vcsdd/index.json (including language on the feature entry when provided).
  5. Append to history.jsonl: {event: "feature_created", ...} (done by initFeature)
  6. Display confirmation: feature name, mode, language (if any), next action

Examples

/vcsdd-init user-auth --mode lean
/vcsdd-init payment-service --mode strict --language rust
/vcsdd-init search-feature

Mode Selection Guide

Use lean whenUse strict when
Prototyping / product workSafety-critical code
Small, low-risk featuresFinancial/security features
Time-constrained workHigh-assurance requirements
Learning the VCSDD workflowProduction deployment gates

Lean mode still traverses all 6 phases. It relaxes approval and contract requirements, but it does not skip Phase 1b, Phase 2c, or Phase 5.

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

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.

sc30gsw/vcsdd-claude-code27Updated Apr 5, 2026

See all skills by sc30gsw

Report a problem with this skill