architecture-status

Architecture Status

Provides overview of architecture documentation state.

Process

1. Check Framework Setup

If .architecture/ doesn't exist:

The AI Software Architect framework is not set up yet.

To get started: "Setup ai-software-architect"

Once set up, you'll have:
- Architectural Decision Records (ADRs)
- Architecture reviews
- Specialist reviews
- Recalibration tracking

2. Gather Information

Collect from .architecture/:

• ADRs: Count files in decisions/adrs/, note recent ones, check statuses
• Reviews: Count files in reviews/, categorize (version/feature/specialist/initial)
• Recalibration: Count files in recalibration/, check progress docs
• Comparisons: List files in comparisons/
• Team: Count members in members.yml
• Last Activity: Most recent date from any document

3. Generate Status Report

# Architecture Framework Status

**Report Date**: [Date]
**Project**: [Project name if known]

## Summary

**Health Status**: Excellent | Good | Needs Attention | Inactive

**Key Metrics**:
- ADRs: [count]
- Reviews: [count]
- Recalibration Plans: [count]
- Team Members: [count]
- Last Activity: [Date]

## Architectural Decision Records

**Total**: [count]

**Recent ADRs**:
1. ADR-[XXX]: [Title] ([Status], [Date])
2. ADR-[YYY]: [Title] ([Status], [Date])
[List 5-10 most recent]

**By Status**:
- ✅ Accepted: [count]
- 🔄 Proposed: [count]
- ⚠️ Deprecated: [count]
- 🔀 Superseded: [count]

**Coverage**: [Main areas covered: Data, Security, Infrastructure, etc.]

## Architecture Reviews

**Total**: [count]

**Version Reviews**: [List with dates]
**Feature Reviews**: [List with dates]
**Specialist Reviews**: [List with dates]

**Most Recent**: [Title] ([Date])

## Recalibration

**Total Documents**: [count]

**Active**:
1. [Target]: [Status], [Completion %]

**Status**:
- ✅ Completed: [count]
- 🔄 In Progress: [count]
- 📋 Planned: [count]

## Architecture Team

**Total Members**: [count]

**Team**: [List member titles]

**Coverage**: Security ([count]), Performance ([count]), System Design ([count]), etc.

**View full roster**: "List architecture members"

## Activity

**Recent**:
- [Date]: Created ADR-XXX: [Title]
- [Date]: Completed review for [target]
- [Date]: [Activity]

**Level**: High | Medium | Low | Inactive

## Documentation Health

**Completeness**: [X%]

**Strengths**:
- ✅ [What's well documented]

**Gaps**:
- ⚠️ [What needs attention]

**Recommendations**:
1. [Recommendation 1]
2. [Recommendation 2]

## Quick Actions

**Create**:
- "Create ADR for [decision]"
- "Start architecture review for [version/feature]"
- "Ask [specialist] to review [target]"

**View**:
- "List architecture members"
- [Specific docs to review based on status]

**Update**:
- [Actions based on current state]

---

4. Analyze Health

Health indicators:

• Excellent: Regular ADRs, recent reviews, active recalibration
• Good: Some ADRs, occasional reviews
• Needs Attention: Old docs, no recent activity
• Inactive: Framework unused

5. Provide Recommendations

Based on status:

If well-maintained:

✅ Excellent documentation discipline!

Keep momentum:
- Continue documenting decisions
- Regular reviews (quarterly/before releases)
- Track recalibration progress

If partially used:

⚠️ Good foundations, room for improvement.

Suggestions:
- Document 3-5 key decisions as ADRs
- Schedule architecture review
- Address review findings

If minimal usage:

❌ Framework underutilized.

Get started:
1. Document your most important decisions as ADRs
2. Conduct initial architecture review
3. Make documentation a regular habit

6. Make It Actionable

Always end with:

• Specific commands to run
• Concrete actions to improve
• Examples relevant to their status

Metrics to Track

Volume: Total ADRs, reviews, recalibration docs, team members Activity: Last update, docs per month, active vs completed Coverage: Decision areas, review types, specialist expertise Health: Documentation completeness, review frequency, progress tracking

Error Handling

• No .architecture/: Offer setup
• Permission issues: Report and suggest fixes
• Corrupted files: Note which have issues
• Empty directories: Suggest starting points

Related Skills

Based on Status Results:

If Documentation Gaps Found:

• "Create ADR for [missing decision]" - Fill documentation gaps
• "Start architecture review for [area]" - Comprehensive assessment
• "Ask [specialist] to review [weak area]" - Focused improvement

If Status is Good:

• "List architecture members" - See your active team
• Continue regular documentation practices
• Schedule periodic reviews

Regular Workflow:

1. Start work → "What's our architecture status?" → Identify gaps
2. Make changes → Document with ADRs → Status check to verify
3. Before release → Status check → Architecture review → Address findings

Workflow Examples:

1. Status check → Find 0 ADRs → Create ADRs for key decisions → Status check shows progress
2. Status check → See old reviews → Request new architecture review → Update status
3. Weekly: Status check → Track documentation health → Maintain good practices

Notes

• Be honest but encouraging
• Focus on actionable next steps
• Show value of maintained documentation
• Adapt tone to current state