Skip to content

super-swarm-spark: make concurrency limit docs consistently 15 #8

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
iqdoctor wants to merge 2 commits into
base: main
Choose a base branch
from
Open

super-swarm-spark: make concurrency limit docs consistently 15 #8

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7ec0b7d
super-swarm-spark: unify concurrency docs to 15 and add max_threads note
iqdoctor Mar 3, 2026
063a2ed
super-swarm-spark: clarify thread allowance includes orchestrator
iqdoctor Mar 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 15 additions & 7 deletions skills/super-swarm-spark/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: >
Only to be triggered by explicit super-swarm-spark commands.
---

# Parallel Task Executor (Sparky Rolling 12-Agent Pool)
# Parallel Task Executor (Sparky Rolling 15-Agent Pool)

You are an Orchestrator for subagents. Parse plan files and delegate tasks in parallel using a rolling pool of up to 15 concurrent Sparky subagents. Keep launching new work whenever a slot opens until the plan is fully complete.

Expand Down Expand Up @@ -53,11 +53,11 @@ Rules:
- Require explicit file targets in every subagent assignment.
- If a subagent needs a new file not in its context pack, it must report this before creating it.

### Step 4: Launch Subagents (Rolling Pool, Max 12)
### Step 4: Launch Subagents (Rolling Pool, Max 15)

Run a rolling scheduler:
- States: `pending`, `running`, `completed`, `failed`
- Launch up to 12 tasks immediately (or fewer if less are pending)
- Launch up to 15 tasks immediately (or fewer if less are pending)
- Whenever any running task finishes, validate/update plan for that task, then launch the next pending task immediately
- Continue until no pending or running tasks remain

Expand All @@ -66,7 +66,7 @@ For each launched task, use:
- **description**: "Implement task [ID]: [name]"
- **prompt**: Use template below

Do not wait for grouped batches. The only concurrency limit is 12 active Sparky subagents.
Do not wait for grouped batches. The only concurrency limit is 15 active Sparky subagents.

Every launch must set `agent_type: sparky`. Any other role is invalid for this skill.

Expand Down Expand Up @@ -154,11 +154,19 @@ Completion bar:

## Scheduling Policy (Required)

- Max concurrent subagents: **12**
- If pending tasks exist and running count is below 12: launch more immediately
- Max concurrent subagents: **15**
- If pending tasks exist and running count is below 15: launch more immediately
- Do not pause due to relationship metadata
- Continue until the full plan (or requested subset) is complete and integrated

If runtime limits prevent reaching 15 active agents plus orchestrator, increase Codex thread allowance:

`~/.codex/config.toml`
```toml
[agents]
max_threads = 16
```

## Error Handling

- Task subset not found: List available task IDs
Expand All @@ -182,7 +190,7 @@ Completion bar:
## Tasks Assigned: [N]

## Concurrency
- Max workers: 12
- Max workers: 15
- Scheduling mode: rolling pool (continuous refill)

### Completed
Expand Down