Sketch Wrap Up

/meridian:sketch-wrap-up — Pick Winner and Close Sketch

Concludes a sketch session: records the winning variant, archives losers, and closes the gate so a linked UI phase can proceed.

Arguments

• — Pick winner (variant-a, variant-b, or variant-c) and close
• --ui-phase — Also link the winner to a specific UI phase

Keywords

sketch, wrap-up, close, winner, pick, archive, design, handoff

Procedure

Step 1: Load Sketch Details

PYTHONPATH=$MERIDIAN_HOME uv run --project $MERIDIAN_HOME -- python -c "
import json
from scripts.db import open_project
from scripts.sketch import get_sketch
with open_project('.') as conn:
    s = get_sketch(conn, '')
    if s:
        print(json.dumps(s, indent=2))
    else:
        print('not found')
"

If not found: display error and stop. If already closed: display current winner and stop.

Store: variants list, title, phase_id.

Step 2: Validate Winner Variant

Confirm the chosen variant exists as a file:

.planning/sketches//.html

If the file does not exist, show: > ✗ Variant .html not found in .planning/sketches//. Available: . > Stop.

Step 3: Wrap Up

PYTHONPATH=$MERIDIAN_HOME uv run --project $MERIDIAN_HOME -- python -c "
import json
from pathlib import Path
from scripts.db import open_project
from scripts.sketch import wrap_up_sketch
with open_project('.') as conn:
    result = wrap_up_sketch(
        conn,
        '',
        '',
        Path('.'),
        ui_phase_id=,
    )
    print(json.dumps(result, indent=2))
"

Step 4: Display Summary

Sketch wrapped up: 
Status: closed
Winner: .html
Archived: .html, .html → .planning/sketches//archived/

Phase link: 
Next: run /meridian:ui-phase --phase  (passes the winning design as context)

What Happens on Wrap-Up

1. Winner variant stays in .planning/sketches//
2. All other variant HTML files move to .planning/sketches//archived/
3. MANIFEST.md updated with winner notation
4. DB record: status = 'closed', winner_variant set, closed_at set
5. Gate clears — /meridian:ui-phase can now reference the winner as design context

When to Use

• After reviewing the variant HTML files and agreeing on an approach
• Before starting /meridian:ui-phase on the same feature
• After stakeholder review selects a direction

Notes

• Once closed, a sketch cannot be re-opened (create a new sketch instead)
• The winning variant should be referenced in the UI phase SKILL prompt as starting design context
• Archived variants are preserved — not deleted — for reference

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: mattjaikaran
• Source: mattjaikaran/meridian
• License: Apache-2.0

Install and usage instructions live in the source repository linked above.