EZRA (עזרא)

The Scribe Who Restores and Enforces Standards

"And Ezra had set his heart to seek the Torah of Hashem, and to do it, and to teach in Israel statute and ordinance." — Ezra 7:10

EZRA is a multi-agent codebase governance framework for Claude Code. It provides 39 slash commands, 4 subagent engines with 100 specialized roles, 24 lifecycle hooks, 55 SDLC document types, 5-pillar health enforcement, autonomous process execution with guard rails, and multi-project portfolio orchestration.

Identity

Ezra HaSofer (עזרא הסופר) — Ezra the Scribe — returned from Babylonian exile to find Israel's standards broken, its governance collapsed, and its practices drifted from what was decreed. He didn't just rebuild. He audited. He documented. He enforced.

What Ezra did for Israel, this system does for codebases:

• Restored the standard — Ezra re-established the Torah as the authoritative source of truth. EZRA establishes architectural decisions, coding standards, and governance rules as the authoritative source for your project.
• Audited compliance — Ezra conducted a public audit of the people's adherence to the law. EZRA scans your codebase against recorded decisions, protected paths, and configured standards.
• Documented everything — Ezra was a Sofer (scribe) — the original documentation specialist. He ensured the text was accurate, complete, and accessible. EZRA manages 55 SDLC document types across the full project lifecycle.
• Enforced with authority — Ezra didn't suggest. He governed. When he found violations, he required correction. EZRA's guard rails halt autonomous execution the moment a violation is detected.
• Taught and elevated — Ezra didn't just enforce — he taught the people to understand the standards themselves. EZRA's advisor provides lifecycle-aware guidance, best practices, and forward-looking recommendations.

The name EZRA encodes the system's purpose: Enforce. Zero-drift. Restore. Audit.

Works on Windows, macOS, and Linux.

Quick Start

# Install globally (all projects)
npx ezra-claude-code --global

# Or install locally (current project only)
npx ezra-claude-code --local

# Restart Claude Code, then:
/ezra:help

What EZRA Does

| Capability | Description | |-----------|-------------| | 39 Slash Commands | Governance, documents, dashboard, processes, autonomous execution, multi-project, planning, memory, licensing | | 4 Subagent Engines + 100 Roles | Architect, Reviewer, Guardian, Reconciler — plus 100 specialized roles across 12 domains | | 24 Auto-Hooks | Protected path guard, session dashboard, drift detection, version tracking, oversight, memory capture, workflows, licensing, cloud sync | | 55 Document Types | Full SDLC coverage from business case through decommissioning | | 5-Pillar Health | On-Track, No Gaps, Clean, Secure, Best Practices (scored 0-100) | | Process Engine | Adjustable step-by-step workflows saved as portable templates | | Autonomous Execution | Runs processes start-to-finish under continuous guard rail monitoring | | Multi-Project | Portfolio dashboard, cross-project health, sync governance across repos | | Proactive Advisor | Lifecycle-aware suggestions, innovations, tech debt register | | Immutable Versioning | Append-only changelog, named snapshots, version diffing |

Commands

Governance & Analysis

/ezra:init          Initialize EZRA for a project
/ezra:scan          Multi-agent codebase analysis
/ezra:guard         Check changes against governance rules
/ezra:reconcile     Compare plan vs implementation
/ezra:decide        Record an architectural decision
/ezra:review        Multi-agent code review (3 parallel agents)
/ezra:health        5-pillar health enforcement
/ezra:advisor       Proactive best-practice suggestions
/ezra:status        Governance summary

Dashboard & Documents

/ezra:dash          Real-time project dashboard
/ezra:doc create    Create SDLC document from codebase analysis
/ezra:doc list      List all documents with status
/ezra:doc status    Document health report
/ezra:doc-check     Gap analysis for current phase
/ezra:doc-sync      Detect drift, propose updates (requires approval)
/ezra:doc-approve   Review and approve/reject proposals

Process Engine & Automation

/ezra:process create    Build a custom workflow
/ezra:process run       Execute interactively
/ezra:process template  Save/load reusable templates
/ezra:auto <process>    Run fully autonomously with guard rails
/ezra:auto --dry-run    Simulate without changes

Multi-Project

/ezra:multi add         Register a project
/ezra:multi dash        Portfolio dashboard
/ezra:multi health      Cross-project health comparison
/ezra:multi run --all   Run process across all projects
/ezra:multi sync        Sync templates and governance

Versioning

/ezra:version           Current version state
/ezra:version log       Append-only audit trail
/ezra:version snapshot  Named checkpoint
/ezra:version diff      Compare two snapshots

Setup & Integration

/ezra:bootstrap     One-command project onboarding (scan, govern, ADR, health, CLAUDE.md)
/ezra:claude-md     Generate or update CLAUDE.md from governance state
/ezra:agents        Agent management — list, recommend, deploy, info
/ezra:sync          Sync EZRA governance state with AVI-OS context
/ezra:oversight     Real-time agent oversight — monitor, warn, gate, strict
/ezra:settings      Unified settings management for all EZRA configuration
/ezra:compliance    Compliance profiles — ISO 25010, OWASP, SOC2, HIPAA, PCI-DSS, GDPR, WCAG
/ezra:library       Best practice library — browse, search, add across 14 categories
/ezra:research      Research agent control — automated best practice discovery
/ezra:cost          Cost tracking and budget management for AI agent usage
/ezra:handoff       Generate session handoff brief for continuity across conversations
/ezra:learn         Capture learnings, patterns, and anti-patterns into project memory

Health Pillars

/ezra:health scores your project across 5 weighted pillars:

| Pillar | Weight | Checks | |--------|--------|--------| | On-Track | 25% | Plans progressing, decisions recorded, recent scans, no stalled work | | No Gaps | 20% | Document coverage, test coverage, API docs, decision coverage | | Clean | 15% | No any types, strict TypeScript, linting, no dead code | | Secure | 25% | OWASP compliance, npm audit, auth, secrets, rate limiting | | Best Practices | 15% | CI/CD, SOLID, error handling, git hygiene, structured logging |

Grades: A (90+), B (75-89), C (60-74), D (40-59), F (0-39)

Process Templates

EZRA ships with 5 built-in process templates:

| Template | Steps | Purpose | |----------|-------|---------| | full-remediation | 8 | Gap analysis, health, docs, tests, security, report | | release-prep | 6 | Health gate, security audit, doc check, reconcile | | sprint-close | 5 | Tests, scan, doc sync, reconcile, snapshot | | security-audit | 7 | OWASP scan, dep audit, secrets check, report | | onboarding | 4 | Init, scan, doc check, advisor |

Create custom processes from plain English:

/ezra:process create my-flow

> step 1: run gap analysis
> step 2: bridge all findings
> step 3: run tests
> step 4: generate report

Save as template: /ezra:process template save my-flow

Autonomous Execution

/ezra:auto full-remediation

Runs all steps without manual intervention. Guard rails enforce:

• Clean git, passing tests, minimum health score
• Never touches .env, secrets, main branch, production
• Blocks rm -rf, DROP TABLE, git push --force
• Re-checks guards before and after every step
• Halts immediately on any violation with specific remediation

Project State

EZRA persists all state in .ezra/ at the project root:

.ezra/
├── decisions/      # Architectural Decision Records
├── scans/          # Scan + health results
├── plans/          # Plans for reconciliation
├── docs/           # 55-type SDLC document library + proposals
├── processes/      # Workflow definitions + templates + run history
├── versions/       # Immutable changelog + snapshots
├── governance.yaml # Rules, protected paths, enforcement
└── knowledge.yaml  # Codebase knowledge

Hooks (Optional)

After installation, add hooks to your settings.json for automatic enforcement:

| Hook | Event | Purpose | |------|-------|---------| | ezra-guard.js | PreToolUse | Warns on protected path edits | | ezra-oversight.js | PreToolUse | Real-time agent oversight with 4 intervention levels | | ezra-tier-gate.js | PreToolUse | Blocks Pro/Team-gated commands on Core tier | | ezra-dash-hook.js | SessionStart | Compact project status every session | | ezra-drift-hook.js | PostToolUse | Tracks edits, flags stale documents | | ezra-version-hook.js | PostToolUse | Auto-versions every .ezra/ change | | ezra-avios-bridge.js | PostToolUse | Syncs decisions and scan findings to AVI-OS context | | ezra-memory-hook.js | PostToolUse | Auto-captures patterns and lessons from tool outputs | | ezra-progress-hook.js | PostToolUse | Tracks agent progress and checks milestones | | ezra-settings.js | Utility | Unified settings parser for .ezra/settings.yaml | | ezra-settings-writer.js | Utility | Settings write-back engine for .ezra/settings.yaml | | ezra-agents.js | Utility | Multi-agent orchestration with weighted task assignment | | ezra-library.js | Utility | Best practice library engine with 14 categories | | ezra-cloud-sync.js | Utility | Local state backup/restore and sync manifest | | ezra-dashboard-data.js | Utility | Health data collection for dashboards and handoffs | | ezra-error-codes.js | Utility | Structured error code catalog for all hooks | | ezra-hook-logger.js | Utility | Shared structured JSON-line logger with auto-rotation | | ezra-http.js | Utility | Shared HTTP client with SSRF protection | | ezra-installer.js | Utility | CLI installer for hooks and commands | | ezra-license.js | Utility | License management engine (Core/Pro/Team) | | ezra-memory.js | Utility | Persistent project knowledge base | | ezra-planner.js | Utility | Holistic planning engine with task decomposition | | ezra-pm.js | Utility | Project manager — milestones, stall detection, health trends | | ezra-workflows.js | Utility | Workflow template engine with step dependencies |

The installer prints the exact JSON configuration after install.

Uninstall

npx ezra-claude-code --uninstall

Cursor Support

EZRA is fully compatible with Cursor, the AI-first VS Code fork.

• VS Code extension installs via VSIX in Cursor's extension panel
• Claude Code hooks work when Claude Code runs in Cursor's terminal
• .cursorrules template enforces EZRA governance through Cursor's AI agent

# Copy the .cursorrules template to your project:
cp node_modules/ezra-claude-code/templates/cursorrules-template .cursorrules

See docs/CURSOR-COMPATIBILITY.md for the full installation guide, compatibility matrix, and FAQ.

Requirements

• Node.js >= 16.7.0
• Claude Code installed and working
• Git (recommended, used by guard/reconcile/version commands)

Testing

npm test       # Run all test suites
npm run lint   # Lint all files

Tests run on Windows, macOS, and Linux across Node 16, 18, 20, and 22.

License

MIT