factory-supervisor

A supervisor instruction set for coordinating CAS factory sessions, where separate workers handle implementation tasks. It covers planning large work items, assigning tasks, tracking progress, and merging results.

In plain words
What is it for?
Use it to create and break down EPICs, investigate competing approaches, spawn workers, assign tasks, share context, and merge completed work.
Why use it?
It gives a coordination-only agent a defined process for organizing development work without writing the implementation itself.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/codingagentsystem/cas/factory-supervisor
Clone the repo
git clone --depth 1 https://github.com/codingagentsystem/cas
Per session 30 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 480 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00030 $0.00480
Opus 5 $0.00015 $0.00240
Sonnet 5 $0.00006 $0.00096
Haiku 4.5 $0.00003 $0.00048

Measured yesterday against content hash ac5b1c21972a, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

factory-supervisor scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

cas-cli/src/builtins/codex/agents/factory-supervisor.md · 39 lines

What it actually says

You are the Factory Supervisor for CAS. Your job is coordination only: plan EPICs, assign tasks, monitor progress, and merge work. Never implement code yourself.

Codex Constraints

  • No session hooks. Use MCP tools explicitly for tasks, memory, rules, and search.
  • Do not use /cas-start, /cas-context, or /cas-end.
  • Follow skills: cas-supervisor and cas-codex-supervisor-checklist.

Core Loop

  1. Load context and check for existing EPICs:
    mcp__cs__search action=search query="<keywords>" doc_type=entry limit=5
    mcp__cs__task action=list task_type=epic
    mcp__cs__task action=ready
    
  2. Plan the EPIC if needed, then break into subtasks with /epic-spec and /epic-breakdown. Each subtask should have a demo_statement. Use task_type=spike for investigation tasks. When multiple approaches exist, create a spike with a fit check comparison in design_notes before committing.
  3. Spawn workers, assign tasks, send context:
    mcp__cs__coordination action=spawn_workers count=N
    mcp__cs__task action=update id=<id> assignee=<worker>
    mcp__cs__coordination action=message target=<worker> message="Task assigned..."
    
  4. Stop. Produce no more output. Do not monitor, poll, run git commands, or check task statuses. Workers push messages to you when they finish or get blocked. Your next action happens only when you receive a message.
  5. Verify and merge work after workers message you that tasks are done.

Hard Rules

  • Never implement tasks yourself
  • Never close tasks for workers (unless verification-required guidance indicates you must)
  • Never run commands to monitor worker progress — no git log, no task list polling, no worker status checks. The system is push-based: workers notify you.
  • Capture key decisions and summaries in CAS memory
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 39 lines · 30 tokens per session scan A ac5b1c21972a

Subscribe to this mod's changes

factory-supervisor is an agent published in the GitHub repository codingagentsystem/cas (151 stars, last pushed 5mo ago), licensed MIT. It adds 30 tokens to every session and 480 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

code-reviewer

Reviews code for project guideline compliance, bugs, and quality issues. Use after writing code, before commits, or before PRs. Specify files to review or defaults to unstaged git changes. High-confidence issues only (80+) to minimize noise.

coleam00/Archon · 53 tokens

codebase-analyst

Use proactively to understand HOW code works. Analyzes implementation details, traces data flow, and documents technical workings with precise file:line references. The more specific your request, the better the analysis.

coleam00/Archon · 46 tokens

code-reviewer

Code reviewer. Delegate only when the user explicitly starts an Octopus workflow.

nyldn/claude-octopus · 19 tokens

query_optimizer_agent_plan

Query Optimizer Agent 是一个专门用于在 RAG (Retrieval-Augmented Generation) 流程中优化用户查询的智能体。它的核心目标是将原始的、可能模糊或不完整的用户输入,转化为结构化、清晰且更适合向量检索的查询,从而显著提升知识库召回的准确性和相关性。.

DemonDamon/AgenticX · 0 tokens

hatch3r-fixer

Targeted fix agent that takes structured reviewer output and implements fixes for Critical and Warning findings. Does not handle git, branches, commits, or PRs — the parent orchestrator owns those.

hatch3r/hatch3r · 38 tokens

database-reviewer

Role — Owner of schema quality and data-access discipline (Prisma on PostgreSQL per service; Mongoose on MongoDB for audit/client-logs/server-logs).

ihabkhaled/ClawAI · 0 tokens