architecture

Generate ADRs in MADR format, an arc42 draft, and plan-context.md.

37|6|Updated Nov 2, 2025
One-click install
npx skills add https://github.com/pssah4/digital-innovation-agents --skill architecture-pssah4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/pssah4/digital-innovation-agents/tree/main/skills/architecture
Command: npx skills add https://github.com/pssah4/digital-innovation-agents --skill architecture-pssah4

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architects and developers require a structured method to capture architectural decisions and handoff context.

Core Features & Use Cases

  • Generate Architecture Decision Records (ADRs) in MADR format and arc42 documentation.
  • Produce plan-context.md that bridges architectural decisions to Claude Code-driven implementation.
  • Maintain traceability between Epics, Features, ADRs, and the codebase to inform design choices.

Quick Start

Provide an initial architectural prompt including relevant Epics/Features and triggering ASR to generate ADRs and a plan-context for Claude Code.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I generate Architecture Decision Records for Claude Code?

You generate Architecture Decision Records (ADRs) in MADR format by providing an initial architectural prompt with relevant Epics and Features, which triggers the skill to produce the ADRs and a plan-context.md file for Claude Code.

What is the best way to document architectural decisions and traceability?

Documenting architectural decisions and traceability is best handled by generating ADRs in MADR format and arc42 drafts, which explicitly maintain traceability between Epics, Features, ADRs, and the codebase to inform design choices.

How do I create a plan-context.md that bridges requirements to technical designs?

To create a plan-context.md bridging requirements to technical designs, you provide an initial architectural prompt including relevant Epics and Features, which outputs the file to tie requirements to Claude Code-driven implementation.

Does the architecture skill enforce metadata in ADRs and arc42 documents?

Yes, the architecture skill enforces frontmatter metadata in its outputs, ensuring that the generated ADRs in MADR format and arc42 documentation maintain structured context and traceability for implementation.

Can I use arc42 and MADR formats together for software architecture documentation?

Yes, you can use arc42 and MADR formats together by providing an architectural prompt, which generates both an arc42 draft and Architecture Decision Records to capture decisions and handoff context.

When do I need to generate a plan-context for Claude Code?

You need to generate a plan-context for Claude Code when you require a structured method to capture architectural decisions and hand off context from your requirements and technical designs to the implementation phase.