What is PactKit?
PactKit is a governance framework that enforces the P.A.C.T. contract between humans and AI agents. It compiles development workflows, role definitions, and behavioral rules into executable constitutions and playbooks for Claude Code, OpenCode, Codex CLI, and more.
Name origin: Pact (契约) + Kit — the governance contract.
The core idea: CODE is the Law. Data is the Truth. Prompt is ONLY instruction. AI is ONLY creativity.
| Principle | Boundary | |
|---|---|---|
| P — Prompt | is ONLY instruction | Tells AI how to act — defines process, never state |
| A — AI | is ONLY creativity | Formatting, summarization, language — never deterministic logic |
| C — Code | is the Law | Sole executor of deterministic operations — no bypass |
| T — Truth | Data is the Truth | Factual basis for all judgment — no memory, no fabrication |
At a Glance
| 25 CLI Subcommands | Deterministic operations as code, not prompts |
| 9 Agents | Specialized roles with constrained tools |
| 11 Commands | PDCA-centric workflow entry points |
| 10 Skills | Visualize, Board, Scaffold, Trace, Draw, Analyze, and more |
| 8 Rules | Modular constitution modules (2 core + 6 on-demand) |
Supported AI Tools
Since v2.9.0, pip install pactkit includes all IDE adapters. A single pactkit init deploys to all three IDEs by default.
| Tool | Format | Command | Notes |
|---|---|---|---|
| Claude Code | Classic | pactkit init | Included by default |
| Claude Code Plugin | Plugin | Marketplace install | No Python required |
| OpenCode | OpenCode | pactkit init | Included by default |
| Codex CLI | Codex | pactkit init | Included by default |
| Trae | — | Coming soon | — |
Use --format <name> to target a single IDE (e.g., pactkit init --format opencode).
Quick Start
pip install pactkit
pactkit initRequires Python 3.10+. Deploys to Claude Code (~/.claude/), OpenCode (~/.config/opencode/), and Codex CLI (~/.codex/) in one step.
pip install pactkit
# Deploy to one IDE only:
pactkit init --format claude # Claude Code only
pactkit init --format opencode # OpenCode only
pactkit init --format codex # Codex CLI onlyRequires Python 3.10+. The --format flag targets a single IDE.
# In Claude Code:
/plugin marketplace add pactkit/claude-code-plugin
/plugin install pactkitNo Python required. Restart Claude Code and you're ready.
Trae integration is under development. Stay tuned.
Then start using commands:
/project-plan "Add user authentication"
/project-act STORY-001
/project-check
/project-doneNext Steps
- P.A.C.T. Philosophy — the governance contract behind the name
- Installation — deployment modes and options
- PDCA+ Workflow — the spec-driven development lifecycle
- Agent Ensemble — 9 specialized agents
- Command Reference — 11 commands + 10 skills