skills.rest
askferret
askferretCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

architecture

Generate MADR-format ADRs, arc42 documentation, and plan-context.md files.

Updated Jun 3, 2026
Search Tags:#architecture#tech stack#adr#decision-making#arc42
One-click install
npx skills add https://github.com/askferret/automatic-waffle --skill architecture-askferret
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/askferret/automatic-waffle/tree/main/skills/architecture
Command: npx skills add https://github.com/askferret/automatic-waffle --skill architecture-askferret

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, tools, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill simplifies the process of creating architecture decision records (ADRs), arc42 documentation, and providing technical context for Claude Code, making architecture work more efficient and organized.

Core Features & Use Cases

  • Architecture Decision Records (ADRs): Automatically generate ADRs in MADR format and arc42 documentation for technical structuring and decision-making.
  • Contextual Information: Provides context bridge to Claude Code with plan-context.md.
  • Use Case: When a developer mentions architecture, ADRs, or arc42, and there are existing requirements to be structured.

Quick Start

Run the 'architecture' skill with the current branch and active item to create an ADR and arc42 documentation.

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 in MADR format automatically?▼

To generate Architecture Decision Records in MADR format, run the architecture skill with your current branch and active item. It automates ADR creation and integrates with GitHub for tracking, streamlining technical decision-making processes.

What is arc42 documentation and how does it structure technical architecture?▼

Arc42 documentation is a structured template for capturing technical architecture and design decisions. This skill automates arc42 creation alongside MADR-formatted ADRs, making architecture work more efficient and organized within software development workflows.

Do I need python3 to create ADRs and arc42 documentation?▼

Yes, python3 is required to create ADRs and arc42 documentation. The architecture skill depends on python3 tools and templates to automate the generation of architecture decision records and contextual documentation.

How do I provide technical architecture context to Claude Code?▼

You provide technical architecture context to Claude Code by generating a plan-context.md file. The architecture skill creates this context bridge automatically, ensuring Claude Code has the necessary technical background for your software development workflow.

Does the architecture skill work with GitHub for tracking decisions?▼

Yes, the architecture skill works with GitHub for tracking decisions. It utilizes GitHub integration to monitor architecture decision records and arc42 documentation throughout your software development lifecycle.

When should I use automated ADR generation instead of manual documentation?▼

Use automated ADR generation when you have existing requirements that need structuring into technical architecture decisions. It streamlines MADR and arc42 documentation creation, replacing manual effort when developers mention architecture or design decisions in workflows.

Related Skills

Explore More Software Engineering Skills→
zot24zot24
2

error-tracker-install

Install and configure gh-issue-tracker to report errors as GitHub Issues.

Community
Intermediate
olivermorgan2olivermorgan2

workflow-docs

Generate and synchronize README and AI-summary files from PRD, MVP, ADR, and CLAUDE.md artifacts.

Community
Intermediate
nnexainnexai
1

gsd-ultraplan-phase

Offload GSD workflow planning to Claude Code ultraplan cloud infrastructure.

Community
Advanced
a53alia53ali

architecture-decision-record

Write, update, and query Architecture Decision Records using Markdown templates.

Community
Intermediate