AI Agentsai-codingclaude-codeclaude-code-configclaude-code-hooksdeveloper-tools
Installation
# Add to your Claude Code skills
git clone https://github.com/juanandresgs/claude-system
README.md
The Systems Thinker's Claude Code Governance Platform
A batteries-included governance layer for Claude Code. Four specialized agents handle planning, implementation, verification, and git operations. Shell scripts enforce the rules at every lifecycle event, regardless of context window pressure.
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Every arrow is a hook. Every feedback loop is automatic. The model doesn't choose to follow the process — the hooks won't let it skip. Try to write code without a plan and you're pushed back. Try to commit with failing tests and you're pushed back. Try to skip documentation and you're pushed back. Try to commit without tester sign-off and you're pushed back. The system self-corrects until the work is right.
The result: you move faster because you never think about process. The hooks think about it for you. Dangerous commands get denied or rewritten (--force → --force-with-lease, /tmp/ → project tmp/). Everything else either flows through or gets caught. You just describe what you want and review what comes out.
Why Hooks, Not Instructions
Most Claude Code configs rely on CLAUDE.md instructions — guidance that works early in a session but degrades as the context window fills up or compaction throws everything off a cliff. This system puts enforcement in deterministic hooks: shell scripts that fire before and after every event, regardless of context pressure.
Instructions are probabilistic. Hooks are mechanical. That's the difference.
If you already have a ~/.claude directory, back it up first: tar czf ~/claude-backup-$(date +%Y%m%d).tar.gz ~/.claude
2. Configure
cp settings.local.example.json settings.local.json
# Edit to set your model preference, MCP servers, plugins
Settings are split: settings.json (tracked, universal) and settings.local.json (gitignored, your overrides). Claude Code merges both, with local taking precedence.
3. Verify
On your first claude session, you should see the SessionStart hook inject git state, plan status, and worktree info. Try writing a file to /tmp/test.txt — guard.sh should rewrite it to tmp/test.txt in the project root.
Optional:/backlog command uses GitHub Issues via gh CLI (gh auth login). Research skills (deep-research) accept OpenAI/Perplexity/Gemini API keys but degrade gracefully without them. Desktop notifications need terminal-notifier (macOS: brew install terminal-notifier).
Staying Updated
The harness auto-checks for updates on every new session start. Same-MAJOR-version updates are applied automatically. Breaking changes (different MAJOR version) show a notification — you decide when to apply.
Auto-updates enabled by default. Create ~/.claude/.disable-auto-update to disable.
Fork users: Your origin points to your fork, so you get your own updates. Add an upstream remote to also track the original repo.
Local customizations safe:settings.local.json and CLAUDE.local.md are gitignored. If you edit tracked files, --autostash preserves your changes. If a conflict occurs, the update aborts cleanly and you're notified.
How It Works
┌────────────────────────────────────────────────────────────────────┐
│ The model doesn't decide the workflow. The hooks do. │
│ Plan first. Segment and isolate. Test everything. Get approval. │
└────────────────────────────────────────────────────────────────────┘
