Architecture Decision Record Creator FAQs

Question 1

What happens if my specification doesn't list alternative solutions?

Accepted Answer

The skill will automatically research and identify reasonable alternatives, documenting their pros and cons and providing standard reasons for their rejection relative to your project's constraints.

Question 2

What is the MADR format used by this skill?

Accepted Answer

MADR (Markdown Any Decision Record) is a lean, structured template for documenting architectural decisions in Markdown, focusing on context, decision, and consequences.

Question 3

How does the skill handle ADR numbering?

Accepted Answer

It automatically assigns the next sequential number based on your existing ADR index, or you can manually assign a specific number using the --number flag.

Question 4

Why should I use this skill instead of writing ADRs manually?

Accepted Answer

This skill ensures consistency in documentation, saves time by extracting details directly from your specs, and provides comprehensive research on consequences and alternatives that might otherwise be overlooked.

Question 5

Can I specify a custom output directory for my ADRs?

Accepted Answer

Yes, the skill supports an --output argument to save ADRs to any directory, though it defaults to docs/adr/ within your project.

Architecture Decision Record Creator

Key Features

Use Cases

Architecture Decision Record Creator

Key Features

Use Cases