Docs Agents

Agent Compatibility

Git hooks work everywhere. Skill concepts load automatically for OpenCode.

What Works Where

FeatureOpenCodeClaude CodeCursorDevin DesktopAny Git Agent
Git hooksAutoAutoAutoAutoAuto
Manifest gateAutoAutoAutoAutoAuto
SOUL.md / AGENTS.mdAutoManualManualManualManual
SKILL.md conceptsAutoManualManualManualManual
Stack detectionAutoAutoAutoAutoAuto
i18nAutoN/AN/AN/AN/A

Setup per Agent

OpenCode (Recommended)

No extra setup. Skills load automatically via the skill tool.

Just run init-agents in any project. The agent detects your stack, loads matching skills, and enforces the lifecycle automatically.

bash install.sh
cd your-project
init-agents

Claude Code

Copy rules into CLAUDE.md. Install adapter hooks. Skills load via CLAUDE.md reference.

Creates .claude-plugin/ with hooks. Copy SOUL.md and AGENTS.md key principles into your CLAUDE.md.

bash install.sh --agent claude

Cursor

Add rules to .cursorrules. Install adapter hooks. Skills load via .cursorrules reference.

Creates .cursor-plugin/ with hooks. Append SOUL.md and AGENTS.md to .cursorrules.

bash install.sh --agent cursor

Devin Desktop

Install via Kiro adapter. Hooks load automatically from .kiro/hooks/.

Creates .kiro/hooks/ with pre-flight, commit approval, and edit guard hooks.

bash install.sh --agent kiro

Any Git-Based Agent

Copy the git hooks to your project. Works with any agent that uses git.

The hooks enforce: pre-flight checks, skill consultation, build verification, anti-slop, debug tracking, commit approval with mandatory manifest.

cp scripts/git-hooks/pre-commit .git/hooks/pre-commit
cp scripts/git-hooks/commit-msg .git/hooks/commit-msg
chmod +x .git/hooks/pre-commit .git/hooks/commit-msg
cp scripts/commit-approval.sh scripts/

Using Principles in Your Own System

The core principles are agent-agnostic. Adopt them anywhere:

PrincipleHow to Use
TOOL_GAP — When tools can't verify, report "ship status unknown."Never fake success when verification tools are unavailable.
Severity Labels — Classify findings: blocking → important → nit → suggestion → learning → praise.Apply to any code review or quality check.
Error Path Design — Every tool call, gate, and loop needs a failure path.Design failure paths at build time, not patched post-incident.
Continuation Over Recap — After context loss, resume. Don't waste tokens re-explaining.Ask "Where were we?" instead of summarizing everything.
Drift Detection — Check docs vs reality regularly.Verify stats, versions, features, commands, links match.
Manifest Gate — Require a written summary before commit approval.Agent must write what changed before generating approval token.