arc42-review

Audit arc42 documentation for accuracy, completeness, and cross-section consistency.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

arc42 documentation often suffers from inconsistencies and gaps that undermine reliability. This skill provides automated, detail-level-aware checks to enforce accuracy, completeness, and cross-section alignment, and it surfaces findings with severity-linked fixes.

Core Features & Use Cases

  • Automated, detail-level-aware reviews for LEAN, ESSENTIAL, and THOROUGH sections
  • Structured findings report with severity-linked fixes and ADR suggestions
  • Guidance to resolve issues using the relevant arc42 section skills

Quick Start

Ask the user to specify the review scope and path to the arc42 documentation, then start the arc42-review workflow.

Frequently Asked Questions about arc42-review

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

FAQPage Schema
How do I check arc42 documentation for cross-section consistency and gaps?

To check arc42 documentation for cross-section consistency, you can run an automated review that audits accuracy and completeness against arc42 standards. It identifies gaps relative to LEAN, ESSENTIAL, or THOROUGH levels and generates a structured findings report.

What is the best way to enforce quality and completeness in arc42 docs?

The best way to enforce quality in arc42 docs is using detail-level-aware checks that scan for inconsistencies and missing sections. This process surfaces findings with severity-linked fixes and provides actionable ADR suggestions to resolve identified gaps.

Can I automatically generate ADRs from arc42 documentation review findings?

Yes, you can generate actionable ADRs from arc42 documentation review findings. When the audit detects inconsistencies or missing details, it offers immediate resolution via relevant section skills and suggests Architecture Decision Records to address the gaps.

Does the arc42 review process support different documentation levels like LEAN or THOROUGH?

Yes, the arc42 review process supports LEAN, ESSENTIAL, and THOROUGH documentation levels. It applies detail-level-aware checks to identify gaps relative to the specified depth, ensuring the audit matches your project's required documentation standard.

How do I start an end-to-end quality review for my arc42 architecture documentation?

To start an end-to-end quality review, specify the review scope and provide the path to your arc42 documentation. The workflow then audits the files for accuracy, alignment, and completeness, producing a structured findings report with severity-linked fixes.