adr

Solid

Rédige un Architecture Decision Record (MADR léger) depuis un artifact (pitch/plan/review/report) ou un topic libre — contexte, drivers, options, conséquences. Produit `docs/adr/NNNN-<slug>.md` avec backlinks et index auto.

AI & Automation 3 stars 0 forks Updated today Apache-2.0

Install

View on GitHub

Quality Score: 82/100

Stars 20%
20
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# /adr — Atelier de décision architecturale Tu es un architecte logiciel exigeant. Tu captures une décision technique structurante de façon à ce qu'un futur lecteur (humain ou agent) comprenne **le contexte qui l'a rendue nécessaire**, **les options sérieusement considérées**, **la décision retenue** et **les conséquences assumées**. Tu refuses les ADR creux ("on a choisi X parce que c'est mieux") — sans drivers explicites et options écartées, l'ADR n'a pas de valeur. ## Périmètre du skill Ce skill produit un **ADR atomique** (une décision = un fichier) dans `docs/adr/NNNN-<slug>.md`. Il s'utilise dans plusieurs contextes : - **Depuis un artifact de la timeline** (`pitch.md`, `plan.md`, `review.md`, `report.md`) — extrait la décision implicite ou explicite et la transforme en ADR autonome, avec backlink dans l'artifact source. - **Depuis une revue de code** (`/review` qui révèle un choix structurant à graver) — capture la décision avant qu'elle ne se dissolve dans le diff. - **En standalone sur un sujet** (`/adr passer à Redis pour le cache de sessions`) — explore le code et le contexte, challenge les options, puis rédige. Il **ne code pas** (c'est `/feature-implem` / `/refactor-implem` / `/tech-implem`) et **ne re-cadre pas** un besoin fonctionnel (c'est `/feature-pitch`). Si la décision suppose un cadrage fonctionnel manquant, **arrête-toi** et redirige. Une décision = un ADR. Si l'utilisateur veut documenter plusieurs choix indépendants, fais plusieurs ADR (en boucla...

Details

Author
gabrielmustiere
Repository
gabrielmustiere/forge
Created
2 months ago
Last Updated
today
Language
PHP
License
Apache-2.0

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

adr-author

Authors Architecture Decision Records (ADRs) that capture context, considered options with trade-offs, the chosen decision, and its consequences. Use this skill when the user wants to write, draft, document, or revise an architecture decision, an ADR, a design decision record, a technical decision log, or asks "why did we choose X" / "we need to record this decision" / "document this trade-off" for things like database choice, framework selection, API style, build vs. buy, or deprecating a component.

3 Updated today
JayRHa
DevOps & Infrastructure Solid

adr

Capture architectural decisions as structured ADRs (Architecture Decision Records). Use when user says 'record this decision', 'ADR this', 'why did we choose X', 'document this trade-off', 'we decided to...', or when a significant choice is made between alternatives (framework, database, pattern, API design, infra approach).

6 Updated 5 days ago
anmolnagpal
AI & Automation Solid

adr-generator

Create comprehensive Architectural Decision Records (ADRs). Researches the destination directory to detect existing template conventions, gathers context, determines next ADR number, generates the ADR, validates completeness, and saves. Supports multiple ADR formats (MADR, Nygard, Alexandrian, project canonical). Use when documenting technical decisions, creating new ADR files, or capturing rationale so future readers can revisit a choice. Use when you say "write an ADR", "document this decision", "document these design choices", "record why we chose this", "capture the rationale", or "for future maintainers", or when creating an ADR-like markdown file under docs/decisions/, docs/adr/, docs/architecture/, architecture/decisions/, or .agents/architecture/. Do NOT use to debate or review an existing ADR (use adr-review).

38 Updated today
rjmurillo