documentation-and-adrs

documentation-and-adrs is an open-source docs skill for Claude Code and compatible agents, published by addyosmani. Its author describes it as: “Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the co…”. The project has 88k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add addyosmani/agent-skills`.

What documentation-and-adrs does

Document decisions, not just code. The most valuable documentation captures the *why* — the context, constraints, and trade-offs that led to a decision. Code shows *what* was built; documentation explains *why it was built this way* and *what alternatives were considered*. This context is essential for future humans and agents working in the codebase.

Installation

Add documentation-and-adrs to your agent with:

/plugin marketplace add addyosmani/agent-skills

Always review a skill's source before installing it. This command comes from the skill's public repository; the linked repo is the source of truth for exact setup steps.

What's inside

The SKILL.md for documentation-and-adrs is organised into these sections:

• Overview
• When to Use
• Architecture Decision Records (ADRs)
• When to Write an ADR
• Match the existing convention first
• ADR Template
• ADR Lifecycle
• Inline Documentation
• When to Comment
• When NOT to Comment
• Document Known Gotchas
• API Documentation

When to use it

Reach for documentation-and-adrs when you want docs help from your agent without writing the same instructions every session. Load the skill and the agent picks it up automatically for relevant tasks.

Strengths

• Clear MIT license — safe to read and adapt
• Ships in addyosmani/agent-skills, an established project with 88,280 GitHub stars
• Actively maintained (recent commits)

Topics

Frequently asked questions

What does documentation-and-adrs do?

Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.

How do I install documentation-and-adrs?

Run /plugin marketplace add addyosmani/agent-skills in your agent, then reload your skills. Review the source at https://github.com/addyosmani/agent-skills before installing.

Is documentation-and-adrs free to use?

Yes. documentation-and-adrs is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.

Where does documentation-and-adrs come from?

documentation-and-adrs ships inside addyosmani/agent-skills, a repository that contains 25 catalogued skills in total. The repository's 88,280 GitHub stars apply to that whole collection, not to this skill on its own.