agentleFS
bohewubohewu/agents_pipeline/AGENTS.md

agents_pipeline

AGENTS.md1 starsChanged 4 months agoMITView on GitHub

This catalog lists all agents and their roles. Codex is the Tier 1, first-class runtime; normal child-model selection comes from the workspace profile while the provider remains inherited from the parent Codex session. Generated role profiles may override only the model, never the provider. Claude Code .claude/agents/*.md and VS Code Copilot .agent.md files are Tier 2 best-effort exports without a feature-parity guarantee. OpenCode support ended at the frozen OpenCode-first release, v0.26.1. Runtime-neutral source lives in agents/, protocols/, skills/, and tools/.…

The file

We split this AGENTS.md into the rules it gives an agent

4 rules. About 0 are common, 2 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use the smallest implementation and verification sufficient for the stated requirement.

    line 10
  2. Very specific:

    Before capability recovery or a later recovery-stage dispatch, also read protocols/CAPABILITY_RECOVERY.md.

    line 12
  3. Distinctive:

    Keep validation bounded to the requested delivery.

    line 13
  4. Very specific:

    Before any authorized commit or push, including orchestrator helper actions, follow protocols/COMMIT_GUARD.md.

    line 14

≈ “Common” is an estimate: at least 1 in 5 of the 40,246 AGENTS.md files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
AGENTS.md

Agent Catalog

This catalog lists all agents and their roles. Codex is the Tier 1, first-class runtime; normal child-model selection comes from the workspace profile while the provider remains inherited from the parent Codex session. Generated role profiles may override only the model, never the provider. Claude Code .claude/agents/*.md and VS Code Copilot .agent.md files are Tier 2 best-effort exports without a feature-parity guarantee. OpenCode support ended at the frozen OpenCode-first release, v0.26.1. Runtime-neutral source lives in agents/, protocols/, skills/, and tools/. Generated runtime outputs must not be hand-edited. Mode aliases and their orchestrator targets are defined in modes.json. $run-adaptive is intentionally a skill-only Simple/Flow/Pipeline router with route-independent execution presets, not an agent role or manifest-backed compatibility mode. Before managed role or Web session agent Job dispatch, read protocols/REASONING_POLICY.md and follow its profile/tier, shared-resolver, saved-configuration, dispatch-surface evidence, and result-label rules. Exported roles are leaf workers and must not dispatch another agent. Never claim native managed-role identity, workspace routing, a verified model, or effective effort without the evidence that protocol requires. Configured workspace profiles require health = ok, profile_eligibility = eligible, and catalog_state = current before new dispatch or resume. A pinned or retired catalog requires explicit workspace set --model-set openai or clear; it does not silently inherit the parent model. For an explicit request to dispatch a registered managed role outside a $run-* workflow, read the Ad-hoc managed-role dispatch section of protocols/REASONING_POLICY.md before spawning. Keep this path adaptive, pass tier unknown when the profile/runtime cannot prove it, and create no workflow artifacts; unverifiable or unhealthy profile status and resolver or selector conflicts stop dispatch. Use the smallest implementation and verification sufficient for the stated requirement. Rigor means proving the requested behavior, not adding abstractions, checks, or polish. Before resuming a run, editing after a failed check, or starting any repair, reviewer followup, capability recovery, or new Goal continuation round, read protocols/MATERIALITY_GATE.md. Apply its requirement-authority, failure-classification, validation-infrastructure, budget, stop, and resume/strategy-delta rules; only material work tied to an unmet original condition may continue. Before capability recovery or a later recovery-stage dispatch, also read protocols/CAPABILITY_RECOVERY.md. Keep its effort-first default, sole qualified LSA v2 exception, eligible-role and operational-failure limits, task-scoped target binding, and existing counter rules unchanged. Keep validation bounded to the requested delivery. Workflow-generated artifacts cannot expand scope, and validation infrastructure remains forbidden unless the original request or a pre-existing repository contract authorized it before dispatch. Before any authorized commit or push, including orchestrator helper actions, follow protocols/COMMIT_GUARD.md. Invoke its deterministic guard directly; hook presence does not replace the check. A passing check never grants commit/push permission, and an explicit no-commit instruction remains binding. Repository-specific Goal policy: do not create or activate a Goal for work in this repository unless the user's current message explicitly requests Goal mode. A run-* workflow request alone is not Goal consent. For the conceptual UI/UX layer, use ui-ux-designer; see protocols/UI_UX_WORKFLOW.md plus the ui-ux-bundle schema/example bundle at protocols/schemas/ui-ux-bundle.schema.json and protocols/examples/ui-ux-bundle.valid.json. The same surface also covers communication-first redesign and critique work via skills/ui-communication-designer/SKILL.md. For frontend implementation or polish after a conceptual handoff, use skills/frontend-aesthetic-director/SKILL.md; it preserves the upstream wireframe/flow and focuses on visual direction, tokens, responsive behavior, accessibility, and rendered QA.

AgentRoleModeNotes
orchestrator-ciCI/CD planning pipeline (docs-first, optional generation)primaryDocs-first
orchestrator-modernizeModernization planning pipeline (experimental)primaryIn-place Pipeline transition for requested execution
orchestrator-pipelineFull pipeline orchestration with routing, retries, and synthesisprimaryGlobal handoff protocol embedded
orchestrator-specDevelopment spec orchestration for review-ready DevSpec outputsprimaryDocs-first
orchestrator-flowFlow orchestration with max-5 tasks and optional reviewer gateprimaryBounded flow, no delta-task retry loops
orchestrator-simpleSimple build-style dispatcher with subagent delegation and no run artifactsprimaryNo manifest/status writes
orchestrator-committeeSwarm committee for decision-making (experts + KISS soft-veto + judge)primaryDecision support only
orchestrator-generalGeneral-purpose orchestration for mixed coding, planning, writing, analysis, and maintenance tasksprimaryGeneral dispatcher
orchestrator-analysisPost-hoc analysis pipeline with conditional expert roster and severity-ranked findingsprimaryAnalytical review
orchestrator-uxUX audit orchestration with profile-aware scoring and normal-user findingsprimaryAnalysis-only
specifierConvert user input into ProblemSpec JSON and optional DevSpec JSONsubagenthidden
plannerProduce PlanOutline JSONsubagenthidden
repo-scoutRepo discovery and risk scanningsubagenthidden
atomizerConvert PlanOutline into atomic TaskList (DAG)subagenthidden
routerBuild cost-aware DispatchPlansubagenthidden
committee-architectCommittee expert (architecture/maintainability)subagenthidden
committee-securityCommittee expert (security/risk)subagenthidden
committee-qaCommittee expert (QA/reliability)subagenthidden
committee-productCommittee expert (product/user impact)subagenthidden
committee-kissCommittee KISS guard (soft veto)subagenthidden
committee-judgeCommittee judge (final synthesis)subagenthidden
analysis-correctnessAnalysis expert (logical correctness/invariants)subagenthidden
analysis-complexityAnalysis expert (time/space complexity/efficiency)subagenthidden
analysis-robustnessAnalysis expert (edge cases/error paths/adversarial inputs)subagenthidden
analysis-numericsAnalysis expert (numerical stability/precision) — conditionally dispatchedsubagenthidden
ux-noviceUX expert (first-time user discoverability/orientation)subagenthidden
ux-task-flowUX expert (task flow/friction/completion)subagenthidden
ux-copy-trustUX expert (copy/labels/trust/recovery wording)subagenthidden
ux-visual-hierarchyUX expert (scanability/layout hierarchy across viewports)subagenthidden
ux-judgeFinal UX judge (scorecard/findings/priority actions)subagenthidden
flow-splitterConvert a Flow ProblemSpec into a max-5 bounded task listsubagenthidden
market-researcherResearch specialist for web-based market scans, pricing signals, and monetization benchmarkssubagenthidden
art-directorConvert raw 2D asset requests into concise briefs and reusable promptssubagenthidden
ui-ux-designerConvert bounded UI/UX requests into conceptual workflow briefs, communication-first redesign guidance, surface maps, and handoff notessubagenthidden
executorExecute one atomic task with bounded verification and repair controlssubagenthidden
executor-strongExecute one difficult atomic task through the shared executor contract on a profile-owned strong bindingsubagenthidden
doc-writerDocumentation specialist for design/spec/checklist/analysis outputssubagenthidden
peonLow-cost executor for mechanical or repetitive taskssubagenthidden
generalistGeneral-purpose executor for mixed-scope taskssubagenthidden
test-runnerRun tests/builds/linters and collect evidencesubagenthidden
reviewerReview outputs and enforce quality gatessubagenthidden
compressorCompress repo decisions into ContextPacksubagenthidden
debuggerOn-demand diagnosis specialist for difficult, uncertain, cross-module, or conflicting-evidence failuressubagenthidden
handoff-writerProduce run-local handoff artifacts for a fresh sessionsubagenthidden
kanban-managerManage the root-tracked todo ledger and kanban rendersubagenthidden
session-guide-writerCreate or refresh the root-tracked session guidesubagenthidden
summarizerProduce final user-facing summarysubagenthidden

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.