Create Runbooks for operational documentation. For ADRs, tech specs, requirements, LLD and technical analysis use the tech-writing skill instead.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
> **AI-consumed reference.** Optimized for Claude to read during execution.
> Human-readable explanation: see [docs/architecture/HIERARCHICAL_PLANNING.md](../../../docs/architecture/HIERARCHICAL_PLANNING.md)
> or [docs/getting-started/](../../../docs/getting-started/) depending on topic.
# Documentation (ADR & Runbook)
## When to Create
- **Runbook:** Service deployment, common ops tasks, incident response
- **ADR:** → use `skills/tech-writing` + `templates/decision-record.md`. That template carries the
full 4-tier ladder (Y-statement → Nygard ADR → MADR → RFC) and picks the tier by decision size.
The stripped ADR template below is kept only so existing links keep resolving.
## ADR Template
```markdown
# ADR-[N]: [TITLE]
**Status:** Proposed | Accepted | Deprecated | Superseded by ADR-X
**Date:** YYYY-MM-DD
## Context — ## Decision — ## Options Considered — ## Consequences
```
Location: `docs/adr/ADR-NNN-description.md`. Keep immutable — supersede, don't edit.
## Runbook Template
```markdown
# Runbook: [Service]
**Owner:** [Team] | **On-Call:** [Contact]
## Prerequisites — ## Common Operations — ## Troubleshooting — ## Alerts & Escalation
```
…
The line at the top of this page pins the label git:20261029.30f94d9, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_47jey2rhj2xyzu3m
GET https://markdownregistry.com/api/v1/resolve?ref=nguyenthienthanh/aura-frog/documentation
GET https://markdownregistry.com/api/v1/blob/530edef1b5849e5600c9aea51835d0ad64d952c9f0ea78a2d45a75ecfad86b41
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
nguyenthienthanh/aura-frog · archon-os/skills/agent-detector/SKILL.md · CRITICAL: MUST run for EVERY message. Detects agent, complexity, AND model automatically. Without this, tasks route to…
nguyenthienthanh/aura-frog · archon-os/skills/bugfix-quick/SKILL.md · Fast bug fixes with root cause investigation + TDD. Enforces 'no fix without root cause' discipline and verification…
nguyenthienthanh/aura-frog · archon-os/skills/code-map/SKILL.md · Reverse-dependency lookup — "I am about to change this file, what breaks?" Use when assessing the blast radius of an…
nguyenthienthanh/aura-frog · archon-os/skills/deep-debugging/SKILL.md · Systematic debugging protocol for bugs that resist quick fixes. Use bisection, hypothesis trees, and scientific method…
jrenaldi79/harness-engineering · plugins/documentation/skills/documentation/SKILL.md · Use when the user asks to install or maintain a documentation index, keep CLAUDE.md or AGENTS.md inventories…
cooneycw/claude-power-pack · .claude/skills/documentation/SKILL.md · Generate C4 architecture diagrams as GitHub-renderable Mermaid, and PowerPoint slides. Use to update docs, or draw a c4…
jnpiyush/agentx · .github/skills/development/documentation/SKILL.md · Write effective documentation including inline docs, README structure, API documentation, and code comments. Use when…
alexander-danilenko/cortex-ai-skills · plugins/engineering/cortex-knowledge/skills/documentation/SKILL.md · ALWAYS invoke for any task involving docstrings, JSDoc/TSDoc, or REST API documentation — even when the request seems…
alexander-danilenko/cortex-claude-code-plugins · plugins/engineering/cortex-knowledge/skills/documentation/SKILL.md · ALWAYS invoke for any task involving docstrings, JSDoc/TSDoc, or REST API documentation — even when the request seems…
