<h1 align="center">Director Mode Lite</h1> <p align="center"> <strong>Use Claude Code like a Director, not a Programmer</strong> </p> <p align="center"> <a href="https://github.com/claude-world/director-mode-lite/releases"><img src="https://img.shields.io/github/v/release/claude-world/director-mode-lite" alt="GitHub Release"></a> <a href="https://github.com/claude-world/director-mode-lite/stargazers"><img src="https://img.shields.io/github/stars/claude-world/director-mode-lite?style=social" alt="GitHub Stars"></a> <a href="https://claude.ai/code"><img src="https://img.shields.io/badge/Claude%20Code-Opus%204.6%20compatible-blueviolet?logo=anthropic" alt="Claude Code"></a> <a href="https://discord.com/invite/rBtHzSD288"><img src="https://img.shields.io/discord/1459859959398531294?color=7289da&label=Discord&logo=discord&logoColor=white" alt="Discord"></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a> </p> <p align="center"> <a href="https://claude-world.com">Website</a> | <a href="#quick-start">Quick Start</a> | <a href="#whats-included">Features</a> | <a href="examples/">Examples</a> | <a href="https://discord.com/invite/rBtHzSD288">Discord</a> </p>

<p align="center"> <i>"Don't write code. Direct Claude to write code for you."</i> </p>

Start Here

After installing, run these 3 commands:

/getting-started          # Guided 5-minute onboarding
/project-init             # Auto-detect project and configure
/workflow                 # Start your first feature

New to Director Mode? Read What is Director Mode? below, or jump to Quick Start.

<details> <summary><strong>Compatibility</strong></summary>

Director Mode Lite is fully compatible with the latest Claude Code release (Opus 4.6 era), including support for:

Claude Opus 4.6 model selection in agent/skill frontmatter
Agent Teams (experimental multi-agent collaboration)
1M context window models (opus[1m], sonnet[1m])
All 12 hook types including SessionStart, PreCompact, and PostCompact

Tested with Claude Code CLI as of March 2026. Works with Sonnet 4.6, Opus 4.6, and Haiku 4.5.

</details>

What is Director Mode?

Director Mode is a paradigm shift in AI-assisted development. Instead of writing code line by line, you direct Claude to execute your vision autonomously.

  Traditional Coding                    Director Mode
  ━━━━━━━━━━━━━━━━━━                    ━━━━━━━━━━━━━━

  You: Write code                       You: Define the vision
  AI:  Follow orders                    AI:  Execute autonomously
       ↓                                     ↓
  Micromanagement                       Strategic oversight
  One task at a time                    Parallel agent execution
  Manual intervention                   Continuous automation

Core Principles

Principle	Description
Efficiency First	Direct execution, minimal interruption
Parallel Processing	Multiple agents working simultaneously
Autonomous Execution	AI handles implementation details
Strategic Oversight	You focus on "what" and "why"

Key Feature: TDD-Driven Auto-Loop

Test-Driven Development Automation

Similar to Ralph Wiggum, Auto-Loop uses Stop hooks but focuses on TDD:

Acceptance Criteria Tracking - Parse - [ ] and auto-check completion
TDD Methodology - Red-Green-Refactor cycle guidance
Checkpoint Recovery - Resume from .auto-loop/checkpoint.json
Agent Collaboration - code-reviewer, test-runner integration

Stop anytime with:

touch .auto-loop/stop

</td> <td width="50%">

/auto-loop "Create a calculator

Acceptance Criteria:
- [ ] add(a, b) function
- [ ] subtract(a, b) function
- [ ] Unit tests"

[Iteration 1] RED    → Write test...
[Iteration 2] GREEN  → Implement...
[Iteration 3] REFACTOR → Clean...
[Iteration 4] GREEN  → subtract()...
[Iteration 5] All criteria complete!

</td> </tr> </table>

NEW: Self-Evolving Loop

Beyond Auto-Loop: Strategy Evolution

Self-Evolving Loop takes automation further by:

Dynamic Skill Generation - Creates custom skills for each task
Learning from Failures - Extracts patterns and root causes
Strategy Evolution - Improves its own execution approach
8-Phase Workflow - ANALYZE → GENERATE → EXECUTE → VALIDATE → DECIDE → LEARN → EVOLVE → SHIP

Key difference from auto-loop:

Feature	auto-loop	evolving-loop
Strategy	Fixed TDD	Dynamic
Learning	None	Extracts patterns
Adaptation	Low	High

</td> <td width="50%">

/evolving-loop "Build REST API

Acceptance Criteria:
- [ ] GET /users endpoint
- [ ] POST /users endpoint
- [ ] Input validation
- [ ] Error handling
"

# The loop:
# 1. Analyzes requirements deeply
# 2. Generates custom executor skill
# 3. Executes with TDD
# 4. Validates results
# 5. If fails: learns & evolves skills
# 6. Repeats until all criteria pass
# 7. Ships the final result

Check status:

/evolving-status
/evolving-status --history
/evolving-status --evolution

</td> </tr> </table>

See docs/SELF-EVOLVING-LOOP.md for complete documentation.

Quick Start

Option A: Plugin Install (Recommended)

# 1. Install plugin via Claude Code marketplace
claude plugin install director-mode-lite

# 2. Navigate to your project directory
cd your-project

# 3. Run installation script from cached plugin
~/.claude/plugins/cache/director-mode-lite/director-mode-lite/1.7.2/install.sh .

# 4. Verify installation
~/.claude/plugins/cache/director-mode-lite/director-mode-lite/1.7.2/scripts/verify-install.sh .

<details> <summary><strong>🔧 Plugin Management Commands</strong></summary>

# Update plugin to latest version
claude plugin marketplace update director-mode-lite
claude plugin uninstall director-mode-lite
claude plugin install director-mode-lite

# Check installed plugins
cat ~/.claude/plugins/installed_plugins.json | jq '.'

# View plugin cache
ls -la ~/.claude/plugins/cache/director-mode-lite/director-mode-lite/1.7.2/

</details>

Option B: Clone and Install

git clone https://github.com/claude-world/director-mode-lite.git
cd director-mode-lite
./install.sh /path/to/your/project

Option C: Try Demo First

git clone https://github.com/claude-world/director-mode-lite.git
cd director-mode-lite
./demo.sh ~/director-mode-demo

Verify Installation

Run the verifier against the project where you installed Director Mode Lite:

# Plugin install
~/.claude/plugins/cache/director-mode-lite/director-mode-lite/1.7.2/scripts/verify-install.sh .

# Clone install
./scripts/verify-install.sh /path/to/your/project

The script checks:

CLAUDE.md plus core .claude/ files and directories
Required CLAUDE.md sections from the template
.claude/skills/ and .claude/agents/ are populated

It prints colored PASS and FAIL lines, exits 0 when all checks pass, and exits 1 if any check fails.

<details> <summary><strong>✨ Installation Features</strong></summary>

Automatic Backup - Backups existing .claude/ to .claude-backup-TIMESTAMP/
Portable Path Hooks - All hooks use $CLAUDE_PROJECT_DIR for portability (no more "file not found" errors)
Smart Merge - Preserves existing settings, only adds new hooks
Skip Existing - Won't overwrite already-installed commands/agents/skills
Clean Uninstall - ./uninstall.sh removes all installed files
Automated Tests - ./tests/run-tests.sh validates installation

</details>

What's Included

Commands (26)

Workflow:

Command	Purpose
`/workflow`	5-step dev flow
`/focus-problem`	Problem analysis
`/test-first`	TDD cycle
`/smart-commit`	Auto commits
`/plan`	Task breakdown
`/auto-loop`	TDD loop
`/evolving-loop`	Self-evolving
`/evolving-status`	Loop status

Setup & Health:

Command	Purpose
`/getting-started`	5-min onboarding
`/project-init`	Quick setup
`/check-environment`	Env check
`/project-health-check`	7-point audit

Validators (NEW):

Command	Purpose
`/claude-md-check`	Validate CLAUDE.md
`/mcp-check`	Validate MCP config
`/agent-check`	Validate agent files
`/skill-check`	Validate skill files
`/hooks-check`	Validate hooks

Generators (NEW):

Command	Purpose
`/claude-md-template`	Generate CLAUDE.md
`/agent-template`	Generate agents
`/skill-template`	Generate skills
`/hook-template`	Generate hooks

Utilities:

Command	Purpose
`/changelog`	Session events
`/handoff-codex`	Delegate
`/handoff-gemini`	Delegate
`/agents`	List agents
`/skills`	List skills

</td> <td valign="top" width="33%">

Agents (14)

Core Agents:

Agent	Purpose
`code-reviewer`	Quality, security
`debugger`	Error analysis
`doc-writer`	Documentation

Expert Agents:

Agent	Purpose
`claude-md-expert`	CLAUDE.md design
`mcp-expert`	MCP configuration
`agents-expert`	Custom agents
`skills-expert`	Custom skills
`hooks-expert`	Automation hooks

Self-Evolving Agents (NEW):

Agent	Purpose
`evolving-orchestrator`	Loop coordination
`requirement-analyzer`	Deep analysis
`skill-synthesizer`	Generate skills
`completion-judge`	Decision making
`experience-extractor`	Learn from failures
`skill-evolver`	Evolve strategy

</td> <td valign="top" width="34%">

Skills (31)

Skill	Purpose
`code-reviewer`	Code checklist
`test-runner`	TDD support
`debugger`	5-step method
`doc-writer`	Doc templates

Plus:

5 Expert Agents
6 Self-Evolving Agents
5 Validator Commands
4 Generator Commands
CLAUDE.md template
Starter hooks

</td> </tr> </table>

The 5-Step Workflow

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│    Step 1                Step 2                Step 3           │
│  ┌─────────┐           ┌─────────┐           ┌─────────┐        │
│  │ FOCUS   │    ──►    │ PREVENT │    ──►    │  TEST   │        │
│  │ PROBLEM │           │ OVERDEV │           │  FIRST  │        │
│  └─────────┘           └─────────┘           └─────────┘        │
│       │                     │                     │             │
│  Understand             Only build            Red-Green-        │
│  before coding          what's needed         Refactor          │
│                                                                 │
│                    Step 4                Step 5                 │
│                  ┌─────────┐           ┌─────────┐              │
│           ──►    │DOCUMENT │    ──►    │ COMMIT  │              │
│                  └─────────┘           └─────────┘              │
│                       │                     │                   │
│                  Auto-generated         Conventional            │
│                  documentation          Commits                 │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Parallel Agent Execution

One of Directo

…

Director Mode Lite

Installation

How to install

README

Start Here

What is Director Mode?

Core Principles

Key Feature: TDD-Driven Auto-Loop

Test-Driven Development Automation

NEW: Self-Evolving Loop

Beyond Auto-Loop: Strategy Evolution

Quick Start

Option A: Plugin Install (Recommended)

Option B: Clone and Install

Option C: Try Demo First

Verify Installation

What's Included

Commands (26)

Agents (14)

Skills (31)

The 5-Step Workflow

Parallel Agent Execution

You might also like