1:# Design Subagent Instructions (Opus)
2:
3:You will receive a domain and site directory from the orchestrator. Design ONLY that site.
4:
5:---
6:
7:## Your Task
8:Write a unique, creative DESIGN.md for the given domain in the given site directory.
9:
10:---
11:
12:## Rules (MUST FOLLOW)
13:
14:1. **NO cat/HEREDOC** - Use ONLY Write tool for files
15:2. **Direct Execution** - Run `tools/script.sh`, NOT `bash tools/script.sh` (scripts have shebangs)
16:3. **NO mkdir** - Directory already exists
17:4. **NO ad-hoc scripts** - Do NOT write or execute custom shell/Python scripts. Use ONLY existing scripts in `tools/`
18:5. **NO placeholders** - Write complete content
19:6. **NO reports** - Just do the work, don't summarize
20:7. **Relative paths only** - Use `tools/...`, `sites/...`. **NEVER use `cd` or absolute paths.**
21:8. **NO /tmp** - Use `${TMP}` from `.wdmaker/config.toml` for temp files
22:9. **Preserve reports** - Do NOT delete files in `.smbatcher/`, `${TMP}/`
23:10. **Ignore accessibility/performance** - Focus on visual aesthetics and creativity only
24:11. **Maximum effort** - Ignore token budget, prioritize quality over efficiency
25:
26:---
27:
28:## Steps
29:
30:### Step 1: Mark Design Start
31:```bash
32:tools/design/start.sh <domain> --root .
33:```
34:**Execute only this script in this step. Never try other method to mark.**
35:
36:### Step 2: Read Existing Designs (Reference)
37:```bash
38:# Pick 1-2 completed designs (status D/I/Q) to understand style
39:tools/design/read-design.sh sites/<other-domain-vX>/DESIGN.md
40:```
41:**Execute only this script in this step. Never try other method to read.**
42:
43:### Step 3: Check Pattern Frequency
44:```bash
45:tools/design/frequency.sh --root .
46:```
47:**Execute only this script in this step. Never try other method to check frequency of pattern.**
48:Note overused patterns (AVOID) and underused patterns (PREFER).
49:
50:### Step 4: Confirm Planned Seed
51:Read file: `tools/design/seeds.json` to understand the style vocabulary.
52:
53:**Use the Planned Seed provided in your assignment instructions.**
54:If no seed was provided (fallback only), choose a seed from `seeds.json` that is not used in other designs.
55:
56:### Step 5: Write DESIGN.md
57:At first, read `<site_dir>/DESIGN.md` with **Read tool**.
58:Next, use only **Write tool** or filesystem MCP to create `<site_dir>/DESIGN.md` with ALL sections below:
59:
60:```markdown
61:# Design Language for <domain>
62:
63:## Aesthetics and Tone
64:[Visual direction, mood, inspiration - be specific and unique]
65:
66:## Layout Motifs and Structure
67:[Grid system, composition, spatial relationships - avoid generic layouts]
68:
69:## Typography and Palette
70:[Font choices with names, hex color values - minimum 3 colors]
71:
72:## Imagery and Motifs
73:[Visual elements, icons, decorative patterns - be creative]
74:
75:## Prompts for Implementation
76:[Specific guidance for HTML/CSS/JS - emphasize storytelling and animation]
77:[Bias toward full-screen narrative experiences]
78:[AVOID: CTA-heavy layouts, pricing blocks, stat-grids]
79:
80:## Uniqueness Notes
81:[List 3+ differentiators from other designs]
82:[Document chosen seed/style: <planned-seed-from-assignment>]
83:[Reference avoided patterns from frequency analysis]
84:```
85:
86:**Content Requirements:**
87:- Be SPECIFIC, not generic
88:- Include actual hex colors (e.g., #1a1a2e, #16213e)
89:- Name specific fonts (e.g., "Space Grotesk", "Cormorant Garamond")
90:  - **CRITICAL:** Use ONLY fonts available on Google Fonts. Do NOT invent font names.
91:- Emphasize storytelling and immersive experiences
92:- List 3+ unique differentiators
93:
94:### Step 6: Validate
95:```bash
96:tools/design/check-design.sh <site_dir>/DESIGN.md
97:```
98:**Execute only this script in this step. Never try other method to validate.**
99:Must return OK. If fails, fix issues and re-validate.
100:
101:### Step 7: Stamp
102:```bash
103:tools/design/write-design.sh <site_dir>/DESIGN.md --auto
104:```
105:**Execute only this script in this step. Never try other method to stamp.**
106:
107:### Step 8: Mark Complete
108:```bash
109:tools/design/complete.sh <domain> --root .
110:```
111:**Execute only this script in this step. Never try other method to mark.**
112:
113:---
114:
115:## Exit Criteria
116:- DESIGN.md exists with all 6 sections
117:- check-design.sh returns OK
118:- Status updated to D in registry
119:
120:---
121:
122:## Scripts Reference
123:
124:| Script | Purpose |
125:|--------|---------|
126:| `tools/design/start.sh <domain> --root .` | Mark design start (→d status) |
127:| `tools/design/complete.sh <domain> --root .` | Mark design complete (→D status) |
128:| `tools/design/check-design.sh <path>` | Validate DESIGN.md structure |
129:| `tools/design/write-design.sh <path> --auto` | Stamp with uniqueness metadata |
130:| `tools/design/read-design.sh <path>` | Read existing design for reference |
131:| `tools/design/frequency.sh --root .` | Check overused/underused patterns |
132:
133:---
134:
135:## DO NOT
136:- Design multiple sites
137:- Create directories
138:- Use HEREDOC/cat for files
139:- Write placeholder content
140:- Skip any required section
141:- Report results back (just complete the work)