pi-ext bugabingas pi extensions
owned by bugabinga
README Source History Refs Compare Notes Search docs(super): design accepted mockup artifacts
36b443bc8e5cf86859fb1e6273df02ee50146c17
Oliver Jan Krylow <oliver@bugabinga.net > · 11 Jul 2026
unsigned
Browse files Compare with HEAD
Changed files (1) docs/super/specs/2026-07-11-accepted-mockup-artifacts-design.md Added new file mode 100644 1 + #
Accepted mockup artifacts design 5 + Preserve accepted brainstorming mockups beside their design spec so the visual decision remains reviewable after the in-memory mockup server closes.
9 + Persistence belongs to the brainstorming agent workflow, not the generic `mockup` tool.
10 + The tool remains in-memory and performs no project writes.
12 + Only options selected when the user chooses Accept are persisted.
13 + Iterated and unselected options are discarded.
17 + After the spec path is known, write each accepted option as a standalone HTML document in the spec directory.
22 + <spec-stem>-mockup-<option-id>.html
28 + docs/super/specs/2026-07-11-layout-design.md
29 + docs/super/specs/2026-07-11-layout-design-mockup-right-rail.html
32 + The document body contains the accepted option fragment unchanged.
33 + Add only the minimal document shell: doctype, language, UTF-8 charset, viewport metadata, and title.
34 + Embedded fragment styles and scripts remain intact.
36 + When `multi: true` accepts multiple options, write one file per selected option.
37 + If Accept has no selection, write no artifact.
41 + Add a `## Mockups` section to the spec containing relative Markdown links to every persisted artifact.
42 + Use each option label as the link text.
49 + - [Right rail](./2026-07-11-layout-design-mockup-right-rail.html)
54 + 1. Retain accepted option IDs, labels, and original HTML from the `mockup` call.
55 + 2. Finish the design and choose its spec path.
56 + 3. Write accepted standalone HTML artifacts beside the spec.
57 + 4. Add relative links under `## Mockups`.
58 + 5. Commit the spec and its mockup artifacts together.
62 + Update workflow-skill tests to require accepted-only persistence, deterministic adjacent filenames, multi-selection handling, standalone HTML, and relative spec links.
63 + Run `mise run ci` before completion.