architecture-doc-auditor

Audit architecture documentation against a 188-item viewpoint-based checklist.

2|1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/Agentient/vibekit --skill architecture-doc-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-doc-auditor
Source: https://github.com/Agentient/vibekit/tree/main/plugins/evaluation-tools/skills/architecture-doc-auditor
Command: npx skills add https://github.com/Agentient/vibekit --skill architecture-doc-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Systematic completeness auditing of architecture documentation using an 188-item viewpoint-based checklist, with severity-classified gaps, technical debt indicators, and anti-pattern scanning to support governance.

Core Features & Use Cases

  • Viewpoint-driven gap analysis across TOGAF, C4, arc42, and IEEE 42010 frameworks.
  • Health scoring and debt indicators to guide remediation and governance reviews.
  • GAP-INVENTORY artifact generation plus executive summaries for stakeholder reporting.

Quick Start

Run architecture-doc-auditor against a target architecture document to generate a GAP-INVENTORY and Architecture Health Report with remediation guidance.

Frequently Asked Questions about architecture-doc-auditor

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

FAQPage Schema
How do I audit architecture documentation for completeness gaps?

Auditing architecture documentation involves checking it against an 188-item viewpoint-based checklist to identify severity-classified gaps, generate a GAP-INVENTORY artifact, and calculate an Architecture Health Score.

Does the architecture auditor work with TOGAF, C4, arc42, and IEEE 42010 frameworks?

Yes, architecture auditing applies viewpoint-driven gap analysis across TOGAF, C4, arc42, and IEEE 42010 frameworks, covering contexts from system design to deployment and architectural decisions.

What is an Architecture Health Score and how is it calculated?

An Architecture Health Score is a governance metric generated by evaluating documentation against a 188-item checklist, identifying technical debt indicators and anti-patterns to guide remediation efforts.

How do I generate a technical debt remediation roadmap for architecture documentation?

Generating a remediation roadmap involves scanning documentation for anti-patterns and debt indicators, then producing an optional debt remediation roadmap alongside the GAP-INVENTORY and executive summary.

Can I use this to produce executive summaries for architecture governance reviews?

Yes, auditing produces executive summaries for stakeholder reporting by translating the 188-item viewpoint-based checklist results into actionable GAP-INVENTORY artifacts and health scores.

What are the limitations of using a checklist-based approach for architecture documentation auditing?

Checklist-based auditing is limited to the 188 predefined viewpoints across TOGAF, C4, arc42, and IEEE 42010, meaning it focuses on structural completeness and debt indicators rather than subjective design quality.