agentleFS
sam-ash-cysam-ash-cy/sams-agentic-workflow/skills/router/SKILL.md

router

Skill2 starsChanged 10 days agoMITView on GitHub

Use at the start of every coding task (feature, bug, refactor, config change, design, investigation). Classifies the task into a tier and playbook, says both in one line, then follows that path. The user can override with "tier=<t>", "playbook=<p>", "tone=<t>" or "max_words=<n>".

17 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use research and setup.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • NVIDIASkill

    research

    Before designing a feature, research how comparable libraries solve the problem, check best practices, known pitfalls, and upstream changes. Use when starting a new feature, investigating an unfamiliar area, or the user asks to research something.

    Also in 3 projects that use this

  • VercelSkill

    setup

    Set up Vercel CLI and project configuration. Use when the user says "set up Vercel", "configure Vercel", "link to Vercel", or "vercel init".

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

3 rules. 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 13 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Run saw task status and use its label:

    line 43
  2. Distinctive:

    Verified: every required check passed in this task.

    line 44
  3. Distinctive:

    After the report, suggest at most two follow-up features or improvements, each one line, and ask which (if any) the user wants.

    line 51

“Common” is measured: kept by at least 6 in 10 of the 13 edited versions of this file we could read. “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
SKILL.md

1. Classify (one line, then go)

Say: Tier: <tier> · Playbook: <playbook> · Style: <tone>, ≤<n> words · <reason in ≤10 words>. If the user overrides it, use theirs. The style comes from saw style (or the saw task start output); a per-task override ("this task: tone=verbose") goes to saw task start ... --tone <t> --max-words <n>.

TierSignals
trivialtypo, copy, one-line config, rename in one file; no behaviour change
standarda normal feature or bug fix inside existing structure
complexnew subsystem, new integration, cross-cutting change, unclear design
criticalauth, permissions, secrets, payments, data migration, infra, production

When unsure between two tiers, pick the higher. Then run saw task start --tier <tier> --playbook <playbook>. If the task begins a new phase, stage or feature, add --unit <phase|stage|feature> --unit-id <name> (e.g. --unit phase --unit-id phase-10); a follow-up fix within it leaves them out. If the session already finished a unit, saw session-hook warns or blocks ([sessions]): write the handoff (prompts/handoff.md) and suggest a fresh session. With features.ecc on, use ecc:strategic-compact to decide where to /compact and ecc:context-budget when context is tight from loaded skills, agents or MCP servers.

Playbooks (read only the one you picked, from playbooks/<name>.md): foundation · design · feature · integration · debug · spike · hardening · audit.

Tones: normal plain answer · structured bullets and tables, little prose · detailed reasoning and trade-offs · verbose full context and walkthroughs. The word cap counts prose only (code blocks, diffs and tool output don't count) and never drops the verification label.

2. Path by tier

  • trivial: implement → run the checks for touched files → report. No plan, no grilling, no subagents.
  • standard: write acceptance criteria → tdd → saw run each required check → code review + security review → report → PR. With features.implementer on, you plan and review: after the criteria, run saw task phase implement and hand each unit to the implementer agent with model: set to models.roles.implement, then saw task phase review and review its diff here before the checks. The guard hook denies a saw agent call on the wrong model, and stops this session editing source while the implementer owns it.
  • complex: grilling (always) → research → 2–3 options with trade-offs → independent review → ADR in docs/decisions/ → wait for design approval → staged plan → the standard path per unit.
  • critical: the complex path + threat model + rollback plan + the hardening playbook. Ask before any deploy.

Phase in debugging when needed. Switch to the debug playbook (saw task start --tier <same> --playbook debug, or keep the tier and follow playbooks/debug.md) as soon as any of these is true:

  • the user reports a bug or failure
  • the same check fails twice in this task
  • a fix attempt didn't change the failure Reproduce before changing code. If you're still stuck after that, follow prompts/stuck.md.

saw config get verify.<tier>.run lists the required checks. If an assumption turns out wrong, stop and re-plan; don't keep following a broken plan.

3. Evidence

  • Mechanical checks: saw run <check> (it prints only failures and records the result).
  • Judgement checks (code_review, security_review, threat_model, rollback_plan for critical): do the review, then saw task record <check> pass|fail --note "<one line>".
  • If verify.require_review_evidence is on (saw config get verify.require_review_evidence), a review pass needs a report from this task. agent: save the code-reviewer or security-reviewer agent's report, unedited, to .saw/reviews/<check>-<short-name>.md and add --report <that file> (or run saw review-session run). review_session: run saw review-session run; only a session saw started counts. If the record is refused, the review is not done: never write or edit a report yourself.
  • A check counts only if it ran in this task. Never report one from memory.

4. Report (end of task)

Run saw task status and use its label:

  • Verified: every required check passed in this task.
  • Partially verified: some passed, some did not run (say which and why).
  • Not verified: none ran (say why, e.g. no Docker here).
  • Blocked: a check failed and is not fixed. For a PR description, paste saw task report. Then saw task end. A Stop hook blocks "done" while required checks are missing or failing. If a check failed during the task, run saw retro; any proposal it writes is handled with the retro-promote skill.

5. Suggest

After the report, suggest at most two follow-up features or improvements, each one line, and ask which (if any) the user wants.

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.