decisions

Name: decisions
Availability: InStock
Author: recyclarr

Create and edit Architecture Decision Records and Product Decision Records with standardized templates.

2.1k|36|Updated Feb 4, 2021

Search Tags:#architecture #decision making #documentation #product management #adr #pdr

Ready to run

npx skills add https://github.com/recyclarr/recyclarr --skill decisions-recyclarr

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: decisions
Source: https://github.com/recyclarr/recyclarr/tree/main/.opencode/skills/decisions
Command: npx skills add https://github.com/recyclarr/recyclarr --skill decisions-recyclarr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured framework for documenting critical architecture and product decisions, ensuring clarity, traceability, and maintainability of project evolution.

Core Features & Use Cases

Standardized Decision Records: Facilitates the creation of Architecture Decision Records (ADRs) and Product Decision Records (PDRs) using predefined templates.
Clear Decision Tracking: Enforces naming conventions, date accuracy, and status tracking (proposed, accepted, deprecated, superseded by) for each decision.
Use Case: When deciding on a new database technology for a project, use this Skill to create an ADR that outlines the options considered, the rationale for the chosen technology, and its long-term implications.

Quick Start

Use the decisions skill to create a new ADR using the template located at docs/decisions/architecture/TEMPLATE.md.

Frequently Asked Questions about decisions

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

FAQPage Schema

What is the best way to document architecture and product decisions for traceability?▼

Architecture Decision Records (ADRs) and Product Decision Records (PDRs) provide a structured framework for documenting critical architecture and product decisions, ensuring clarity, traceability, and maintainability of project evolution through standardized formats.

How do I create an Architecture Decision Record using a standardized template?▼

You create an Architecture Decision Record (ADR) by using a predefined template to outline options considered, rationale for the chosen technology, and long-term implications, enforcing standardized formats, naming conventions, and reference-style linking for procedural knowledge.

Can I track the status of product decisions as they change over time?▼

You can track the status of product decisions by enforcing status tracking with states like proposed, accepted, deprecated, and superseded by for each Product Decision Record (PDR), maintaining accurate procedural knowledge and implementation choices throughout the lifecycle.

Do I need a specific documentation system to manage decision records?▼

Managing decision records requires a documentation system that supports adherence to template guidelines and reference-style linking, enforcing standardized formats, naming conventions, and date accuracy for procedural knowledge and implementation choices.

When do I need to write an Architecture Decision Record instead of general documentation?▼

You need an Architecture Decision Record (ADR) when deciding on critical implementation choices like a new database technology, using standardized formats to outline options considered, rationale, and long-term implications to ensure clarity and traceability.