{"enrichment":{"faq":[{"a":"ADR Drafting helps you create a new Architecture Decision Record by generating a structured file with standard sections. The skill inspects your repository for existing ADR conventions, then drafts a record with Title, Status, Context, Decision, and Consequences sections. If no convention exists, it defaults to storing the ADR in `docs/architecture/adr`.","q":"How do I document an architectural choice with adr-drafting?"},{"a":"ADR Drafting structures each Architecture Decision Record with five key sections: Title (the decision name), Status (such as Proposed or Accepted), Context (background and problem statement), Decision (the chosen solution), and Consequences (trade-offs and impacts). This standard format ensures consistent documentation across your team's architectural decisions.","q":"What sections does adr-drafting include in a new ADR?"},{"a":"Yes, ADR Drafting can generate an ADR template tailored to your needs, including database migration decisions. It creates a properly named and located file following your repository's conventions, with all standard sections ready for you to fill in the specific context, rationale, and consequences of your database choice.","q":"Can adr-drafting generate ADR template for database migration?"},{"a":"ADR Drafting creates markdown files that document your technical rationale and trade-offs, preserving architectural decision history in a structured, searchable format within your repository. This enables team members to understand why past decisions were made and reference them when evaluating future architectural changes.","q":"How does adr-drafting preserve architectural decisions for team knowledge?"},{"a":"ADR Drafting follows your repository's existing ADR naming conventions when detected. If no convention exists, it defaults to sequential numbering (like ADR 0001) and stores files in `docs/architecture/adr`. The skill generates properly formatted filenames that integrate seamlessly with your project's documentation structure.","q":"What naming convention does adr-drafting use for new records?"},{"a":"Yes, ADR Drafting is designed to document technical decisions like technology stack choices. It helps you capture the Context (why the decision was needed), Decision (which tech stack was chosen), and Consequences (benefits and trade-offs), creating a permanent record that explains your architectural choices to current and future team members.","q":"Does adr-drafting help document why we chose our tech stack?"}],"shadow_tags":["decision-documentation","architecture-governance","technical-rationale","repo-conventions","change-history","design-decisions","knowledge-preservation","structured-records","team-alignment"],"summary_rewrite":"ADR Drafting helps teams document significant architectural decisions by creating new Architecture Decision Record files with a standard structure. It inspects your repository for existing ADR conventions, then drafts a new record with Title, Status, Context, Decision, and Consequences sections\u2014defaulting to `docs/architecture/adr` when no convention exists."},"files":[{"bytes":6421,"path":"plugins/developer-kit-core/skills/adr-drafting/SKILL.md","sha256":"ba80d9545b3777816aeb059b4f66a0a75713a0c1b6c017ed84d9ce620f7a535a","url":"https://skillfed.io/files/giuseppe-trisciuoglio/developer-kit/adr-drafting/41b68bcd/SKILL.md"}],"id":"giuseppe-trisciuoglio/developer-kit/adr-drafting","links":{"html":"https://skillfed.io/giuseppe-trisciuoglio/developer-kit/adr-drafting","md":"https://skillfed.io/giuseppe-trisciuoglio/developer-kit/adr-drafting.md","repo":"https://github.com/giuseppe-trisciuoglio/developer-kit"},"meta":{"agents_supported":[],"first_seen":"2026-07-28","forks":37,"language":"Python","last_updated":"2026-06-22","license":"MIT","name":"adr-drafting","publisher":"giuseppe-trisciuoglio","stars":311},"relations":{"categories":["architecture","documentation","devops"],"similar":[{"id":"affaan-m/ECC/architecture-decision-records"},{"id":"JosiahSiegel/claude-plugin-marketplace/adr-drafting"},{"id":"JosiahSiegel/claude-plugin-marketplace/doc-diagnostic"},{"id":"giuseppe-trisciuoglio/developer-kit/typescript-docs"},{"id":"JosiahSiegel/claude-plugin-marketplace/adr-backfill"},{"id":"ncklrs/startup-os-skills/adr"},{"id":"joelhooks/joelclaw/adr-skill"},{"id":"JosiahSiegel/claude-plugin-marketplace/adr-critique"},{"id":"tech-leads-club/agent-skills/create-adr"},{"id":"Mathews-Tom/armory/adr-writer"}]},"slug":{"owner":"giuseppe-trisciuoglio","repo":"developer-kit","skill":"adr-drafting"},"version":"41b68bcd"}