| name | design-system |
| description | Guided, section-by-section design document authoring for a specific building system. Gathers context from existing docs, walks through each required section collaboratively, and writes incrementally to file. |
| argument-hint | <system-name> (e.g., 'hvac-system', 'structural-frame', 'building-envelope') |
| user-invocable | true |
| allowed-tools | Read, Glob, Grep, Write, Edit, Task, AskUserQuestion |
1. Parse Arguments & Validate
A system name argument is required. If missing, fail with usage message.
Normalize to kebab-case for filename.
2. Gather Context
- Read
design/architectural/project-brief.md — fail if missing
- Read
design/architectural/systems-index.md — fail if missing
- Find system in index, read dependency GDDs if they exist
- Read
.claude/docs/technical-preferences.md for project configuration
3. Create File Skeleton
Create the design document with empty section headers using the 8 required sections:
# [System Name]
> **Status**: In Design
> **Author**: [user + agents]
> **Last Updated**: [today's date]
## Overview
[To be designed]
## Design Intent
[To be designed]
## Technical Requirements
[To be designed]
## Calculations
[To be designed]
## Code Compliance
[To be designed]
## Coordination Notes
[To be designed]
## Material Specifications
[To be designed]
## Acceptance Criteria
[To be designed]
4. Section-by-Section Design
Walk through each section following:
Context → Questions → Options → Decision → Draft → Approval → Write
Write each section to file immediately after approval.
Update production/session-state/active.md after each section.
5. Post-Design Validation
- Verify all 8 sections have real content
- Offer
/design-review to validate
- Update systems index status
- Suggest next steps
Specialist Agent Routing
| System Category | Primary Agent | Supporting Agent(s) |
|---|
| Structural frame, foundations | structural-engineer-lead | foundation-engineer, concrete-specialist |
| HVAC, ventilation | hvac-engineer | energy-modeler, mep-director |
| Electrical, lighting | electrical-engineer | energy-modeler |
| Plumbing, drainage | plumbing-engineer | mep-director |
| Fire protection | fire-protection-engineer | safety-manager |
| Building envelope | facade-engineer | energy-modeler, materials-specialist |
| Interior spaces | interior-design-lead | space-planner, materials-specialist |
| Site/landscape | landscape-architect | geotechnical-engineer |
