You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: plugin/skills/elaborate-discover/SKILL.md
+29Lines changed: 29 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -175,13 +175,42 @@ Spawn one subagent per design file, in parallel with codebase Explore agents. Wh
175
175
176
176
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.
177
177
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
+
178
206
#### Per-View Mockup Process
179
207
180
208
For each distinct screen or view identified in the domain model:
181
209
- Create a mockup showing layout structure, key UI elements, and data placement
182
210
- Annotate with interaction notes (what happens on click, hover, submit, error states)
183
211
- Show which domain entities map to which UI regions
184
212
- 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**
0 commit comments