Append structured Context, Decision, and Consequences entries to daily ADR files.
npx skills add https://github.com/tomfordrumm/agent-skills --skill adr-logger
Please help me install this Agent Skill. Skill: adr-logger Source: https://github.com/tomfordrumm/agent-skills/tree/main/adr-logger Command: npx skills add https://github.com/tomfordrumm/agent-skills --skill adr-logger
It prevents lost context by ensuring architectural decisions made during work are consistently recorded in an ADR directory, instead of being scattered across chat or ignored.
Use case: When you change an implementation approach while fixing a bug or selecting a design pattern, the skill ensures that the “why” and tradeoffs are preserved in the relevant daily ADR file for your team to audit later.
Ask your agent: "While completing this task, log the architectural decision to ADR/adr_yyyy_mm_dd.md with a single entry including Context, Decision, and Consequences."
High-intent search queries and answers about installing and using this skill.
To automatically log architectural decision records, you can use a skill that appends one structured entry per task into a daily ADR file. It automatically checks for or creates an ADR directory and uses local time for timestamping entries.
The standard format for capturing architectural decisions uses a daily file named adr_yyyy_mm_dd.md. Each entry must be structured with three sections: Context, Decision, and Consequences, ensuring consistent and reviewable records.
Preventing lost context requires logging architectural decisions in a dedicated ADR directory. By appending the rationale and tradeoffs for each task to a daily file, teams can audit the "why" behind implementation changes later.
The best way to enforce consistent ADR creation is through workflow automation that captures decisions as you work. This approach standardizes timestamps using local time and ensures exactly one decision entry is appended per task.
No, you do not need to manually create an ADR directory. The logging process automatically checks for the directory and creates it when missing, ensuring the daily adr_yyyy_mm_dd.md files are always saved correctly.
smarmen86Deletes the freeze state file to restore write access across project directories.
abdullah1854Generate Architectural Decision Records in structured Markdown format.
stevolandCreate and manage MADR-compliant Architecture Decision Records across projects.
KrystianYCSilvaCreate Markdown documentation with Mermaid diagrams and GFM tables.
