skills.rest
sddevelopment-be
sddevelopment-beOFFICIAL
Explore all skills by this author →
WebsiteGitHub

Decision-First Development Workflow

Capture architectural decisions and rationale in traceable ADR-aligned workflows.

13|3|Updated Nov 15, 2025
Search Tags:#architecture#adr#governance#traceability#developers#decision-first
One-click install
npx skills add https://github.com/sddevelopment-be/quickstart_agent-augmented-development --skill decision-first-development-workflow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Decision-First Development Workflow
Source: https://github.com/sddevelopment-be/quickstart_agent-augmented-development/tree/main/.claude/skills/decision-first-development
Command: npx skills add https://github.com/sddevelopment-be/quickstart_agent-augmented-development --skill decision-first-development-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematizes architectural decisions and rationale, ensuring knowledge preservation and auditability across the development lifecycle.

Core Features & Use Cases

  • ADR-aligned decision capture: Create and link decisions to architectural patterns and directives.
  • Traceability & governance: Maintain rationale, alternatives considered, and trade-offs for future contributors and AI agents.
  • Use Case: When evaluating architectural options (e.g., monolith vs microservices), record the decision context and linked ADRs for ongoing reference.

Quick Start

Create an ADR-style decision record for a current architectural choice and link it to related directives.

Frequently Asked Questions about Decision-First Development Workflow

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

FAQPage Schema
How do I document architectural decisions and rationale for future contributors?▼

You can document architectural decisions using an ADR-aligned workflow that records context, trade-offs, and alternatives considered, ensuring traceability and knowledge preservation across the software development lifecycle.

What is the best way to link architectural directives and tactics to ADRs?▼

Linking architectural directives to ADRs is best handled by capturing decisions in a traceable workflow that connects records to patterns and tactics, enabling governance and ongoing reference as decisions evolve.

Can I use ADRs to evaluate architectural options like monolith versus microservices?▼

Yes, you can use ADR-style decision records to evaluate architectural options by capturing the decision context, alternatives, and trade-offs, maintaining organized documentation for ongoing reference.

How do AI agents interact with captured architectural decision records?▼

AI agents interact with captured architectural decisions through an AI-assisted collaboration workflow that maintains rationale and traceability, enabling them to access and process recorded architectural context and governance data.

When do I need to apply a decision-first development workflow for software governance?▼

A decision-first development workflow is needed during software design, implementation, and governance phases when you must systematize architectural decisions, ensure auditability, and preserve decision rationale for future contributors.

Related Skills

Explore More Software Engineering Skills→
Remaker-DigitalRemaker-Digital
2

kb-adr

Create architecture decision records with ADR-* IDs in the Knowledge Database.

Official
Intermediate
AgentSecOpsAgentSecOps
183

api-spectral

Lint OpenAPI/AsyncAPI definitions with Spectral to enforce security and governance rules.

Official
Advanced
TheBushidoCollectiveTheBushidoCollective
187

documentation-linking

Establish bidirectional links between code and documentation with multiple link formats.

Official
Basic
senior-sigansenior-sigan

architecture-decision-records

Capture architectural decisions as structured ADR documents with context and rationale.

Community
Advanced