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 |
| GitHub Copilot | Copilot | pactkit init --format copilot | Separate package, project-level |
| Trae | — | Coming soon | — |
Use --format <name> to target a single IDE (e.g., pactkit init --format opencode).
GitHub Copilot is different: it deploys to the project's .github/ directory (not a user-level ~/ path), so each project needs its own pactkit init --format copilot. See GitHub Copilot for details.
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.
pip install pactkit pactkit-copilot
cd your-project
pactkit init --format copilotRequires separate pactkit-copilot package. Deploys to project .github/ — must run per project. Then use /project-init in your IDE. See GitHub Copilot.
# 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
- GitHub Copilot — project-level deployment for Copilot