design-system

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