arc42-section-12

Scan arc42 sections to generate an alphabetized glossary with definitions and aliases.

20|3|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/MSiccDev/arc42-toolkit --skill arc42-section-12
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arc42-section-12
Source: https://github.com/MSiccDev/arc42-toolkit/tree/main/skills/arc42-section-12
Command: npx skills add https://github.com/MSiccDev/arc42-toolkit --skill arc42-section-12

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Defines domain-specific and technical terms for arc42 Section 12 glossary ensuring precise, system-specific definitions and a consistent ubiquitous language across architecture documentation.

Core Features & Use Cases

  • Scans existing sections (Section 3, 4, 5, 8, 9) to surface glossary candidates such as external actors, architecture patterns, building blocks, domain entities, and ADR-related terms.
  • Organizes terms into clear categories: Domain Terms, Technical Terms and Abbreviations, and Ambiguous Terms (with optional translation/synonym data when applicable).
  • Generates a canonical glossary with alphabetized entries and explicit definitions to support cross-section consistency and future maintenance.

Quick Start

Describe terms and definitions by scanning related sections, then iteratively refine until every term is precise and consistent.

Frequently Asked Questions about arc42-section-12

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

FAQPage Schema
How do I create a glossary for architecture documentation that ensures consistent terminology?

To create a consistent architecture documentation glossary, scan existing sections to surface domain entities, technical terms, and acronyms, then compile them into an alphabetized list with explicit system-specific definitions and aliases.

What is the best way to identify ambiguous terms across building blocks and architecture patterns?

The best way to identify ambiguous terms across building blocks and architecture patterns is to scan documentation sections 3, 4, 5, 8, and 9 to surface candidates, then categorize them with optional synonyms and consistency notes.

How do I populate Section 12 with domain-specific definitions and external actors?

You populate Section 12 by extracting domain-specific definitions and external actors from earlier sections, organizing them into categories like Domain Terms and Abbreviations, and refining entries until every term is precise.

Does arc42 Section 12 require scanning ADR-related terms for ubiquitous language?

Yes, establishing a ubiquitous language in arc42 Section 12 requires scanning ADR-related terms from earlier sections to ensure all technical and domain vocabulary is captured with preferred terms and consistency notes.

What level of detail should architecture glossary entries have for cross-section consistency?

Architecture glossary entries should have a level of detail that includes system-specific definitions, preferred terms, aliases, and consistency notes, ensuring precise cross-section alignment and future maintenance.