Claude Code Framework

Claude Code Project Framework

A project framework for Claude Code that enforces engineering discipline, prevents common AI agent failure modes, and builds continuous improvement into your workflow.

What This Is

A complete set of templates for configuring Claude Code as a **rigorous engineering partner** rather than a compliant assistant. Includes:

• CLAUDE.md template — Project rules, architecture constraints, agent behavior rules with auto-generated section markers
• Skills — 20 slash commands: 15 core (/build, /test, /review, /check-sizes, /retro, /commit, /create-pr, /create-ticket, /create-skill, /document-bug, /session-mode, /diagnose, /fix-issue, /smoke-test) + 5 Linear integration (/linear-sync, /linear-create, /linear-triage, /linear-sprint, /linear-update)
• Hooks — 6 automated enforcement hooks + optional tdd-guard TDD enforcement (file size limits, scope warnings, pre-commit verification, rule persistence through context compression)
• Rules — 11 modular, path-scoped rule files (anti-sycophancy, scope guardrails, feedback loops, anti-patterns, canary strategy, trust levels, complexity budget, public-facing writing)
• Agents — 6 specialized subagents with persistent memory (code reviewer, docs reviewer, planner, QA tester, domain expert, Linear PM)
• Ticket system — Persistent task tracking across sessions with structured templates
• Issue tracking — Linear as single source of truth with local snapshot cache (docs/LINEAR_SNAPSHOT.md)
• Setup tooling — Automated setup and update scripts, comment stripping for production, .claudeignore template

Why This Exists

Every rule in this framework exists because of a specific failure mode observed in production use of AI coding agents. These are not theoretical — they address real categories of problems that occur when LLM agents operate without structured constraints.

| Rule | Failure Mode I