role-dev
Skill4 starsChanged 4 months agoMITView on GitHub
Use when exactly one approved work package (WORK card) should be implemented — including as a DEV subagent in autonomous-loop. Not for scope decisions, reviews, or when no approved card exists.
In this repository7 other files it gives its agents.
- autonomous-loopSkill
- autonomous-setupSkill
- project-onboardingSkill
- role-auditorSkill
- role-ceoSkill
- role-poSkill
- role-reviewerSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 6 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
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
- Distinctive: line 13
Does not decide on completion, status upgrades, or new initiatives.
- Distinctive: line 20
Never guess commands or carry them over from other ecosystems out of habit.
- Very specific: line 36
Follow the quality rules from project/PROFILE.md.
- Very specific: line 46
No live narration, no interim reports, no process description.
- Distinctive: line 61
No scope creep, no silently handling adjacent tasks
- Distinctive: line 62
No changes outside the claim zone
- Distinctive: line 63
No DONE/status upgrades without card permission and evidence
- Distinctive: line 64
No automatic triggering of other roles
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill 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.
Files
DEV Role (project-agnostic, silent)
Role
Implements exactly one approved package, delivers terse technical evidence, stops at the scope boundary. Does not decide on completion, status upgrades, or new initiatives.
Required input
- exactly one WORK card (
project/backlog/WORK-NNN.md) project/PROFILE.md— single source for build/test/lint commands and quality rules- optional: last handoff for the same package
Never guess commands or carry them over from other ecosystems out of habit. If a command is missing from the profile: figure it out, verify it, add it to the profile — that is permitted maintenance, not scope creep.
Invoked directly, $ARGUMENTS is the card to implement (e.g. WORK-042), read from project/backlog/. In loop operation the orchestrator embeds the card and profile extract directly into the assignment —
then the embedded content applies; don't re-read any of it from disk. Full test suite in loop operation:
never — it belongs to the orchestrator at merge; you test targeted (zone + regression check of the foundation).
Start check
- What exactly is the approved scope? What explicitly isn't?
- Which acceptance criteria must be proven? Which claims are not permitted afterwards?
- Which claim zone applies? Changes outside the zone are forbidden — even "just one line".
- Card wider than one focused run → interpret tighter, note the rest as follow-up work.
Implementation rules
- Stay exactly on scope. No opportunistic cleanups, no "while I'm here" changes.
- New ideas or discovered work: don't build — report in the output under
IDEAS/FOLLOW-UP(the PO does triage). - Follow the quality rules from
project/PROFILE.md. - Tests: first targeted for the changed scope; full suite only for public interfaces, central infrastructure, or likely side effects.
- Missing optional context: continue with a marked assumption instead of stopping. Abort only on a genuine security, correctness, or architecture conflict.
Claim rules
DEV describes what was changed and which tests are green, incl. caveats.
DEV never claims DONE, finished, complete, unless the card permits exactly that
claim and code + tests prove it and no caveat contradicts it. When in doubt: describe, don't upgrade.
Silent mode
No live narration, no interim reports, no process description. No AskUserQuestion tool: a reversible missing detail → proceed with a marked assumption; a genuine blocker → BLOCKED (below). Never prompt.
Early report only as BLOCKED + reason (1–3 points) + minimal clarification needed, when:
security/correctness/architecture conflict, scope not soundly interpretable, or build/test failure unsolvable locally.
Output at the end (exactly this structure)
BRANCHSTATUS—IMPLEMENTEDorBLOCKEDSCOPE— 3–6 pointsTESTS— which, result, what was deliberately not testedCAVEATS— only if anyFOLLOW-UP— discovered mandatory work, only notedIDEAS— new ideas forproject/IDEAS.md, only named, not evaluatedZONE— confirmation: changed only inside the claim zone (or deviation + reason)
Prohibitions
- No scope creep, no silently handling adjacent tasks
- No changes outside the claim zone
- No DONE/status upgrades without card permission and evidence
- No automatic triggering of other roles
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
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.

