Skip to content

v0.1.0 — Spec-Driven Development framework with lessons store

Choose a tag to compare

View all tags
@null-result null-result released this 31 Jul 16:13
· 13 commits to develop since this release
v0.1.0
87e5b62
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

What is Kivax?

Spec-anchored Spec-Driven Development runtime: your narrative spec compiles into a canonical YAML, from which the plan, tests, and code are derived, with hash-verifiable traceability between them.

Works with Claude Code, opencode, Cursor, GitHub Copilot (VS Code + CLI), and OpenAI Codex CLI — one project can use several at once.

v0.1.0 Features

Core SDD Pipeline

  • 9-phase flow: principles → architecture → spec → compile → plan → tdd → it → audit → retro
  • Spec-first enforcement: every behavior change traces to a REQ
  • Immutable REQ IDs: hashes drive selective invalidation only for what changed
  • Per-feature isolation: specs/01-feature/, specs/02-feature/, etc.

The Lessons Store (New in v0.1.0)

  • Binding feedback loop: retro phase writes what iterations cost; plan/tdd/it read it back
  • Mechanical enforcement: audit gate fails on unanswered lessons (phase-scoped, path-scoped, or project-wide)
  • Anti-rot rules: reinforce on recurrence, retire when false, never delete
  • Knowledge curator: specialist agent that turns cycle cost into actionable rules

New in v0.1.0

  • Researcher agent: investigates vague ideas, provides options + prior art before spec-analyst starts
  • Resumable task lists: ^C mid-work, resume from exact point; kivax task tracks where you left off
  • Principles + architecture phases: optional one-time setup phases (constitution renamed to principles)
  • Wiki curator: maintains derived knowledge, one page per domain concept
  • Traceability gate: spec-first verification at audit, locks hashes, catches stale specs in other features

Artifacts

  • specs/NN-slug/spec.md — narrative spec
  • specs/NN-slug/spec.yml — canonical anchor with immutable REQ IDs
  • specs/NN-slug/plan.md — contracts, REQ→module→test mapping, lessons applied
  • specs/wiki/ — derived knowledge pages
  • specs/lessons/LSN-*.md — what past iterations cost (new)
  • .kivax/state.yml — phase + per-REQ status (portable across sessions)
  • .kivax/traceability.lock.json — hashes from the last PASSING cycle

Getting Started

git clone https://github.com/null-result/kivax.git
cd kivax
python3 install.py

# Then in your project:
kivax init

Answer the setup wizard (greenfield vs. existing, include principles/architecture, choose stack), then open your AI assistant and ask it to start a new feature — the kivax-new skill does the rest.

Documentation

  • README.md: full guide, pipeline overview, file layout, CLI reference
  • Agents + Skills: inside the repo at share/agents/ and share/runtime/skills/; every phase is a skill your assistant reads
  • Tests: 465 passing, 97%+ coverage (run pytest tests)

Testing

pytest tests                                                             # all tests
pytest tests/unit/test_kivax_lessons.py -v                             # lessons store only
pytest tests --cov=. --cov-config=.coveragerc --cov-report=term-missing # coverage

License

MIT

Assets 2
Loading