agentleFS
BechsteinDigitalBechsteinDigital/claude-shiploop/role-dev/SKILL.md

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.

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
  1. Distinctive:

    Does not decide on completion, status upgrades, or new initiatives.

    line 13
  2. Distinctive:

    Never guess commands or carry them over from other ecosystems out of habit.

    line 20
  3. Very specific:

    Follow the quality rules from project/PROFILE.md.

    line 36
  4. Very specific:

    No live narration, no interim reports, no process description.

    line 46
  5. Distinctive:

    No scope creep, no silently handling adjacent tasks

    line 61
  6. Distinctive:

    No changes outside the claim zone

    line 62
  7. Distinctive:

    No DONE/status upgrades without card permission and evidence

    line 63
  8. Distinctive:

    No automatic triggering of other roles

    line 64

≈ “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.

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

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

  1. exactly one WORK card (project/backlog/WORK-NNN.md)
  2. project/PROFILE.md — single source for build/test/lint commands and quality rules
  3. 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)

  1. BRANCH
  2. STATUS — IMPLEMENTED or BLOCKED
  3. SCOPE — 3–6 points
  4. TESTS — which, result, what was deliberately not tested
  5. CAVEATS — only if any
  6. FOLLOW-UP — discovered mandatory work, only noted
  7. IDEAS — new ideas for project/IDEAS.md, only named, not evaluated
  8. ZONE — 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

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.