Spike Wrap Up

/meridian:spike-wrap-up — Close a Spike and Extract Learnings

Concludes a spike: records the outcome, extracts learnings into the DB, and closes the gate so dependent plan phases can proceed.

Arguments

• "" — Close spike and record outcome (no learnings)
• "" --learnings "" "" ... — Also extract learnings

Keywords

spike, wrap-up, close, conclude, outcome, learnings, findings, gate

Procedure

Wrap up without explicit learnings

PYTHONPATH=$MERIDIAN_HOME uv run --project $MERIDIAN_HOME -- python -c "
import json
from pathlib import Path
from scripts.db import open_project
from scripts.spikes import wrap_up_spike
with open_project('.') as conn:
    result = wrap_up_spike(
        conn,
        '',
        '',
        [],  # no explicit learnings
        Path('.'),
    )
    print(json.dumps(result, indent=2))
"

Wrap up with learnings

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

What Happens on Wrap-Up

1. Spike status → closed, closed_at set to now
2. Outcome written to DB and to .planning/spikes//MANIFEST.md
3. Each learning rule inserted into the learning table (scope: project, source: execution)
4. Gate is now clear — /meridian:plan on the linked phase can proceed

Display Format

Spike wrapped up: 
Status: closed
Outcome: 

Learnings recorded: 
  1. 
  2. 

Gate cleared for phase: 
Next: run /meridian:plan on phase 

When to Use

• You've finished the exploration and have an answer
• Use before starting /meridian:plan on the phase that triggered the spike
• After adding finding files to .planning/spikes//findings/

Notes

• Learnings are stored with source = 'execution' and linked to the triggering phase
• The MANIFEST.md is updated in-place with the outcome section
• Once closed, a spike cannot be re-opened (create a new spike instead)

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.