adr-done

Update ADR status and archive the file in docs/ai/adr.

1|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/im9/inboil --skill adr-done
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adr-done
Source: https://github.com/im9/inboil/tree/main/.claude/skills/adr-done
Command: npx skills add https://github.com/im9/inboil --skill adr-done

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill standardizes the lifecycle of Architecture Decision Records by marking them as Implemented or Superseded and archiving them according to INDEX.md conventions.

Core Features & Use Cases

  • Ensures ADRs move to archive when implemented or superseded, keeping the ADR registry tidy and accurate.
  • Validates statuses against INDEX.md guidelines and updates both the ADR and index documentation accordingly.
  • Use case: When a decision is implemented, archive the ADR and update the index to preserve a clean history.

Quick Start

Mark ADR 123 as Implemented and move it to the archive.

Frequently Asked Questions about adr-done

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I archive an Architecture Decision Record after it is implemented?

To archive an Architecture Decision Record, you mark its status as Implemented or Superseded and move the file to the archive directory while updating the INDEX.md file to reflect the new status.

What is the best way to update an ADR status to Superseded and keep the registry tidy?

The best way to update an ADR status to Superseded is to verify its current status, modify the file, move it to the archive directory, and update the INDEX.md documentation to maintain a clean ADR registry.

When do I need to move an ADR file to the archive directory?

You need to move an ADR file to the archive directory when the architecture decision is fully implemented or superseded by a newer decision, ensuring your active docs/ai/adr folder remains accurate.

Does archiving an ADR automatically update the INDEX.md file?

Yes, archiving an ADR automatically updates the INDEX.md file to reflect the new Implemented or Superseded status, validating the change against INDEX.md conventions to preserve a clean history.

How do I mark ADR 123 as Implemented in my documentation workflow?

To mark ADR 123 as Implemented, you identify the specific ADR file in docs/ai/adr, verify its current status, update the file status, move it to the archive directory, and adjust the INDEX.md file accordingly.