agentleFS
cykedevcykedev/vereinsheim/.claude/skills/implement/SKILL.md

implement

Skill1 starsChanged 13 days agoApache-2.0View on GitHub

Execute an approved plan from plans/<...>.md — autonomously by default (ADR-023). Grinds the plan task by task (one focused commit each, pnpm check as gate), halting only at circuit-breakers and the user-gated merge. Use after /plan is approved and the branch + plan-commit exist.

  • Deletes or force-pushes

192 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use setup-ts-deep-modules, ask-matt and 10 more.

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.
  • liufeng1976Skill

    setup-ts-deep-modules

    Wire dependency-cruiser into a TypeScript repo so each package is a deep module — implementation hidden in subfolders, reachable only through its entry-point files. User-invoked.

    Also in 43 projects that use this

  • GoogleSkill

    ask-matt

    Ask which skill or flow fits your situation. A router over the skills in this repo.

    Also in 91 projects that use this

  • RoentekSkill

    loop-me

    Grill me about specs for the workflows I want to build, within this workspace.

    Also in 50 projects that use this

  • AWSSkill

    to-questionnaire

    Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

    Also in 88 projects that use this

  • ryotaroh180105Skill

    claude-handoff

    Hand the current conversation off to a fresh background agent that picks up the work immediately.

    Also in 42 projects that use this

  • GoogleSkill

    to-spec

    Turn the current conversation into a spec and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

    Also in 168 projects that use this

  • +3 more from google

The file

Files
SKILL.md

PIV step 2 of 4. Autonom-by-default (ADR-023): Plan-Freigabe = die einzige Opt-in-Grenze; danach läuft die Umsetzung durch, bis ein Breaker greift oder der Plan fertig ist. Merge/Push/Deploy nach main bleiben user-gated. Für bewussten Einzelschritt: /implement --step (kein Marker → Guard No-Op, Halt nach einem Task).

Vor dem ersten Task: Plan + dessen ## Required Docs (App + vault/conventions.md) lesen.

Preflight (einmal pro Lauf)

  • Branch-Check: git branch --show-current beginnt mit feat/ (nie autonom auf main/Default — Hard Rule 2). Sonst HALT („Autopilot nur auf feat/-Branch"). Ob die Umsetzung in einem Worktree läuft, hat die Hauptsession vorab entschieden (ADR-024) — der Autopilot prüft/erzwingt das nicht, er arbeitet im vorgefundenen Tree.
  • Plan unter plans/<…>.md; Ledger reports/<plan-stem>-autopilot.md lesen/anlegen (Plan-Pfad, Branch, Cap 20, Iterations-Zähler, Fortschritts-Checkliste, Ereignis-Log).
  • Marker .claude/.autopilot-active schreiben (außer bei --step): aktiviert den autopilot-guard-Hook. Bei --step keinen Marker setzen. Existiert beim Start bereits ein Marker, ist das ein Resume — ihn neu schreiben (auffrischen), nicht stehenlassen.

Iteration = ein Plan-Task

  1. Nächsten Task aus dem Ledger wählen (erster nicht-done). Keiner offen → FINALIZE. Iterations-Zähler +1; > Cap → HALT (Breaker: Cap). Marker auffrischen (touch), damit der Guard über lange Läufe nicht via TTL als verwaist gilt.
  2. Ambiguität (Breaker): Task nicht konkret umsetzbar (keine klare Datei/Änderung, „TBD", offene Designfrage) → HALT.
  3. Scope (Breaker): Änderung muss in den vom Plan gelisteten, nicht-geschützten Pfaden bleiben. Geschützter Pfad / plan-fremde Datei → HALT. (Zusätzlich hart durch autopilot-guard erzwungen.)
  4. Implementieren — genau diesen einen Task. Test-first (TDD) für Logik, Server-Actions, Bugfixes: failing test → für den richtigen Grund fallen sehen → minimaler Code → grün refactoren. Pragmatische Ausnahme: reine UI/Config/Scaffolding bringt Tests im selben Commit. App-Konventionen befolgen (vault/apps/<app>/<app>-code-conventions.md, …-ui-patterns.md, vault/conventions.md), vorhandene Utilities/Patterns wiederverwenden. Die byte-identischen Dateien der Apps (MUST_MATCH in scripts/consistency-check.sh) synchron halten; Geteiltes gehört in packages/*.
  5. Gate: pnpm check. Grün → 6. Rot → self-heal, max. 3 Versuche insgesamt für den Task; danach weiter rot → WIP verwerfen (git checkout -- . && git clean -fd, Branch bleibt grün), Fehlschlag ins Ledger → HALT (Breaker: Gate rot).
  6. Commit — ein kleiner, fokussierter Commit (Conventional Commits, EN; kein Co-Authored-By). Hard-Rule-4-Ausnahme im autonomen Modus (ADR-023): die Message wird nicht vorab als fenced block gezeigt, sondern ins Ledger + git log geschrieben (vor dem Merge revidierbar). Bei --step gilt Hard Rule 4 normal. Task im Ledger als done mit SHA markieren.
  7. Weiter (mehr Tasks, Cap nicht erreicht) → nächste Iteration. Bei --step: hier HALT.

HALT / FINALIZE

  • Bei jedem HALT: Marker .claude/.autopilot-active entfernen (re-armt interaktives Editieren), Grund ins Ledger, dem User melden (kurz: welcher Breaker, welcher Task, was er entscheiden muss). Der User löst auf / passt den Plan an / überspringt; ein erneutes /implement nimmt den Lauf aus dem Ledger wieder auf. Bricht ein Lauf abnormal ab (Crash/Kill), bleibt der Marker liegen — manuell rm .claude/.autopilot-active (er ist gitignored); der Guard behandelt ihn nach MARKER_TTL_MS (8 h) ohnehin als verwaist.
  • FINALIZE (Plan abgearbeitet): Marker entfernen, Ledger-Zusammenfassung schreiben + committen, dann /validate.

Das Stop-Gate läuft ohnehin am Turn-Ende (pnpm check) — nie rot aufhören.

Sub-Agenten-Option (opt-in, nicht Default): bei großen, unabhängigen Task-Sets eine frische Agent pro Task; zwischen Tasks der code-reviewer-Agent.

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.