odin

Outline-Driven Development for Claude Code

Formerly known as the ODIN Claude Plugin. The repo URL stays the same; the brand has matured.

Outline-Driven Development (nicknamed ODIN) — Advanced code agent system for Claude Code with surgical precision, diagram-first engineering, and comprehensive workflow automation.

Methodology: outline-driven-development  ·  Codex CLI: odin-codex-plugin  ·  Gemini CLI: odin-gemini-cli-extension  ·  Site: outlinedriven.github.io

Overview

ODIN is a professional-grade Claude Code plugin that transforms Claude into a sophisticated code agent with comprehensive workflow automation and rigorous engineering methodology.

Key Capabilities:

• 📐 Diagram-First Engineering - Architecture, concurrency, memory, data flow, optimization
• 🎯 Surgical Code Editing - AST-based transformations with ast-grep
• 🧠 Confidence-Driven Execution - Adaptive behavior based on complexity and risk
• 🔍 Deep Investigation - Mandatory file reading before code modifications
• 🔒 Atomic Commits - Conventional Commits protocol with incremental approvals

Installation

Prerequisites

• Claude Code installed and running
• Git (for marketplace installation)

Full Install Script (Recommended)

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

Verify Installation

# List available agents
/agents

# View all commands
/help

# See the installed plugins
/plugin

Core Philosophy

ODIN follows strict engineering principles:

1. Investigate Before Acting - Never speculate about code you haven't read
2. Diagram-First Design - Five mandatory diagrams before any implementation
3. Surgical Precision - Minimal, targeted changes using AST-based tools
4. Atomic Commits - One logical change per commit, properly typed
5. Confidence-Driven - Adapt behavior based on familiarity and risk
6. Tool Selection - ast-grep > native-patch > ripgrep (never sed for edits)

Five Required Diagrams

Before any non-trivial implementation:

1. Architecture - Components, interfaces, contracts, dependencies
2. Data Flow - Sources, transformations, sinks, state transitions
3. Concurrency - Threads, synchronization, happens-before relationships
4. Memory - Ownership, lifetimes, allocation patterns, safety guarantees
5. Optimization - Bottlenecks, targets, complexity bounds, resource budgets

Skills (101 total)

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.

Planning & Exploration (16 skills)

• askme - Verbalized Sampling protocol for deep intent exploration before planning
• batch-ask-me - Walk a dependency-aware design tree in batched question rounds until shared understanding
• mutual-sync - Three-way grounding: verify user, agent, and codebase share one picture of current state before proceeding
• loop-me - Design recurring workflows through a stateful askme session and cwd specs
• to-questionnaire - Turn a knowledge gap into an async questionnaire for the person who can answer it
• plan - Thorough read-only planning before any action
• contexts - Coordinate context sweep before coding
• init - Analyze a codebase and create or improve AGENTS.md
• brainstorm - Explore vague or ambitious ideas into a right-sized requirements-only plan
• explore - Read-only codebase exploration to map structure, symbols, and dependencies
• zoom-out - Step up one layer of abstraction to map surrounding modules and invariants
• strategy - Sharp interview to write or maintain STRATEGY.md as the product anchor
• ideate - Generate grounded, divergent ideas from the codebase into docs/ideation
• design - Set visual and interaction direction for UI surfaces before writing code
• pov - Decisive, project-grounded verdict on adopting or switching technology
• research - Gather external knowledge from authoritative sources with verified citations

Writing & Learning (4 skills)

• teach - Run a persistent cwd teaching workspace across missions, lessons, resources, and learning records
• writing-fragments - Mine heterogeneous raw material into an append-only pile before shaping
• writing-shape - Shape a raw pile into an article paragraph by paragraph with argued formats
• writing-beats - Build a grounded article journey one candidate beat at a time

Working Posture (5 skills)