skills.rest
codenamev
codenamevCOMMUNITY
Explore all skills by this author →
Website𝕏@thecodenamevGitHub

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
One-click install
npx skills add https://github.com/codenamev/ai-software-architect --skill architecture-status
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
jeremyaryjeremyary
7

adr

Create structured Markdown Architecture Decision Records in the plans/adr/ directory.

Community
Intermediate
zhongadamwangzhongadamwang

project-status-reporting

Generate standardized project status reports and executive dashboards from project documentation.

Community
Basic
rvdbreemenrvdbreemen
4

supersede

Supersede Architecture Decision Records with dependency graphs and user approval.

Community
Advanced
chavangorakh1999chavangorakh1999
1

adr

Generate Architecture Decision Records with context, decision, consequences, and alternatives.

Community
Intermediate