adr-author

To draft an architecture decision record, the skill applies sequential numbering, fills a standardized template with your decision narrative, and updates the ADR index. It manages bidirectional links to connect related records and superseded relationships automatically.

A technical decision meets the threshold for an ADR entry after passing an eligibility validation check. The skill evaluates whether a choice requires a formal architecture decision record or if a lighter-weight document is more appropriate for logging the decision.

The best way to maintain ADR traceability is through bidirectional link management and structured documentation updates. The skill handles cross-reference management by adding related ADR links and superseded relationships, keeping decision history easy to trace in the repository.

You manage ADR numbering by assigning the next available ID to each new architecture decision record. The skill automates this sequential numbering process while simultaneously updating the ADR catalog entry to ensure discoverability.

You do not need to manually update the ADR index after creating a new decision record. The skill automatically maintains the index through structured documentation updates, ensuring new entries are cataloged for discoverability.