csv-wave-pipeline

Decomposes requirements into dependency-sorted CSV tasks and executes them in concurrent agent waves.

2.1k|165|Updated Sep 7, 2025
One-click install
npx skills add https://github.com/catlog22/Claude-Code-Workflow --skill csv-wave-pipeline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: csv-wave-pipeline
Source: https://github.com/catlog22/Claude-Code-Workflow/tree/main/.codex/skills/csv-wave-pipeline
Command: npx skills add https://github.com/catlog22/Claude-Code-Workflow --skill csv-wave-pipeline

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinating multi-agent execution of a complex requirement is hard: tasks have dependencies, agents duplicate codebase exploration, and results from earlier work never reach later tasks. This Skill turns a plain-language requirement into a dependency-sorted CSV task plan and runs it wave by wave with cross-wave context propagation.

Core Features & Use Cases

  • Requirement Decomposition: Uses a CLI analysis pass to break a requirement into 3-10 atomic tasks with test cases, acceptance criteria, scopes, and dependencies, then computes execution waves via topological sort.
  • Wave-Based Concurrent Execution: Runs each wave through spawn_agents_on_csv with configurable concurrency, injecting previous-wave findings into a prev_context column so downstream tasks inherit upstream results.
  • Shared Discovery Board: All agents append code patterns, integration points, and blockers to a shared discoveries.ndjson file, eliminating redundant exploration across waves.
  • Use Case: Ask it to "Implement user authentication with OAuth, JWT, and 2FA" — it plans the tasks, runs independent setup work concurrently in Wave 1, then executes dependent integration tasks in later waves with full context from earlier findings.

Quick Start

Run the csv-wave-pipeline skill with a requirement like "Implement user authentication with OAuth, JWT, and 2FA" and approve the generated task breakdown to start wave execution.

Frequently Asked Questions about csv-wave-pipeline

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

FAQPage Schema
How do I run multiple coding agents on a requirement with task dependencies?

Pass the requirement to csv-wave-pipeline, which decomposes it into 3-10 tasks with a deps column, computes execution waves via topological sort, and runs each wave concurrently with spawn_agents_on_csv. Dependent tasks automatically receive findings from completed upstream tasks.

How do agents share context between execution waves?

Context flows through two channels: a prev_context CSV column built from the context_from field that injects specific prior task findings, and a shared discoveries.ndjson file where all agents append code patterns, integration points, and blockers for others to read.

Can I resume an interrupted wave pipeline session?

Yes, use the --continue flag to resume an existing session. The pipeline reads the master tasks.csv in the session folder, identifies incomplete waves, and restarts execution from where it stopped.

What happens when a task fails in a wave?

Failed tasks are recorded in the master CSV with an error message, and any downstream tasks depending on them are marked as skipped rather than executed. The pipeline continues with remaining independent tasks and offers a retry option in the final summary.

How do I control how many agents run concurrently?

Use the -c or --concurrency flag followed by a number, for example -c 4. This sets max_concurrency for spawn_agents_on_csv within each wave; the default is 4 concurrent agents.

Can the pipeline reuse results from a prior analysis session?

Yes, pass a handoff JSON path in the requirement using the handoff: prefix. The pipeline loads implementation scope, code anchors, and key findings from analyze-with-file or workflow-lite-plan sessions and seeds the discovery board to skip redundant exploration.