designrecord-drr
Records a formal Design-Rationale Record (DRR) for architectural decisions.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Design: Record DRR (E.9)
1. Context
This skill implements Pattern E.9 (Design-Rationale Record Method). It captures the "Why" behind architectural changes, providing immutable history and evolutionary context.
2. Metadata
-
ID:
design/record-drr -
Role:
U.RoleAssignment(Archivist) - Standard: E.9, A.10
3. Instructions
3.1 Input Requirements
- Context: The affected system or domain.
- Title: Short summary of the decision.
-
Status:
Proposed,Accepted,Deprecated,Rejected. - Context (Problem): What is the issue?
- Decision: What are we doing?
- Consequences: What becomes easier? What becomes harder? (Trade-offs).
3.2 Output Artifact
Generate a Markdown file (The DRR) following the ADR (Architecture Decision Record) format:
-
Filename:
[NNN]-[kebab-title].md(where NNN is a sequential number). -
Structure:
# [NNN] [Title] ## Status [Status] on [Date] ## Context [Description of the problem/force] ## Decision [Description of the solution] ## Consequences [Positive and Negative effects]
3.4 Execution Steps
-
Index: Find the next sequential number in the
design/decisions/directory. - Draft: Create the file with the strict headers.
- Commit: (Implicit) The file is written to disk.
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!