Spec-Driven Agentic DevOps

Code by Contract

Agree on specs before writing code. Let agents execute.
PactKit compiles workflows, roles, and rules into executable constitutions for AI coding assistants.

$pip install pactkit

Documentation GitHub

9 Agents|13 Commands|Full PDCA Lifecycle|MIT License

Why PactKit?

AI coding assistants are powerful but unpredictable without structure. PactKit adds a spec-driven governance layer.

Spec is the Law

Specifications are the single source of truth. Spec > Tests > Code. When conflicts arise, Spec wins. Always.

Multi-Agent Ensemble

9 specialized agents collaborate with constrained tools and focused responsibilities — from Architect to QA.

Full PDCA Lifecycle

Plan, Act, Check, Done — with quality gates at every stage. Or run the full cycle in one command with /project-sprint.

Safe by Design

TDD-first development, safe regression testing, and pre-existing test protection. Agents can't break what already works.

PDCA+ Workflow

12 commands covering the full software development lifecycle.

Command	Agent	What Happens
/project-plan	System Architect	Codebase scan, Spec generation, Board entry
/project-act	Senior Developer	Visual scan, TDD loop, Regression check
/project-check	QA + Security	6-phase deep audit (Security/Quality/Spec)
/project-done	Repo Maintainer	Safe regression gate, Archive, Conventional commit
/project-trace	Code Explorer	Call graph tracing, Sequence diagram
/project-draw	Visual Architect	Generate Draw.io XML architecture diagrams
/project-doctor	System Medic	Configuration drift detection, Health report
/project-review	QA Engineer	PR review with SOLID/Security/Quality checklists
/project-sprint	Team Lead	One-command automated PDCA orchestration
/project-hotfix	Senior Developer	Fast-track fix bypassing PDCA
/project-release	Repo Maintainer	Version bump, Archive, Git tag, Changelog
/project-design	Product Designer	PRD generation, Story decomposition, Board setup

Agent Ensemble

9 specialized agents, each with constrained tools and focused responsibilities.

System Architect

Architecture design — Maintain Intent Graph, write Specs

Senior Developer

Full-stack development — TDD loop, call chain analysis, hotfix

QA Engineer

Quality gates — Deep check (P0-P3), PR review

Security Auditor

Security audit — OWASP scanning, threat modeling

Repo Maintainer

Repository ops — Cleanup, archiving, Git conventions, releases

System Medic

System diagnostics — Configuration drift repair

Visual Architect

Architecture visualization — Draw.io XML generation

Code Explorer

Code tracing — Call graph + sequence diagram

Product Designer

Product design — PRD, story decomposition, board init

Quick Start

Three steps to spec-driven development.

Install

pip install pactkit

Deploy

# Deploy 13 commands + 9 agents + 3 skills
pactkit init

Use in Claude Code

/project-plan "Add user authentication"
/project-act STORY-001
/project-check
/project-done