arch-arc42-architect

Draft arc42 architecture documents with embedded REQ sections and traceable decisions.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill arch-arc42-architect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-arc42-architect
Source: https://github.com/FernanSuoza/AIDD-project-bootstrap/tree/main/templates/skills/arch-arc42-architect
Command: npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill arch-arc42-architect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Arc42-based architecture documentation often suffers from inconsistent structure and missing embedded requirements. This skill provides a structured template and workflow to draft or update architecture docs with embedded REQ-* sections, guidance for views, and traceable decisions.

Core Features & Use Cases

  • Arc42-aligned architecture documentation that includes context, goals, and views.
  • Support for embedding REQ-* sections directly into architecture sections to ensure traceability and validation against product requirements.
  • Guidance to create and link ADRs, guidelines, and architecture templates, plus generation of related diagrams.

Quick Start

Invoke this skill with an approved product brief and system scope to generate an arc42-compliant architecture document.

Frequently Asked Questions about arch-arc42-architect

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

FAQPage Schema
How do I draft arc42 architecture documentation with embedded requirements?

To draft arc42 architecture documentation with embedded requirements, use a structured workflow that embeds REQ-* sections directly into architecture views and constraints. This ensures traceability from product requirements to ADRs and quality scenarios.

What is the best way to ensure traceability from architecture decisions to product requirements?

The best way to ensure traceability is embedding REQ-* sections directly into arc42 architecture documents. This links product requirements to specific ADRs, diagrams, and quality scenarios within a governance-ready review packet.

How do I generate a governance-ready review packet for system architecture docs?

Generate a governance-ready review packet by drafting an arc42-style architecture document with embedded REQ sections, runtime views, and quality attributes. This packet links existing ADRs and guidelines to ensure validation against product requirements.

Can I link existing ADRs and product briefs into arc42 architecture views?

Yes, you can link existing ADRs and product briefs into arc42 architecture views. The documentation process connects these artifacts to context, building blocks, and cross-cutting concepts while maintaining requirement traceability.

Do I need an approved product brief to start drafting arc42 architecture documents?

Yes, you need an approved product brief and defined system scope to start drafting. Invoking the arc42 documentation workflow with these inputs generates a compliant architecture document with embedded requirements and linked ADRs.

What sections are required for arc42-compliant architecture documentation?

Required sections for arc42-compliant architecture documentation include context, building blocks, runtime, deployment, and cross-cutting concepts. These sections embed REQ-* sections, quality attributes, and constraints to ensure full requirement traceability.