architecture-status

Aggregate ADR counts, reviews, and activity metrics into a Markdown status report.

74|11|Updated May 23, 2025

Search Tags:#project health #ADR count #activity log #architecture status #review summary #documentation health #AI architect

Ready to run

npx skills add https://github.com/codenamev/ai-software-architect --skill architecture-status

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: architecture-status
Source: https://github.com/codenamev/ai-software-architect/tree/main/.claude/skills/architecture-status
Command: npx skills add https://github.com/codenamev/ai-software-architect --skill architecture-status

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solves?

It's hard to keep track of the current state of architectural documentation, identify gaps, or gauge the overall health of your project's architecture. This Skill provides a quick, comprehensive summary of your ADRs, reviews, and team activity, highlighting areas that need attention.

Core Features & Use Cases

Documentation Overview: Summarizes the number of Architectural Decision Records (ADRs), reviews, and recalibration plans.
Activity Tracking: Shows recent architectural activities and overall documentation discipline.
Health Assessment: Provides a health status (Excellent, Good, Needs Attention, Inactive) with actionable recommendations to improve documentation.
Use Case: You're preparing for a stakeholder meeting and need to quickly understand the project's architectural maturity. You ask "What's our architecture status?" to get a concise report on documented decisions and review progress.

Quick Start

What's our architecture status?

Frequently Asked Questions about architecture-status

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

FAQPage Schema

How do I check my project's architecture documentation health?▼

Architecture documentation health is assessed by aggregating ADR counts, review progress, recalibration activity, and recent updates into a structured status report. Run the Skill to get a comprehensive overview with health status (Excellent, Good, Needs Attention, Inactive) and actionable recommendations.

What does an architecture status report include?▼

A status report summarizes your Architectural Decision Records (ADRs), reviews, and recalibration plans with totals, recent items, status breakdowns, coverage metrics, and last activity timestamp. It provides visibility into documented decisions and team activity across your repository.

How can I quickly assess ADR and review progress for stakeholders?▼

Query your architecture status to generate a concise Markdown report showing ADR counts, review summaries, and documentation discipline metrics. This gives stakeholders a snapshot of architectural maturity without diving into individual files.

What file structure does architecture status analyze?▼

The Skill reads framework setup and counts files in decisions/adrs, reviews, recalibration, and other designated directories. It generates a structured summary across these categories to measure documentation coverage and identify gaps in architectural records.

Can I use architecture status to identify documentation gaps?▼

Yes. The Skill highlights areas needing attention through health assessment and coverage metrics, surfacing missing ADRs, incomplete reviews, or stale recalibration progress so you can prioritize documentation work.