documentation-and-adrs
A skill from Addy Osmani's agent-skills collection for recording why code is the way it is.
Was der Skill vermittelt
A skill from Addy Osmani's agent-skills collection for recording why code is the way it is. When the agent makes an architectural decision, changes a public API or ships user-facing behaviour, it writes an architecture decision record, first matching any existing ADR folder, numbering and headings, and otherwise using the skill's template with context, decision, alternatives and consequences. It also covers when inline comments are worth adding and when not, API documentation through typed doc comments or OpenAPI, a README outline, keeping a changelog, documentation written for agents, and a final prose review.
Funktionen
- Write architecture decision records matching existing conventions
- Document public APIs with doc comments or OpenAPI
- Outline a README and maintain a changelog
- Decide when inline comments are needed
Überblick
- Herausgeber
- Addy Osmani
- Tool
- Documentation
Installation
Das Projekt dokumentiert keine Installationsschritte, die wir bestätigen konnten. Zur Anleitung des Projekts
MCP-Server und Skills können Code auf deinem Rechner ausführen und auf deine Daten zugreifen. Prüfe den Quellcode, bevor du etwas installierst.
Details
| Angabe | Wert | Quelle |
|---|---|---|
| Typ | Skill | |
| Tool | Documentation | |
| Herausgeber | Addy Osmani | Quelle |
| Offizieller Status | In der Dokumentation nicht angegeben | |
| Braucht API-Key oder Anmeldung | In der Dokumentation nicht angegeben | |
| Enthält Skripte | Nein | Quelle |
| Plattformen | In der Dokumentation nicht angegeben | |
| KI-Clients | In der Dokumentation nicht angegeben | |
| Lizenz | MIT | Quelle |
| Preis | In der Dokumentation nicht angegeben | |
| Aktivität | Letzter Commit am 1. Nov. 2026115.373 GitHub-SterneKeine Download-Daten verfügbar (nicht auf npm oder PyPI) | Quelle |
| Links | Repository Website |
Weitere Kopien dieses Skills (5)
Ihr Text weicht von diesem Skill ab. Es kann sich um angepasste Kopien oder ältere Versionen handeln.
- documentation-and-adrsnota-america/forgecat-agent-profiles
- documentation-and-adrsnota-america/forgecat-agent-profiles
- documentation-and-adrsnota-america/forgecat-agent-profiles
- documentation-and-adrsmarcmarti9/agentit
- documentation-and-adrsrvey/agent-engineering-kit
Mehr von Addy Osmani
25 Skills
- ci-cd-and-automation (Skill)
- api-and-interface-design (Skill)
- browser-testing-with-devtools (Skill)
- code-simplification (Skill)
- constraint-driven-development (Skill)
- using-agent-skills (Skill)
Auch zu finden unter: Documentation
Quellen
- Skill-Datei (SKILL.md)github.com/addyosmani/agent-skills10. Nov. 2026
- Lizenzdatei (LICENSE)github.com/addyosmani/agent-skills · Belegt: Lizenz12. Nov. 2026
- GitHub-Repositorygithub.com/addyosmani/agent-skills · Belegt: Herausgeber, Aktivität, Lizenz11. Nov. 2026
- Ordner im Repository (documentation-and-adrs)github.com/addyosmani/agent-skills · Belegt: Enthält Skripte10. Nov. 2026