Adr Writing
Formats architectural decision records using the MADR template and runs them through a five-point definition of done checklist (Explicit, Comprehensive, Actionable, Documented, Reviewable). The workflow is pretty methodical: grab the next ADR number from a Python script, explore related code and existing decisions, fill out the template sections, then verify completeness. When you hit gaps in the data, it drops investigation markers directly into the draft rather than blocking you. Every ADR gets YAML frontmatter with status and date, which is enforced at write time. Most useful when you've already extracted the decision details and just need to turn them into a proper document that won't get rejected in review.
- skills.sh installs
- 250
- GitHub stars
- 87
- last updated
- Aug 21, 2026
Install
$ npx -y skills add existential-birds/beagle --skill adr-writing --agent claude-codeInstalls into .claude/skills of the current project.
Files
ADR Writing
Overview
Generate Architectural Decision Records (ADRs) following the MADR template with systematic completeness checking.
Quick Reference
┌─────────────┐ ┌──────────────┐ ┌─────────────┐
│ SEQUENCE │ ──▶ │ EXPLORE │ ──▶ │ FILL │
│ (get next │ │ (context, │ │ (template │
│ number) │ │ ADRs) │ │ sections) │
└─────────────┘ └──────────────┘ └─────────────┘
│ │
│ ▼
│ ┌─────────────┐
│ │ VERIFY │
│ │ (DoD │
└─────────────────────────────────│ checklist)│
└─────────────┘
When To Use
- Documenting architectural decisions from extracted requirements
- Converting meeting notes or discussions to formal ADRs
- Recording technical choices from PR discussions
- Creating decision records from design documents
Workflow
Gates (objective pass conditions)
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/existential-birds/beagle
- Categories
- Documentation, Code Review & Quality, Productivity & Planning, Automation & Workflows
- First seen
- Jun 3, 2026
More from existential-birds/beagle
All 40- Dagre React Flow247
- Swift Code Review247
- Pytest Code Review232
- Sqlalchemy Code Review225
- Pydantic Ai Common Pitfalls221
- Pydantic Ai Agent Creation219
- Agent Architecture Analysis217
- Ai Elements209
- Go Code Review204
- Shadcn Code Review204
- Swift Testing Code Review194
- Sqlite Vec171
- Pydantic Ai Tool System161
- Deepagents Architecture160
- Langgraph Implementation160
- Pydantic Ai Testing146
- Pydantic Ai Dependency Injection141
- Deepagents Implementation140
- Deepagents Code Review132
- Github Projects120
- Pydantic Ai Model Integration120
- React Flow1.3K
- Python Code Review928
- Langgraph Code Review887
Recommended
More Documentation
blog-postnexu-io/open-designA long-form article / blog post — masthead, hero image placeholder, article body with figures and pull quotes, author byline, related posts. Use when the brief 245skills.sh installs
document-writingshino369/claude-code-personal-workspaceExpert knowledge in document and essay writing conventions for English, Japanese, and Chinese (Traditional). Use when writing or translating formal documents, e241skills.sh installs
nansen-agent-guidenansen-ai/nansen-cliRouting guide -- when to use `nansen agent` (AI research) vs direct CLI data commands. Use when deciding how to answer a user's research question with Nansen to240skills.sh installs
writing-assistantyunshu0909/yunshu_skillshub写作助手 - 当用户说"我想写XX"、"帮我梳理选题"、"怎么形成框架"、"给我组织思路"时触发。根据观点清晰度自动选择最优路线：清晰观点走"框架→内容"，模糊观点走"挖掘→选题→框架→内容"。239skills.sh installs
demo-specialistncklrs/startup-os-skillsExpert product demonstration specialist for SaaS and B2B software. Use when preparing demos, structuring demo presentations, tailoring to stakeholders, handling229skills.sh installs
anti-ai-writingcdeistopened/skill-stackTransform AI-assisted drafts into authentic, human-sounding content. This skill provides patterns to detect and eliminate AI tells, frameworks for natural writi225skills.sh installs