architecture-status

What this skill does

# 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
```markdown
# 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