ShaheerKhawaja/productionos-auto-swarm-nth
codex-skills/productionos-auto-swarm-nth/SKILL.md
Nth-iteration agent swarm — spawns parallel agent waves, evaluates strictly per wave, re-swarms gaps until 100% coverage and 10/10 quality. Can invoke any ProductionOS skill or command within waves.
$ install --global
skillsauthnpx skillsauth add ShaheerKhawaja/ProductionOS productionos-auto-swarm-nthInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 23, 2026, 2:09 AM35.9s1 file scanned
SKILL.md
- name:
- productionos-auto-swarm-nth
- description:
- Nth-iteration agent swarm — spawns parallel agent waves, evaluates strictly per wave, re-swarms gaps until 100% coverage and 10/10 quality. Can invoke any ProductionOS skill or command within waves.
- argument-hint:
- [repo path, target, or task context]
productionos-auto-swarm-nth
Use this alias when you want the same workflow through a top-level Codex-safe name without the productionos: namespace.
Overview
This is the Codex-native workflow wrapper for .claude/commands/auto-swarm-nth.md.
Use it when the user wants this exact ProductionOS workflow, not just the umbrella productionos router.
Source of Truth
- Read the source command spec at .claude/commands/auto-swarm-nth.md.
- Use CODEX-PARITY-HANDOFF.md to confirm runtime support and parity expectations.
- Preserve the source workflow's guardrails, scope, artifacts, and verification intent.
- Translate Claude-only slash-command and hook semantics into Codex-native execution instead of copying them literally.
Codex Behavior
- Summary: Recursive swarm orchestration until coverage and quality thresholds are met.
- Expected behavior: Repeat swarm-style execution until gaps close, while translating agent waves into Codex-native orchestration.
- Validation: tests/runtime-targets.test.ts
Inputs
task— The task to swarm on (natural language description) Required.max_waves— Maximum swarm waves (default: unlimited, practical cap: 20) Default:20Optional.mode— Swarm mode: research | build | audit | fix | explore (default: auto-detect) Optional.swarm_size— Agents per wave (default: 7, max: 7) Default:7Optional.max_cost— Maximum accumulated cost in USD before halting (default: 20) Default:20Optional.isolation— Agent isolation mode: none (default) | worktree (each agent gets isolated git worktree with non-overlapping file scopes) Default:noneOptional.
Execution Outline
- Preamble
Agents And Assets
- Agents:
merge-conflict-resolver,self-evaluator,self-healer,worktree-orchestrator - Templates:
INVOCATION-PROTOCOL.md,PREAMBLE.md,SELF-EVAL-PROTOCOL.md - Artifacts:
.productionos/SWARM-COVERAGE.md,.productionos/SWARM-NTH-COST-HALT.md,.productionos/SWARM-NTH-REPORT.md,.productionos/SWARM-WAVE-{N}.md,.productionos/TOKEN-BUDGET.md,.productionos/WORKTREE-MERGE-LOG.md,.productionos/self-eval/,.productionos/swarm-tasks.json
Workflow
- Load only the agents, templates, prompts, and docs referenced by the source command.
- Execute the workflow intent with Codex-native tools.
- If the source command implies parallel agent work, only delegate when the user explicitly wants that overhead.
- Verify with the smallest relevant checks before concluding.
- Summarize what changed, what was verified, and what still needs human approval.
Guardrails
- Do not claim that Claude-only marketplace, hook, or slash-command behavior runs directly in Codex.
- Keep the scope faithful to the source command rather than broadening into a generic repo audit.
- Prefer concrete outputs and validation over describing the workflow abstractly.
- Cost ceiling: $ARGUMENTS.max_cost (default $20). Enforced via Phase 0 cost check before every wave. Hard halt when exceeded.
- Maximum waves: $ARGUMENTS.max_waves (default 20, hard cap 50)
- Agents per wave: $ARGUMENTS.swarm_size (default 7, max 7)
- Per-wave token budget: 400K
- Total session budget: 5M tokens
- Regression protection: if a fix breaks existing tests, rollback immediately
- Stall detection: 2 waves with < 2% coverage improvement triggers pivot
- Quality floor: no item can drop below its previous quality score
Related Skills
ShaheerKhawaja/writing-plans
tools
VerifiedTrustedCommunity
Implementation planning workflow that turns approved ideas into dependency-aware execution plans.
7SKILL.mdUpdated Apr 23, 2026
ShaheerKhawaja/wiki-rag
development
VerifiedTrustedCommunity
Local RAG and Graph RAG over the SecondBrain wiki vault. Progressive context loading (hot cache -> index -> domain -> entity). Graph traversal via wikilink resolution. Use when agents need cross-project context, when answering questions that span multiple domains, or when building context for planning tasks. Triggers on: "wiki context", "cross-project context", "what do we know about", "check the wiki", "graph context", "/wiki-rag".
7SKILL.mdUpdated Apr 23, 2026
ShaheerKhawaja/ux-genie
devops
VerifiedTrustedCommunity
UX improvement pipeline — creates user stories from UI guidelines, maps user journeys, identifies friction, dispatches fix agents. The user-experience equivalent of /production-upgrade.
7SKILL.mdUpdated Apr 23, 2026
ShaheerKhawaja/tdd
development
VerifiedTrustedCommunity
Test-driven development workflow that writes failing tests first, implements minimally, and refactors safely.
7SKILL.mdUpdated Apr 23, 2026