create-adrs

You generate retroactive architecture decision records by reconstructing context and rationale from existing repository evidence, explicitly marking uncertain information. This produces MADR-style documents for significant technical choices made previously.

A retroactive ADR documents the rationale behind a past architectural shift using existing repository evidence. You need to create one after a major technical decision has been implemented without initially recording its context, decision, and outcome.

You document technical debt and decision rationale by scanning repository evidence to reconstruct the original reasoning. The generated ADR explicitly distinguishes between directly evidenced facts and reconstructed rationale to maintain historical accuracy.

Yes, you can manage existing architecture decision records by updating or preserving them based on new repository evidence. This ensures that reconstructed rationale and context remain accurate as the software project evolves.

Yes, the ADR generation process strictly adheres to MADR-style structure. This standard format ensures every architecture decision record includes the necessary context, decision, and outcome sections for comprehensive technical documentation.