Why is the Y-statement required?

The Y-statement provides a concise, one-sentence summary of the context, the decision, and the tradeoffs, making it easy for developers to quickly understand the rationale behind a choice.

Where are these decision records stored?

Records are stored as version-controlled Markdown files within the {project-root}/docs/agdr/ directory, following a sequential NNNN-slug naming convention.

An Agent Decision Record (AgDR) is a specialized standard for documenting technical decisions made specifically by AI agents, extending the concept of traditional Architectural Decision Records (ADRs).

Can this skill help with library comparisons?

Yes, the skill is designed to parse multiple options and present them in a comparative table, making it ideal for 'X vs Y' library evaluations.

How do I trigger a new decision record?

You can trigger the skill by using the /decide command followed by your technical question, for example: '/decide which caching strategy to implement.'

Technical Decision Records (AgDR)

Name: Technical Decision Records (AgDR)
Author: me2resh

byme2resh

•

학습 및 문서화

Enforces structured technical decision-making by generating auditable Agent Decision Records (AgDR) for architectural choices.

The AgDR skill introduces a standardized framework for documenting technical choices made by AI coding agents, evolving the traditional Architectural Decision Record (ADR) for the age of AI-assisted development. By forcing a structured process—parsing context, weighing options in a comparative table, and generating an auditable Markdown file—this skill ensures that every 'should I use X or Y' moment is recorded with clear justification, tradeoffs, and consequences. It is essential for teams using AI to maintain transparency, prevent technical debt, and preserve the architectural 'why' within their codebase history.

주요 기능

01Context Isolation: Captures only the specific problem constraints and codebase context that influenced the choice.

02Comparative Analysis: Forces a 2-4 option comparison using structured Pros/Cons tables for objective evaluation.

03Y-Statement Summary: Generates a mandatory one-line executive summary capturing context, decision, and tradeoffs.

04Automated ID Management: Tracks and increments decision IDs automatically to maintain a sequential project history.

05Standardized AgDR Generation: Automatically creates numbered Markdown files with YAML frontmatter for technical auditability.

0625 GitHub stars

사용 사례

01Evaluating and selecting third-party libraries or frameworks for a specific feature development.

02Recording database schema choices or infrastructure changes to ensure future maintainability by human or AI teams.

03Documenting architectural patterns such as choosing between state management strategies or API protocols.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add me2resh/agent-decision-record decide

For use in Claude.ai and ChatGPT

Download Skill