documentation-and-adrs

Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when yo…

addyosmani 80k ↓ 15k MIT updated 26d ago
Claude Code
View source ↗

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.

documentation-and-adrs on getagentictools
[![documentation-and-adrs on getagentictools](https://getagentictools.com/badge/skills/addyosmani-agent-skills-documentation-and-adrs.svg)](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.