Skip to content
Open Source — MIT Licensed

Claude Code
Engineering Framework

40 battle-tested design patterns for managing software projects with Claude Code. Built by Eiman Rahimi over 12 months across 80+ real production projects at Vohux.

Each pattern comes with full rationale, concrete examples, and implementation guidance — instantly adoptable in any Claude Code project.

40
Design Patterns
12
Categories
80+
Real Projects
MIT
Licensed

An engineering organization for Claude Code

Most developers use Claude Code ad-hoc. This framework gives you the systematic architecture that makes AI-assisted development reproducible, auditable, and scalable — without slowing you down.

12+ Months of Real Work

Every pattern was extracted from actual production use across 80+ projects — not invented from theory. Each one solved a real failure mode.

5 Governance Categories

Covers the full engineering surface: automated detection, quality enforcement, security, workflow discipline, and cross-project consistency.

Instantly Adoptable

No framework lock-in. Pure Python with no dependencies. Each pattern is self-contained — adopt one or all forty. Works with any Claude Code project.

Key patterns

A sample of the 40 patterns — from foundational governance to advanced automation.

intermediate

CEO / PM / CIS Governance Hierarchy

Three-tier supervision where a CEO script coordinates per-project PM scripts, all writing findings to a Central Issue Store.

advanced

WatchTools Detector-Gap Pattern

Find a real bug → build a detector that catches it automatically → prevent every future recurrence fleet-wide.

intermediate

9-Dimension Cold-Read Audit

Systematic methodology to audit any codebase from zero context across nine orthogonal quality dimensions.

advanced

Hook-as-Judiciary

Memory and instructions are advisory; hooks are law. Automated enforcement gates block non-compliant actions before they land.

beginner

Subagent-Driven Execution

Delegate substantive work (3+ files, 200+ lines) to specialized subagents; Claude Code coordinates, never inlines.

intermediate

Immaculate Code Protocol

Pre-code gate + per-function checklist + four-pass Definition of Done. Zero lint, zero type errors, green tests, PM grade stable.

advanced

Constitution as Rule SSoT

All Claude Code rules, hooks, skills, and standards live in a single versioned ledger with drift detection and enforcement.

beginner

Hypothesis Gate Discipline

Write the hypothesis before writing any fix. If you cannot articulate the root cause, stop and diagnose — never patch blindly.

Get started in 60 seconds

No dependencies. Pure Python. Works with any Claude Code project.

One-command install (macOS / Linux)
$ curl -sSL https://raw.githubusercontent.com/medlars/claude-code-framework/main/install.sh | bash
Tier 1 — Starter
4 patterns · Works immediately
bash install.sh --tier 1
Best for: single projects, getting started
Tier 2 — Governance
15 patterns · Includes monitoring
bash install.sh --tier 2
Best for: teams, multiple projects
Tier 3 — Full Fleet
40 patterns · Complete system
bash install.sh --tier 3
Best for: 5+ projects, full automation
Or install manually (git clone)
$ git clone https://github.com/medlars/claude-code-framework
$ cd claude-code-framework
$ python3 generate-report.py --audience tech
Content Creators

40 episode seeds, ready to record

Each pattern ships with a YouTube episode angle — a concrete, opinionated take on why the pattern matters and what it prevents. 40 patterns = 40 episodes. No filler, no fluff.

Browse episode seeds on GitHub

Who it's for

Claude Code developers

You're already using Claude Code and want systematic, reproducible quality instead of ad-hoc prompting that degrades over time.

Multi-project teams

You're managing several AI-assisted projects and want a shared governance layer that ensures consistent standards fleet-wide.

Engineering-minded builders

You want Claude Code to behave like a disciplined engineering organization — not a one-shot assistant that forgets what it learned.

Start building with better patterns

Free, MIT licensed, instantly adoptable. No sign-up, no dependency, no lock-in. Clone the repo and start using the patterns that work today.