dev10x-adr

Generate Architecture Decision Records with PlantUML diagrams and project conventions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/wooyek/dev10x-ai --skill dev10x-adr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev10x-adr
Source: https://github.com/wooyek/dev10x-ai/tree/main/codex-skills/dev10x-adr
Command: npx skills add https://github.com/wooyek/dev10x-ai --skill dev10x-adr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the creation and documentation of Architecture Decision Records (ADRs), ensuring significant architectural choices are clearly recorded, justified, and integrated into project history.

Core Features & Use Cases

  • ADR Generation: Creates ADRs following a defined project template, including context, decision, alternatives, and consequences.
  • Diagram Integration: Facilitates the creation and embedding of component architecture and sequence diagrams using PlantUML.
  • Workflow Integration: Seamlessly integrates with other dev10x skills for branching, committing, and PR creation.
  • Use Case: When proposing a new microservice architecture, use this skill to document the decision, the alternatives considered (e.g., monolithic vs. microservices), and the rationale behind the chosen approach, complete with architectural diagrams.

Quick Start

Use the dev10x-adr skill to create a new ADR for documenting the payment gateway integration.

Frequently Asked Questions about dev10x-adr

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

FAQPage Schema
How do I generate an Architecture Decision Record for a new microservice architecture?

To generate an Architecture Decision Record, this Skill applies ADR-specific formatting and numbering to document your microservice architecture, including context, alternatives, and consequences. It extends base scoping capabilities to record significant technology choices.

What is the best way to document architectural decisions and integration patterns?

Documenting architectural decisions is best handled by generating an ADR that captures integration patterns and technology choices. This Skill adheres to project conventions to clearly record the context and rationale behind significant architectural choices.

Can I create PlantUML diagrams for component architecture and sequence flows?

You can create PlantUML diagrams for component architecture and sequence flows directly within your ADR. The Skill facilitates embedding these visual representations to illustrate integration patterns and document architectural decisions.

How do I integrate architecture decision documentation with my branching and PR workflow?

To integrate architecture decision documentation with your workflow, this Skill seamlessly connects with other dev10x skills for branching, committing, and PR creation. This ensures ADRs are properly committed into project history.

When do I need to write an Architecture Decision Record?

You need to write an Architecture Decision Record when proposing significant architectural choices like a new payment gateway integration. It is specifically used to document the decision, alternatives considered, and the rationale behind the chosen approach.