demoverse: Skill for Claude Code

/backfill-opps [N]

Processes the next N opportunities (default 5) end-to-end with zero operator input. The main context runs ONLY shell commands and subagent dispatch. All prose is written by opp-filler subagents (model: sonnet, one per opportunity). Never fill result files inline in the main context.

The loop

0. Pick targets

npm run apply -- --next=N

Output is one opp per line: oppId<TAB>status<TAB>accountName<TAB>untouched|planned:K. planned:K rows are planted-but-unfilled deals from an interrupted run. They resume identically (replanting is an idempotent no-op that re-emits prompts). If the list is empty, report "all opportunities filled" and stop.

1. Process in waves of 3

For each wave of up to 3 opportunities:

a. Plant (serial). The ledger is last-writer-wins, so never parallelize apply:

For each opp in the wave:

npm run apply -- --backfill-touchpoints --opp=<oppId>

Then IMMEDIATELY read state/requests/<periodIndex>/manifest.json (the period index is printed by the command) and record this opp's request list, one {artifactId, kind, output, promptFile, resultFile} per entry. The manifest is OVERWRITTEN by the next plant, so capture it before planting the next opp.

b. Fill (parallel): launch the wave's opp-filler subagents in ONE message. Give one subagent per opportunity, each with the absolute request dir and only ITS opp's request list. Result files are distinct, so parallel fills never conflict.

c. Ingest + lint + fix + reconcile + commit (serial, one opp at a time):

npm run apply -- --ingest --opp=<oppId>          # validate + file (no push yet)

• If it reports invalid > 0: re-launch opp-filler for that opp in fix mode with the invalid artifact ids + reasons, then re-run the ingest.

npm run lint -- --opp=<oppId>

• On error findings, run up to 2 fix rounds:
  1. For each offending artifact: npm run apply -- --refill=<artifactId> (resets it to planned and re-emits its prompt).
  2. Re-launch opp-filler in fix mode scoped to those artifacts, quoting the lint error messages verbatim.
  3. npm run apply -- --ingest --opp=<oppId> and re-lint.
• Still failing after 2 rounds → append the opp + errors to runs/backfill-notes.md, skip the commit for this opp, continue with the next one. Never stall the batch on one deal.