repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

docs(super): design accepted mockup artifacts

36b443bc8e5cf86859fb1e6273df02ee50146c17

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare 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
3 +## Goal
5 +Preserve accepted brainstorming mockups beside their design spec so the visual decision remains reviewable after the in-memory mockup server closes.
7 +## Scope
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.
15 +## Artifacts
17 +After the spec path is known, write each accepted option as a standalone HTML document in the spec directory.
19 +Name each artifact:
21 +```text
22 +<spec-stem>-mockup-<option-id>.html
23 +```
25 +For example:
27 +```text
28 +docs/super/specs/2026-07-11-layout-design.md
29 +docs/super/specs/2026-07-11-layout-design-mockup-right-rail.html
30 +```
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.
39 +## Spec reference
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.
44 +Example:
46 +```markdown
47 +## Mockups
49 +- [Right rail](./2026-07-11-layout-design-mockup-right-rail.html)
50 +```
52 +## Workflow
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.
60 +## Tests
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.