{
  "markdown": "# Outline-Driven Development\n\n> Vibes are too shallow. Specs are too complex. Let there be the outline.\n\n**Beyond specs. Beyond vibes.** A versioned outline becomes the contract for every agentic act.\n\n[![GitHub Stars](https://img.shields.io/github/stars/OutlineDriven/outline-driven-development?style=flat-square)](https://github.com/OutlineDriven/outline-driven-development/stargazers)\n[![License](https://img.shields.io/badge/license-MIT-c8803c?style=flat-square)](LICENSE)\n[![Last commit](https://img.shields.io/github/last-commit/OutlineDriven/outline-driven-development?style=flat-square)](https://github.com/OutlineDriven/outline-driven-development/commits/main)\n[![Site](https://img.shields.io/badge/site-outlinedriven.github.io-c8803c?style=flat-square)](https://outlinedriven.github.io)\n\n---\n\n## Contents\n\n- [What is Outline-Driven Development](#what-is-outline-driven-development)\n- [Implementation](#implementation)\n- [Install](#install)\n- [Comparison](#comparison)\n- [Status](#status-2026-09)\n- [Contributing](#contributing)\n- [License](#license)\n\n---\n\n## What is Outline-Driven Development\n\nOutline-Driven Development is a coding methodology for LLM code agents. It occupies the space between two failure modes: vibes (too shallow, non-reproducible) and specs (too rigid, too expensive to maintain). The unit of truth is a versioned outline whose hash anchors every diff, every test, and every diagram.\n\nThe outline is harness-agnostic. One implementation carries it to every agent, and the methodology\nitself lives here as prompt files that any agent can consume. See [PHILOSOPHY.md](PHILOSOPHY.md)\nfor the full design rationale and traceability model.\n\n---\n\n## Implementation\n\n[odin-claude-plugin](https://github.com/OutlineDriven/odin-claude-plugin) is the single source: 613\nskills in 28 plugins, authored once and discovered by Claude Code, Codex, Cursor, and any Agent\nPlugins client from the same tree. There is no separate per-agent repository to install or track.\n\n---\n\n## Install\n\n### Claude Code\n\n```\n/plugin marketplace add OutlineDriven/odin-claude-plugin\n/plugin install odin-core@odin-marketplace\n```\n\n### Codex\n\n```\ncodex plugin marketplace add OutlineDriven/odin-claude-plugin\ncodex plugin add odin-core@odin-marketplace\n```\n\n### Cursor\n\nAdd the `OutlineDriven/odin-claude-plugin` marketplace in Cursor, then:\n\n```\n/plugin install odin-core\n```\n\nCursor reads the Agent Plugins manifest at each plugin root.\n\n### Devin\n\nDevin has no marketplace step. It reads project skills from `.devin/skills/<skill>/SKILL.md`, and\nthis repository carries every skill there as a flat, generated mirror of the plugin tree.\n`.devin/skills/index.json` records the plugin each skill came from and the release it mirrors. See\n[.devin/skills/README.md](.devin/skills/README.md).\n\n### Pick your plugins\n\n`odin-core` is the base installed above. The other 27 plugins are optional, so add the domains you\nwork in and skip the rest. Every one installs the same way, for example\n`/plugin install odin-security@odin-marketplace`. Three common additions:\n\n| Working on | Add |\n|---|---|\n| Everyday code changes | `odin-code`, `odin-run` |\n| Security review and hardening | `odin-security`, `odin-security-advanced` |\n| Research and technical writing | `odin-research`, `odin-writing` |\n\nThe full domain-to-plugin table, with the skill count per plugin, is in the\n[odin-claude-plugin README](https://github.com/OutlineDriven/odin-claude-plugin#choose-your-plugins).\n\n### CLI Tools\n\nSee [INSTALL.md](INSTALL.md) for CLI tool prerequisites and detailed setup.\n\n---\n\n## Comparison\n\n| Aspect | Vibe coding | Spec-driven (Spec Kit) | BMad | **Outline-Driven Development** |\n|---|---|---|---|---|\n| Source of truth | LLM intuition | Spec doc | Behavioral specs | **Versioned outline (hash-anchored)** |\n| Iteration unit | \"Try again\" | Spec -> re-prompt | BDD scenarios | **Outline node x diff** |\n| Validation | Eyeball | Spec compliance | Acceptance tests | **Diagram-first invariants + AST** |\n| Tooling | Plain chat | GitHub Spec Kit | BMad CLI | **One plugin tree for Claude Code, Codex, and Cursor** |\n| Reuse unit | Conversation | Spec template | Story | **Skill / agent / outline** |\n| LLM creativity | Unbounded | Bounded by spec | Bounded by story | **Bounded by outline; preserved within envelope** |\n| Best for | Throwaway scripts | Greenfield features | User-facing flows | **Long-lived methodologies + agentic work** |\n\n---\n\n## Status (2026-09)\n\nodin-claude-plugin 2.0.0 is the single implementation, shipping 613 skills across 28 plugins for\nClaude Code, Codex, Cursor, and any Agent Plugins client. The three prompt files were stripped of\npersona doctrine in early September 2026, so the methodology carries no agent identity of its own.\nReleases ship from the implementation repository, not from here.\n\n---\n\n## Contributing\n\nOpen an issue to discuss ideas or report bugs. PRs improving the methodology, prompts, or tooling documentation are welcome.\n\nDo not edit `.devin/skills/` here. Every file under it is written by `scripts/sync-outline-skills.mjs`\nin [odin-claude-plugin](https://github.com/OutlineDriven/odin-claude-plugin), which also deletes any\nfile the plugin tree no longer carries. Change the skill under `plugins/<plugin>/skills/<slug>/` in\nthat repository and run `just sync-outline` there. The script writes to the sibling checkout\n`../outline-driven-development` by default; `node scripts/sync-outline-skills.mjs --target <path>`\npoints it elsewhere, and `--check` reports drift without writing.\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 5574,
  "sha": "978a606749fd139c643a99f1509f6c8b59d205e6711297320acadcfad87415ad",
  "repo_slug": "outlinedriven/outline-driven-development",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_outlinedriven_outline_driven_development_fa1c2286/readme"
}