list-members
List Architecture Members
Displays all architecture team members and their expertise areas.
Process
1. Check Setup
If .architecture/members.yml doesn't exist:
The AI Software Architect framework hasn't been set up yet.
To get started: "Setup ai-software-architect"
2. Load Members
Read .architecture/members.yml and parse all members (id, name, title, specialties, disciplines, skillsets, domains, perspective).
3. Display Team Roster
# Architecture Team Members
Your AI Software Architect team consists of [count] specialized reviewers.
Total Members: [count]
---
## Team Roster
### [Member 1 Name] - [Member 1 Title]
**ID**: `[member_id]`
**Specialties**: [Specialty 1], [Specialty 2], [Specialty 3]
**Disciplines**: [Discipline 1], [Discipline 2]
**Domains**: [Domain 1], [Domain 2], [Domain 3]
**Perspective**: [Their unique perspective]
**Request review**: `Ask [Member Title] to review [your target]`
---
[Repeat for all members]
---
## Quick Reference
**Specialist reviews**:
- `Ask [Specialist Title] to review [target]`
**Examples**:
- "Ask Security Specialist to review authentication"
- "Ask Performance Specialist to review database queries"
- "Ask [Your Specialist] to review [anything]"
**Full architecture review**:
- `Start architecture review for version X.Y.Z`
**Other commands**:
- `Create ADR for [decision topic]`
- `What's our architecture status?`
---
## Team by Specialty
[Group members by their primary domains/specialties]
**Security & Compliance**: [Members]
**Performance & Scalability**: [Members]
**Code Quality & Maintainability**: [Members]
**Domain & Business Logic**: [Members]
**System Design & Architecture**: [Members]
**Technology-Specific**: [Members]
---
## Adding New Members
Request a review from any specialist, even if they don't exist:
- "Ask Ruby Expert to review my modules"
- "Have Accessibility Expert review forms"
I'll create the specialist and add them to your team automatically.
Or manually edit `.architecture/members.yml` and add:
```yaml
- id: your_specialist_id
name: "[Name]"
title: "[Title]"
specialties: ["[Specialty 1]", "[Specialty 2]"]
disciplines: ["[Discipline 1]", "[Discipline 2]"]
skillsets: ["[Skill 1]", "[Skill 2]"]
domains: ["[Domain 1]", "[Domain 2]"]
perspective: "[Brief description]"
Using the Team
For focused reviews (specific expertise):
Ask [Specialist] to review [target]
Fast turnaround, targeted insights
For comprehensive reviews (all perspectives):
Start architecture review for [version/feature]
All members review, collaborative discussion
For decisions:
Create ADR for [decision topic]
Document decisions with team input
### 4. Provide Context
After listing:
- Explain when to use specialist vs full reviews
- Show how to add new members dynamically
- Provide usage examples
- Suggest next steps
## Example Output Summary
After showing full roster, provide a concise summary:
Ready to use your architecture team:
- [N] specialists available
- Request reviews: "Ask [specialist] to review [target]"
- Add new specialists: Just ask for them by name
- Full review: "Start architecture review for [scope]"
## Error Handling
- No `.architecture/`: Offer setup instructions
- Empty `members.yml`: Show default team and offer setup
- Malformed YAML: Show what's parseable, note issues
## Related Skills
**After Listing Members**:
- "Ask [specialist] to review [target]" - Request focused expert review
- "Start architecture review for [scope]" - Comprehensive review with all members
- "What's our architecture status?" - See how team has been used
**When Adding Members**:
- Just request a specialist that doesn't exist - they'll be created automatically
- "Setup ai-software-architect" - Adds members based on your tech stack
**Workflow Examples**:
1. List members → Identify relevant specialist → Request review
2. Need new expertise → Request it → Specialist auto-created → List to verify
3. Status check → List members → Review with specific specialists
## Notes
- Keep presentation clear and scannable
- Make it actionable with specific commands
- Encourage exploration and usage
- Explain that team can grow dynamically
More from codenamev/ai-software-architect
architecture-review
Conducts a comprehensive multi-perspective architecture review using ALL architecture team members. Use when the user requests "Start architecture review", "Full architecture review", "Review architecture for version X.Y.Z", "Conduct comprehensive review", or when they want assessment from multiple perspectives. Do NOT use for single-specialist reviews (use specialist-review instead) or for status checks (use architecture-status instead).
11create-adr
Creates a NEW Architectural Decision Record (ADR) documenting a specific architectural decision. Use when the user requests "Create ADR for [topic]", "Document decision about [topic]", "Write ADR for [choice]", or when documenting technology choices, patterns, or architectural approaches. Do NOT use for reviews (use architecture-review or specialist-review), checking existing ADRs (use architecture-status), or general documentation.
5pragmatic-guard
Enables and configures Pragmatic Guard Mode (YAGNI Enforcement) to prevent over-engineering. Use when the user requests "Enable pragmatic mode", "Turn on YAGNI enforcement", "Activate simplicity guard", "Challenge complexity", or similar phrases.
4setup-architect
Sets up and installs the AI Software Architect framework in a NEW project for the FIRST time. Use when the user requests "Setup .architecture", "Setup ai-software-architect", "Initialize architecture framework", "Install software architect", or similar setup/installation phrases. Do NOT use for checking status (use architecture-status), creating documents (use create-adr or reviews), or when framework is already set up.
4specialist-review
Conducts a focused review from ONE specific specialist's perspective (e.g., Security Specialist, Performance Expert). Use when the user requests "Ask [specialist role] to review [target]", "Get [specialist]'s opinion on [topic]", "Have [role] review [code/component]", or when they want deep expertise in ONE specific domain. Do NOT use for comprehensive multi-perspective reviews (use architecture-review instead) or for listing available specialists (use list-members instead).
4architecture-status
Reports on the health and state of architecture documentation (counts of ADRs, reviews, activity levels, documentation gaps). Use when the user asks "What's our architecture status?", "Show architecture documentation", "How many ADRs do we have?", "What decisions are documented?", "Architecture health check", or wants an overview/summary of documentation state. Do NOT use for listing team members (use list-members), creating new documents (use create-adr), or conducting reviews (use architecture-review or specialist-review).
4