Create standardized ADR.md files under docs/specs/{feature}/adr.md with required sections.
npx skills add https://github.com/kinncj/MAPLE --skill rfc-adr
Please help me install this Agent Skill. Skill: rfc-adr Source: https://github.com/kinncj/MAPLE/tree/main/template/.opencode/skills/rfc-adr Command: npx skills add https://github.com/kinncj/MAPLE --skill rfc-adr
Architectural decisions are often scattered across documents, making traceability and governance difficult. This Skill provides a standardized way to create, store, and reference Architecture Decision Records (ADRs) that capture context, alternatives, and outcomes.
Create the first ADR for a major architectural decision by drafting an adr.md in docs/specs/your-feature and filling in the required sections.
High-intent search queries and answers about installing and using this skill.
Document architectural decisions by creating Architecture Decision Records (ADRs) that capture context, alternatives, and outcomes to ensure traceability. ADRs provide a standardized way to store and reference decision history, solving the problem of scattered architectural documentation.
An Architecture Decision Record should include sections for Status, Context, Goals, Alternatives, Trade-offs, and Next Steps. This standardized format ensures decisions are traceable and enables collaborative governance across teams.
Organize ADR files by storing them as adr.md files under the docs/specs/{feature}/adr.md directory path. This structure preserves decision history by linking architectural decisions directly to their corresponding feature or project folders.
The ADR lifecycle flows from proposal to acceptance, re-evaluation, or supersession to ensure architectural decisions stay current. Lifecycle guidance helps teams manage when decisions need to be revisited or replaced over time.
Create an ADR whenever a significant architectural decision is made that impacts future development. ADRs are needed when decisions involve trade-offs, constraints, and alternatives that future team members must understand for effective governance.
Yes, ADRs enable collaborative governance by allowing teams to document context, constraints, and trade-offs for future work. The standardized format under docs/specs/ ensures all team members can reference and trace architectural decisions.
asermaxInitialize katachi framework directories and CLAUDE.md baseline in projects.
JacksonZx535Review architectural proposals for ADR compliance, conflicts, dependencies, and priorities.
pratikrath126Organize architecture decisions using structured ADR templates and decision records.
rlagycksCreate and update architecture decision records using standard templates.
