What documentation framework does this skill require?

This skill is designed to work with the AI Software Architect framework and specifically analyzes files located in the .architecture/ directory.

Does this skill analyze my source code logic?

No, it focuses exclusively on the metadata and documentation within the architecture framework to report on the state of your decision-making records.

How does it determine the 'health status' of architecture?

It evaluates health based on the volume of ADRs, the frequency of recent reviews, and the activity levels of recalibration plans to categorize health from Excellent to Inactive.

Can I use this skill to create new ADRs?

No, this skill is dedicated to reporting and status analysis. To create new documents, you should use the 'create-adr' skill.

Architecture Status & Health

Name: Architecture Status & Health
Author: codenamev

bycodenamev

•

Learning & Documentation

Reports on the health and coverage of architectural documentation, including ADRs, reviews, and recalibration progress.

The Architecture Status skill provides a comprehensive overview of a project's architectural documentation state by auditing the AI Software Architect framework. It automatically analyzes Architectural Decision Records (ADRs), counts completed reviews, tracks recalibration progress, and identifies critical documentation gaps. This tool is essential for technical leads and architects to maintain documentation hygiene, ensure team alignment on key decisions, and receive actionable recommendations to improve the project's long-term architectural health.

Key Features

01Tracking of architectural recalibration plans and completion status

0242 GitHub stars

03Comprehensive health reporting for ADRs and architectural reviews

04Summarization of team membership and specialist expertise coverage

05Automatic detection of documentation gaps and coverage areas

06Actionable recommendations based on the current state of documentation

Use Cases

01Onboarding new developers by summarizing existing architectural decisions

02Performing a periodic architecture health check for mature codebases

03Identifying missing documentation before major releases or version updates

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add codenamev/ai-software-architect architecture-status

For use in Claude.ai and ChatGPT

Download Skill