# DoCoDeGo

> An open framework for engineering teams, knowledge workers, and any
> organisation accountable for what AI produces in their name. Four pillars
> — Document, Compose, Demonstrate, Govern — and sixteen statutes that make
> the loop non-negotiable. In Alpha.

## The Axiom

Intent is the primary artefact.
Implementation is a compiled derivative.
Governance is earned through the loop.

## The four pillars

- **DO — Document.** The Author. Specification is the only source of truth.
- **CO — Compose.** The Architect. Human owns the architecture; AI implements it.
- **DE — Demonstrate.** The Gatekeeper. Value flows at the speed of validation, not schedules.
- **GO — Govern.** The Governor. Autonomy without accountability is catastrophe.

## The lineage

- **Waterfall** formalised investigation to solve chaos.
- **Agile** iterated to solve change.
- **DoCoDeGo** answers what AI did to both — investigation became cheap, and intent became the highest-leverage human work.

## Canonical pages

- [/](https://docodego.com/): Homepage. Lineage, framework, live ICS preview, used-by strip, manifesto teaser, the loop, the 16 statutes, the practice teaser.
- [/docs](https://docodego.com/docs.html): The full handbook in one read — 18 sections with sticky TOC, pulls live data from canonical sources.
- [/manifesto](https://docodego.com/manifesto.html): The Manifesto — four values (Intent over Implementation, Direction over Production, Flow over Releases, Governance over Process), the Axiom, the Agile shift, the Anti-Complexity Principle, what DoCoDeGo is not, the name.
- [/vision](https://docodego.com/vision.html): Vision and philosophy. Companion essay to the Manifesto.
- [/why-now](https://docodego.com/why-now.html): Why DoCoDeGo now. The bottleneck moved. Eight specific frictions of practising Agile in the AI era, each with a 2025–26 source and the framework's answer.
- [/why-not](https://docodego.com/why-not.html): When DoCoDeGo is the WRONG answer. Eight contexts where the framework adds more cost than clarity, and what to do instead.
- [/pillars](https://docodego.com/pillars.html): The four pillars in depth, with leader notes, what each requires, and the shift from traditional practice.
- [/statutes](https://docodego.com/statutes.html): The 16 statutes — four per pillar — with principle, detail, and most common violation.
- [/practice](https://docodego.com/practice.html): The four foundational practices, the spec template, the six metrics, the Spec Lab (live ICS scoring), the four roles, the Good Code Mark.
- [/prompts](https://docodego.com/prompts.html): Battle-tested system prompts for Claude / GPT / Cursor — Intent Architect, Compose Reviewer, Governor AAR, ICS Self-Scorer, Cursor system prompt.
- [/glossary](https://docodego.com/glossary.html): Every acronym and term, alphabetical.
- [/changelog](https://docodego.com/changelog.html): Reverse-chronological log of framework, site, tooling, and community changes.
- [/success-stories](https://docodego.com/success-stories.html): Implementation examples.
- [/community](https://docodego.com/community.html): Where the framework gets made.
- [/collaborate](https://docodego.com/collaborate.html): Careers. Three doors in (Contribute, Residency, Founding Hire). The work is the interview.
- [/secret](https://docodego.com/secret.html): Developer-vibe egg decoder — every keyboard shortcut, every typed keyword, every window.dcdg.* API, with live "run" buttons and a working REPL.
- [/credits](https://docodego.com/credits.html): Hand-written thank-you. The Konami code lands here.

## Machine-readable

- [/.well-known/docodego.json](https://docodego.com/.well-known/docodego.json): Framework metadata (axiom, pillars, statutes count, lineage, resources).
- [/.well-known/security.txt](https://docodego.com/.well-known/security.txt): Vulnerability disclosure policy (RFC 9116).
- [/llms-full.txt](https://docodego.com/llms-full.txt): Verbatim concatenation of Manifesto, Vision, Statutes, Glossary.
- [/sitemap-index.xml](https://docodego.com/sitemap-index.xml): Sitemap for indexers.

## Tooling

Canonical Python CLIs (installable via `pip`):
- `spec-linter` — structural validation of spec markdown
- `ics-scorer` — canonical Intent Clarity Score (full rubric)
- `aar-gtr-tracker` — After-Action Review + Green-To-Red tracking
- `rc-runner` — runbook checklist automation
- `sdl-ddl-analyzer` — SDL / DDL trend analysis
- `spec-diff` — semantic spec diffing
- `threat-validator` — threat-model validation

Developer affordances (publishing soon; build from source today):
- `vscode-docodego` — live ICS in VS Code; status bar, diagnostics, quick fixes, CodeLens, acronym hover, outline, Activity Bar sidebar, save guard, walkthrough.
- `browser-extension-docodego` — ICS badge on GitHub / GitLab / Bitbucket / Codeberg; per-file PR-diff pills, multi-file PR summary, inline vague-term highlights, sparkline trends, popup + options + Side Panel.
- `github-action-ics` — composite GitHub Action that gates PRs against the configured ICS threshold and comments the per-spec breakdown.
- `mcp-docodego` — Model Context Protocol server so AI agents can introspect + score with the framework directly. Tools: `dcdg/axiom`, `dcdg/pillars`, `dcdg/score-spec`, `dcdg/statute`, `dcdg/glossary`, `dcdg/spec-template`.

## For deeper context

The full canonical text — manifesto, vision, pillar deep-dives, statutes,
spec template, metrics, glossary — is available at
[/llms-full.txt](https://docodego.com/llms-full.txt).

## Developer affordances

Interactive site features for AI agents and humans poking the page:

- `window.dcdg` global API on every page: `dcdg.flair(on?)` toggles the
  playful layer; `dcdg.axiom()` flashes the Axiom; `dcdg.pluck(pillar)`
  plucks a visible string; `dcdg.extravaganza(reason?)` cascade-plucks
  everything; `dcdg.version` returns `"alpha"`; `dcdg.docs` returns this
  URL.
- ⌘K / Ctrl K opens a command palette with fuzzy search across pages,
  actions, and Pagefind full-text content matches.
- `?` opens a keyboard shortcut cheat sheet.
- Gmail-style `g [h|d|m|p|s|r|w|n|v|l|t|x|c]` for sequential navigation.
- See /secret for the complete list with run buttons + REPL.

## Contact

Discord and email contacts live on every page (footer + /collaborate). Email: careers2026@docodego.com. Security: security@docodego.com.

## License

Open documentation. Use freely. Attribute appropriately. CC BY 4.0.