speckit-decision-supersede

To supersede an Architecture Decision Record, provide the ID of the prior ADR and the title of the new decision. The old ADR is marked as superseded and linked to the new replacement ADR.

You should supersede an Architecture Decision Record when replacing a decision with a new version that incorporates changes or improvements, ensuring the original decision is preserved for audit trail purposes rather than overwritten.

Superseding an Architecture Decision Record preserves the audit trail by keeping the old ADR's content intact and adding a superseded_by link pointing to the newly created replacement ADR.

When superseding an Architecture Decision Record, the new ADR inherits the old ADR's constitution references automatically unless you explicitly override them during the creation of the new decision record.

You need the ID of the prior Architecture Decision Record you want to supersede and the title for the new decision. This allows the project governance system to link the old and new records.

When an Architecture Decision Record is superseded, the original content remains untouched for audit purposes while a new ADR is created and the old record receives a superseded_by link to it.