harness-stream

Drains a continuously-growable task pool through a 7-stage pipeline one task at a time.

Updated May 15, 2026
One-click install
npx skills add https://github.com/Alan-IFT/harness-kit --skill harness-stream-alan-ift
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness-stream
Source: https://github.com/Alan-IFT/harness-kit/tree/main/skills/harness-stream
Command: npx skills add https://github.com/Alan-IFT/harness-kit --skill harness-stream-alan-ift

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When developing with an AI pipeline, new requirements keep occurring mid-run, and a fixed batch plan forces you to stop, update, and re-invoke every time. This Skill keeps a task pool open so tasks you add while it runs are picked up automatically, and a single task failure never halts the whole run. ## Core Features & Use Cases - Living task pool: Re-reads docs/batches/<pool-id>/BATCH_PLAN.md every iteration so newly appended pending rows are planned into the topological frontier without re-invoking. - Best-effort execution: A failed task is marked and skipped, a needs-human task is deferred and surfaced in the report's ## Needs your input section, and only genuine hazards (baseline verify_all FAIL, STOP intervention, safety-hook block) halt the stream. - Ambient mode: Invoking with no pool-id turns every chat message into a heartbeat that folds new requirements into the default pool and drains it, gated by a session-scoped .harness/ambient.flag. - Use Case: While building a feature you keep thinking of follow-ups — "also add CSV export", "fix the login redirect" — so you run the stream under /loop, type requirements as they occur, and only watch the per-task verdicts and final STREAM_REPORT.md. ## Quick Start Run /harness-stream with my pool-id (or no argument for ambient mode) and keep draining every task I add to the pool, reporting failures without stopping.

Frequently Asked Questions about harness-stream

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep adding tasks to an AI pipeline while it runs?▼

Append a pending row to docs/batches/<pool-id>/BATCH_PLAN.md or drop an ADD line in .harness/intervention.md; the stream re-reads both at the top of every iteration. Under the /loop driver you can also type requirements in chat, ingested on the next tick.

What is the difference between harness-stream and harness-batch?▼

harness-batch freezes a fixed task list at start and stops on the first hard failure. harness-stream keeps the pool open so mid-run additions are picked up, treats task failures as best-effort, and only halts on baseline verify_all FAIL, a STOP intervention, or a safety-hook block.

Can I add work by typing in chat during a stream run?▼

Only under the /loop driver, where each tick is its own turn so queued chat is ingested on the next tick. In a continuous single-turn run, chat is queued until the invocation ends, so use the file channel (pool rows or ADD interventions) instead.

What happens when a task in the stream fails?▼

The row is marked failed, its Depends on descendants are marked blocked, and the stream continues with the next ready task. It is not retried in the same run; fix the cause and re-invoke to resume unfinished rows.

When should I not use harness-stream?▼

Use /harness-batch for a fixed fail-fast task list, /harness for exactly one task, /harness-goal for iterating toward a measurable criterion, /harness-plan to vet a design, and /harness-explore for feasibility research.