Skip to content

pactkit/pactkit-public

Repository files navigation

PactKit

PyPI version Python License: MIT

CODE is the Law. Data is the Truth. Prompt is ONLY instruction. AI is ONLY creativity.

PactKit is a governance framework that enforces the P.A.C.T. contract between humans and AI coding agents. Deterministic operations run as code, not prompts. Decisions are grounded in data, not memory. AI does what it's best at — creativity and language — while code handles everything that must be repeatable and correct.

28 CLI subcommands, 9 specialized agents, 11 commands, 10 skills, and a full Plan-Act-Check-Done lifecycle. One pip install and your AI assistant follows the contract.

Installation

pip install pactkit

Requires Python 3.10+.

Supported AI Tools

Tool Deploy Command
Claude Code pactkit init --format classic
OpenCode pactkit init --format opencode
Codex CLI pactkit init --format codex
GitHub Copilot pactkit init --format copilot

pactkit init deploys all installed IDE formats by default. Use --format to target a specific one.

Quick Start

# Deploy the full toolkit
pactkit init

# Update to latest playbooks (preserves your config)
pactkit update

Then in any project:

/project-plan "Add user authentication"   # Plan: Spec + Board
/project-act STORY-001                     # Act: TDD implementation
/project-check                             # Check: Security + quality audit
/project-done                              # Done: Regression gate + commit

Or run the full cycle in one command:

/project-sprint "Add user authentication"

What It Does

PactKit deploys a complete PDCA (Plan-Do-Check-Act) lifecycle into your AI coding assistant:

  • 9 specialized agents — System Architect, Senior Developer, QA Engineer, Security Auditor, and more
  • 11 command playbooks — From /project-init to /project-release, each with quality gates
  • 10 skills — Code visualization, sprint board management, scaffolding, and more
  • 28 CLI subcommands — Deterministic operations enforced in Python code, not prompts
  • 4 IDE support — Claude Code, OpenCode, Codex CLI, GitHub Copilot — deploy all at once or pick one
  • Safe regression — TDD-first, pre-existing test protection, spec-driven development

The P.A.C.T. Contract

P   Prompt   is ONLY instruction   Defines process, never state
A   AI       is ONLY creativity    Formatting, language — never deterministic logic
C   Code     is the Law            Sole executor of deterministic operations
T   Truth    Data is the Truth     All judgment based on facts, not memory

PDCA+ Workflow

Phase Command What Happens
Clarify /project-clarify Ambiguity detection, structured questions
Plan /project-plan Codebase scan, Spec generation, Board entry
Act /project-act Spec lint, TDD loop, regression check
Check /project-check Security + quality audit + spec alignment
Done /project-done Regression gate, archive, conventional commit
Release /project-release Version bump, snapshot, Git tag
Sprint /project-sprint One-command automated PDCA orchestration
Hotfix /project-hotfix Fast-track fix bypassing PDCA
Design /project-design PRD generation, story decomposition

Documentation

Upgrading

pip install --upgrade pactkit
pactkit update

License

MIT

About

PactKit — P.A.C.T. governance framework for AI coding agents. Install: pip install pactkit

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors