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
| 30 CLI Subcommands | Deterministic operations as code, not prompts |
| 9 Agents | Specialized roles with constrained tools |
| 12 Commands | Core-managed lifecycle entry points |
| 19 Skills | Specialized tools, portable methods, and command facades |
| 8 Rules | Modular constitution modules (2 core + 6 on-demand) |
Supported AI Tools
Claude Code support ships in the core package; OpenCode and Codex CLI are opt-in extras. A single pactkit init deploys to every IDE whose adapter is installed.
| Tool | Format | Command | Notes |
|---|---|---|---|
| Claude Code | Classic | pactkit init | Included by default |
| OpenCode | OpenCode | pactkit init | pip install "pactkit[opencode]" |
| Codex CLI | Codex | pactkit init | pip install "pactkit[codex]" |
| 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[all]"
pactkit initRequires Python 3.10+. Deploys to Claude Code (~/.claude/), OpenCode (~/.config/opencode/), and Codex CLI (~/.codex/) in one step.
[all] pulls the OpenCode and Codex adapters plus the lint/visualize extras. Installing plain pactkit deploys Claude Code only. See Installation for external tools (gh, codegraph).
pip install "pactkit[opencode]" # or [codex]
# Deploy to one IDE only:
pactkit init --format classic # 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.
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 — 12 commands + 19 skills
- GitHub Copilot — project-level deployment for Copilot