← Back to CV
JCSPECS mascot logo

JCSPECS

Constitution-first, spec-driven development for AI agents — across Claude Code, OpenCode, and Google Antigravity.

Most developers use AI reactively — pasting prompts and hoping for working code. JCSPECS replaces that with a disciplined, constitution-first process: durable product context, traceable requirements, and governed releases, all kept in 100% local methodology files.

Every change moves through an explicit lifecycle, from constitution to archive. Intent becomes a proposal, the proposal becomes a spec — requirements, design, and tasks — and specialized AI agents implement it step by step under human review, so velocity never costs quality or accrues technical debt.

JCSPECS is portable across Claude Code, OpenCode, and Google Antigravity, is CodeGraph-aware, runs on macOS, Linux, and Windows (Node.js 18+), and ships under the MIT license. Install it from NPM and drive it with the sdd-jc CLI (install, update, list, doctor).

The spec lifecycle

  1. Constitution

    Establish the project-wide foundation — PRD, system design, and detailed design as the durable source of truth.

  2. Propose

    Capture the intent for one bounded change as a lightweight, reviewable proposal.

  3. Specify

    Turn approved intent into full requirements, technical design, and traceable tasks.

  4. Execute

    Implement each task with specialized AI agents under a Leader → Implementer → Reviewer loop.

  5. Validate

    Human review, automated tests, and validation evidence recorded against every requirement.

  6. Archive

    Consolidate documentation, sync the design system, and close the spec.