Outline-Driven Development for Claude Code - 46 agents, 25+ skills, diagram-first methodology, AST-based editing, atomic commits.
$git clone https://github.com/outlinedriven/odin-claude-pluginInstalls into the current project.
Install odin-claude-plugin by running `git clone https://github.com/outlinedriven/odin-claude-plugin`, then use it for the current task and follow its documentation at https://github.com/outlinedriven/odin-claude-plugin.
| 1 | # Outline-Driven Development for Claude Code |
| 2 | |
| 3 | > Formerly known as the ODIN Claude Plugin. The repo URL stays the same; the brand has matured. |
| 4 | |
| 5 | **Outline-Driven Development** (nicknamed ODIN) — Advanced code agent system for Claude Code with surgical precision, diagram-first engineering, and comprehensive workflow automation. |
| 6 | |
| 7 | **Methodology**: [outline-driven-development](https://github.com/OutlineDriven/outline-driven-development) · **Codex CLI**: [odin-codex-plugin](https://github.com/OutlineDriven/odin-codex-plugin) · **Gemini CLI**: [odin-gemini-cli-extension](https://github.com/OutlineDriven/odin-gemini-cli-extension) · **Site**: [outlinedriven.github.io](https://outlinedriven.github.io) |
| 8 | |
| 9 | ## Overview |
| 10 | |
| 11 | ODIN is a professional-grade Claude Code plugin that transforms Claude into a sophisticated code agent with comprehensive workflow automation and rigorous engineering methodology. |
| 12 | |
| 13 | **Key Capabilities:** |
| 14 | |
| 15 | - 📐 **Diagram-First Engineering** - Architecture, concurrency, memory, data flow, optimization |
| 16 | - 🎯 **Surgical Code Editing** - AST-based transformations with ast-grep |
| 17 | - 🧠 **Confidence-Driven Execution** - Adaptive behavior based on complexity and risk |
| 18 | - 🔍 **Deep Investigation** - Mandatory file reading before code modifications |
| 19 | - 🔒 **Atomic Commits** - Conventional Commits protocol with incremental approvals |
| 20 | |
| 21 | ## Installation |
| 22 | |
| 23 | ### Prerequisites |
| 24 | |
| 25 | - Claude Code installed and running |
| 26 | - Git (for marketplace installation) |
| 27 | |
| 28 | ### Full Install Script (Recommended) |
| 29 | |
| 30 | ```shell |
| 31 | wget -O ~/.claude/CLAUDE.md https://raw.githubusercontent.com/OutlineDriven/odin-claude-plugin/refs/heads/main/CLAUDE.md && claude plugin marketplace add OutlineDriven/odin-claude-plugin && claude plugin install odin@odin-marketplace |
| 32 | ``` |
| 33 | |
| 34 | ### Verify Installation |
| 35 | |
| 36 | ```shell |
| 37 | # List available agents |
| 38 | /agents |
| 39 | |
| 40 | # View all commands |
| 41 | /help |
| 42 | |
| 43 | # See the installed plugins |
| 44 | /plugin |
| 45 | ``` |
| 46 | |
| 47 | ## Core Philosophy |
| 48 | |
| 49 | ODIN follows strict engineering principles: |
| 50 | |
| 51 | 1. **Investigate Before Acting** - Never speculate about code you haven't read |
| 52 | 2. **Diagram-First Design** - Five mandatory diagrams before any implementation |
| 53 | 3. **Surgical Precision** - Minimal, targeted changes using AST-based tools |
| 54 | 4. **Atomic Commits** - One logical change per commit, properly typed |
| 55 | 5. **Confidence-Driven** - Adapt behavior based on familiarity and risk |
| 56 | 6. **Tool Selection** - ast-grep > native-patch > ripgrep (never sed for edits) |
| 57 | |
| 58 | ### Five Required Diagrams |
| 59 | |
| 60 | Before any non-trivial implementation: |
| 61 | |
| 62 | 1. **Architecture** - Components, interfaces, contracts, dependencies |
| 63 | 2. **Data Flow** - Sources, transformations, sinks, state transitions |
| 64 | 3. **Concurrency** - Threads, synchronization, happens-before relationships |
| 65 | 4. **Memory** - Ownership, lifetimes, allocation patterns, safety guarantees |
| 66 | 5. **Optimization** - Bottlenecks, targets, complexity bounds, resource budgets |
| 67 | |
| 68 | ## Skills (101 total) |
| 69 | |
| 70 | Skills are invokable workflows that extend ODIN with process- and domain-specific protocols. Invoke with `/<skill-name>`; many also trigger on natural language cues described in their frontmatter. |
| 71 | |
| 72 | ### Planning & Exploration (16 skills) |
| 73 | |
| 74 | - `askme` - Verbalized Sampling protocol for deep intent exploration before planning |
| 75 | - `batch-ask-me` - Walk a dependency-aware design tree in batched question rounds until shared understanding |
| 76 | - `mutual-sync` - Three-way grounding: verify user, agent, and codebase share one picture of current state before proceeding |
| 77 | - `loop-me` - Design recurring workflows through a stateful `askme` session and cwd specs |
| 78 | - `to-questionnaire` - Turn a knowledge gap into an async questionnaire for the person who can answer it |
| 79 | - `plan` - Thorough read-only planning before any action |
| 80 | - `contexts` - Coordinate context sweep before coding |
| 81 | - `init` - Analyze a codebase and create or improve AGENTS.md |
| 82 | - `brainstorm` - Explore vague or ambitious ideas into a right-sized requirements-only plan |
| 83 | - `explore` - Read-only codebase exploration to map structure, symbols, and dependencies |
| 84 | - `zoom-out` - Step up one layer of abstraction to map surrounding modules and invariants |
| 85 | - `strategy` - Sharp interview to write or maintain STRATEGY.md as the product anchor |
| 86 | - `ideate` - Generate grounded, divergent ideas from the codebase into docs/ideation |
| 87 | - `design` - Set visual and interaction direction for UI surfaces before writing code |
| 88 | - `pov` - Decisive, project-grounded verdict on adopting or switching technology |
| 89 | - `research` - Gather external knowledge from authoritative sources with verified citations |
| 90 | |
| 91 | ### Writing & Learning (4 skills) |
| 92 | |
| 93 | - `teach` - Run a persistent cwd teaching workspace across missions, lessons, resources, and learning records |
| 94 | - `writing-fragments` - Mine heterogeneous raw material into an append-only pile before shaping |
| 95 | - `writing-shape` - Shape a raw pile into an article paragraph by paragraph with argued formats |
| 96 | - `writing-beats` - Build a grounded article journey one candidate beat at a time |
| 97 | |
| 98 | ### Working Posture (5 skills) |
| 99 | |
| 100 | - `duet` - Two-party posture |