documentation-and-adrs
Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when yo…
What it does
- Making a significant architectural decision
- Choosing between competing approaches
- Adding or changing a public API
- Shipping a feature that changes user-facing behavior
- Onboarding new team members (or agents) to the project
- When you find yourself explaining the same thing repeatedly
- Choosing a framework, library, or major dependency
Requirements & configuration
- We need a primary database for the task management application. Key requirements:
- Cons: Our data is inherently relational; would need to manage relationships manually
- Team needs PostgreSQL knowledge (standard skill, low risk)
Derived from the skill's own SKILL.md documentation · extracted 2026-07-23
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.
Source
Repository: https://github.com/addyosmani/agent-skills
documentation-and-adrs FAQ
What does the documentation-and-adrs skill 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. Making a significant architectural decision Choosing between competing approaches
What does documentation-and-adrs require?
We need a primary database for the task management application. Key requirements: Cons: Our data is inherently relational; would need to manage relationships manually Team needs PostgreSQL knowledge (standard skill, low risk)
How do I install documentation-and-adrs?
Run: npx -y skills add https://github.com/addyosmani/agent-skills --skill documentation-and-adrs --agent claude-code — the source lives at github.com/addyosmani/agent-skills.
Maintain documentation-and-adrs?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[](https://getagentictools.com/skills/addyosmani-agent-skills-documentation-and-adrs?ref=badge) npx agentictools info skills/addyosmani-agent-skills-documentation-and-adrs The second line is the CLI lookup for this page — handy in READMEs and docs.