Skip to content

Commit 28d4130

Browse files
jwaldripclaude
andcommitted
fix(plugin): add strict ASCII wireframe alignment rules to discovery skill
Box-drawing characters, fixed-width columns, padding rules, and verification step to prevent misaligned mockups during elaboration. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent e17f32b commit 28d4130

File tree

1 file changed

+29
-0
lines changed
  • plugin/skills/elaborate-discover

1 file changed

+29
-0
lines changed

plugin/skills/elaborate-discover/SKILL.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -175,13 +175,42 @@ Spawn one subagent per design file, in parallel with codebase Explore agents. Wh
175175

176176
Discovery mockups are always ASCII — they exist to facilitate discussion, not to serve as spec artifacts. Unit wireframes (Phase 6.25) handle the structured HTML spec.
177177

178+
#### ASCII Wireframe Rules
179+
180+
**Alignment is critical.** Misaligned ASCII wireframes are unreadable and useless for discussion. Follow these rules strictly:
181+
182+
1. **Use monospace box-drawing characters** — `┌ ┐ └ ┘ │ ─ ├ ┤ ┬ ┴ ┼` for all borders. Never use `+`, `-`, `|` for box edges.
183+
2. **Fixed-width columns** — decide column widths first, then fill content. Every row in a section must have the same total width.
184+
3. **Pad content inside boxes** — always one space of padding: `│ Label │` not `│Label│`.
185+
4. **Verify vertical alignment** — every `│` in a column must sit in the same character position across all rows. Count characters if needed.
186+
5. **Keep it readable** — target 80-120 character width for most views, up to 160 for complex multi-column layouts. Prefer multiple focused mockups over one that's too dense.
187+
6. **Label everything** — every box, region, and element gets a text label. Unlabeled boxes are ambiguous.
188+
7. **Use consistent indentation** — nested elements indent by exactly 2 spaces.
189+
190+
Example of correct alignment:
191+
```
192+
┌─────────────────────────────────────────────┐
193+
│ Header │
194+
├──────────────────────┬──────────────────────┤
195+
│ Sidebar │ Main Content │
196+
│ │ │
197+
│ [Nav Item 1] │ Page Title │
198+
│ [Nav Item 2] │ ─────────── │
199+
│ [Nav Item 3] │ Content area... │
200+
│ │ │
201+
├──────────────────────┴──────────────────────┤
202+
│ Footer │
203+
└─────────────────────────────────────────────┘
204+
```
205+
178206
#### Per-View Mockup Process
179207

180208
For each distinct screen or view identified in the domain model:
181209
- Create a mockup showing layout structure, key UI elements, and data placement
182210
- Annotate with interaction notes (what happens on click, hover, submit, error states)
183211
- Show which domain entities map to which UI regions
184212
- If working from designs: note where your interpretation might diverge from the source
213+
- **After drawing each mockup, visually verify that all vertical lines align before writing to disk**
185214

186215
Append each mockup to `discovery.md`:
187216
```

0 commit comments

Comments
 (0)