skills.rest
jrjsmrtn
jrjsmrtnCOMMUNITY
Explore all skills by this author →
GitHub

setup-adrs

Automate creation of foundational Architecture Decision Records for software projects.

12|Updated Dec 26, 2025
Search Tags:#software documentation#decision-making#project architecture#architecture decision records#ADR automation
One-click install
npx skills add https://github.com/jrjsmrtn/project-orchestration-skills --skill setup-adrs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-adrs
Source: https://github.com/jrjsmrtn/project-orchestration-skills/tree/main/skills/setup-adrs
Command: npx skills add https://github.com/jrjsmrtn/project-orchestration-skills --skill setup-adrs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps create and document foundational Architecture Decision Records (ADRs) for a new project, ensuring a systematic approach to decision-making and documentation.

Core Features & Use Cases

  • Foundational ADR Creation: Automates the creation of essential ADRs like 'How to Decide', 'How to Develop', 'What Tech', and 'How to Operate'.
  • Customization: Allows customization of ADRs based on project type and technology stack.
  • Documentation: Generates ADR documentation following a structured format for clarity and maintainability.

Quick Start

Run the setup-adrs skill to generate foundational ADRs for your project.

Frequently Asked Questions about setup-adrs

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

FAQPage Schema
How do I create foundational Architecture Decision Records for a new project?▼

Creating foundational Architecture Decision Records involves automating the generation of essential ADRs like 'How to Decide' and 'What Tech' to establish systematic project architecture documentation from inception.

What is the best way to document project architecture decisions systematically?▼

Documenting project architecture decisions systematically requires generating structured Architecture Decision Records that outline significant technical choices, ensuring clarity and maintainability across the software project lifecycle.

Can I customize Architecture Decision Records for different technology stacks?▼

Yes, you can customize Architecture Decision Records based on your specific project type and technology stack, allowing the generated documentation to accurately reflect your unique software architecture decisions.

When do I need to set up ADRs in software development?▼

You need to set up ADRs during new project inception, when establishing decision documentation practices, or standardizing ADR procedures to ensure significant architectural choices are formally recorded.

What format should automated Architecture Decision Records follow?▼

Automated Architecture Decision Records should follow a structured format to ensure clarity and maintainability, providing a consistent template for documenting significant architectural decisions across the project.

Related Skills

Explore More Software Engineering Skills→
timequitytimequity
6

decision-logger

Log architectural decisions as ADR entries to docs/DECISIONS.md.

Official
Intermediate
ccfccf

architecture-decision-records

Document architectural decisions with a MADR-style template and lifecycle.

Community
Advanced
jieni777jieni777
1

adr-writer

Generate standardized Architecture Decision Records from natural-language decisions.

Community
Intermediate
adolfoaranaes12adolfoaranaes12
2

create-adr

Create Architecture Decision Records with context, alternatives, rationale, and consequences.

Community
Advanced