Runs

What Runs Capture

When a workflow skill executes — a capture pipeline, a publish, a maintain pass — it writes an artifact trail to runs/. The trail is the receipt: what ran, what it did, what it produced, and whether it succeeded. You can replay a run from its trail, or debug a failure without re-running the whole thing.

Folder Shape

runs/
  {skill-name}/
    {run-id}/
      proposal.md    — what we're doing and why
      tasks.md       — checklist of steps
      context.json   — switches and config for this run
      evidence/      — screenshots, test output, verification
      logs/          — debug events + trace.jsonl

When to Use

• Always: multi-step workflow skills like capture, publish, distribute, maintain
• On failure: any skill that hit an error you want to diagnose later
• Never: quick one-shot skills like copywriting or page-cro, unless debugging