examples

Director Mode Lite Examples

Real-world examples demonstrating Director Mode workflows.

Table of Contents

Example	Description	Difficulty
Calculator	Basic Auto-Loop demo	Beginner
REST API	Building an API with TDD	Intermediate
CLI Tool	Command-line tool with TDD	Intermediate
TypeScript Library	Publishable npm library	Advanced

---

Quick Start

Each example contains:

• README.md - Step-by-step instructions
• CLAUDE.md - Project-specific configuration
• Sample code to work with

# Try an example
cd examples/01-calculator
claude
# Then: /auto-loop "Implement the calculator"

---

Example 1: Calculator (Auto-Loop Demo)

Goal: Create a calculator module using Auto-Loop

Commands used:

• /auto-loop - Main workflow

Time: ~5 minutes

/auto-loop "Create a calculator module

Acceptance Criteria:
- [ ] add(a, b) function
- [ ] subtract(a, b) function
- [ ] multiply(a, b) function
- [ ] divide(a, b) function with zero check
- [ ] Unit tests for all functions"

---

Example 2: REST API (TDD Workflow)

Goal: Build a simple REST API with proper testing

Commands used:

• /workflow - Complete 5-step flow
• /test-first - TDD cycle
• /smart-commit - Commit changes

Time: ~15 minutes

---

Example 3: CLI Tool (Command-Line Development)

Goal: Create a file organizer CLI tool

Commands used:

• /auto-loop - TDD automation
• /test-first - Manual TDD cycle

Time: ~10 minutes

/auto-loop "Create a file organizer CLI

Acceptance Criteria:
- [ ] CLI entry point with commander.js
- [ ] scan(dir) function
- [ ] organize(dir, options) function
- [ ] --dry-run flag
- [ ] Unit tests"

---

Example 4: TypeScript Library (Self-Evolving Development)

Goal: Build a publishable validation library

Commands used:

• /evolving-loop - Self-evolving development
• Type-first design approach

Time: ~20 minutes

/evolving-loop "Create a TypeScript validation library

Acceptance Criteria:
- [ ] isEmail(value) validator
- [ ] isURL(value) validator
- [ ] createValidator(rules) factory
- [ ] TypeScript generics
- [ ] Zero dependencies
- [ ] ESM and CJS builds"

---

Creating Your Own Examples

Want to contribute an example? Follow this structure:

examples/
└── NN-example-name/
    ├── README.md       # Instructions
    ├── CLAUDE.md       # Project config
    ├── package.json    # (if Node.js)
    └── src/            # Sample code

Submit a PR to the Director Mode Lite repo.