krishpunjabi.com ~/skills

← all commands

/implementer

/implementer agents

Implements one well-specified issue from a kickoff brief on its own branch, commits small, runs the tests, and ends with a handoff document. Cannot push protected branches or merge PRs (hook-enforced); local merges are left to the caller. Use for scoped implementation delegated by an orchestrator or manager.

  • author Krish
  • invocation subagent (Agent tool)
  • model sonnet
  • preloads /handoff-auto, /session-handoff
  • guard guard-git.py hook
  • prereqs handoff-auto and session-handoff installed.
  • tested used daily
  • suggested model · effort sonnet · medium

Install

Install just this, from a clone of the repo. Anything it needs comes with it.

./scripts/install-skills.sh --skill implementer   # bash, Git Bash, macOS, Linux
.\scripts\install-skills.ps1 -Skill implementer   # Windows PowerShell

Needs: handoff-auto, kanban-setup, next, session-handoff, the guard-git hook (installed with it).

What it does

Implements one well-specified issue from a kickoff brief on its own branch.

  • maxTurns: 200.

How to invoke

Agent(subagent_type="implementer", prompt=…)

You pass: The kickoff brief verbatim + branch prefix + protected branch + decisions (from manager or the orchestrator).

How it works

  • Branches off a freshly pulled default (the brief's Branch verbatim, else <prefix>/issue-<n>-<kebab-title>).
  • If it created the branch, its handoff lists a manual step for the caller: move the card to In Progress and comment "Started on branch …". Its own gh is read-only.
  • Commits small.
  • Runs the repo's detected test command before claiming done.
  • Multi-session task or low turns → writes the handoff early.
  • Stuck or past ~100k tokens: writes skilleddocs/HANDOFF.md (done / not done / next step / failed attempts), then stops, so a manager can restart a fresh implementer from it. It commits that file only if TRACKING.md says so (never on a fork).

Design principles

  • One issue, one session, small commits.
  • "Done" means it watched the tests pass.
  • Push and PR merge belong to the caller; the hook blocks pushes to protected branches and PR merges (local git merge is left to the caller).
  • Board errors never block, they go in the handoff.

Shared context for these principles: Matt Pocock's video.

Use cases

  • The worker under a manager (via pair) or directly under meta-orchestrator with shape: flat, or on haiku per item of a swarm batch.
  • Any well-specified issue you want implemented unattended.

Tips

  • Give it a real kickoff brief (checklist, key files, branch prefix, protected branch); scope that grows past one session makes it stop early and hand off.
  • A guard-hook block is reported, not worked around.
  • Its last output line is the handoff path, which callers read.

Example

One issue through planner, manager and verifier, as an orchestrator (or you) calls them. The manager briefs and spawns its own implementer inside its turn, so only the manager's report comes back. You push and merge in between:

Agent(subagent_type="planner", prompt="~/code/myrepo; exclusions: label needs-design; order: priority label") (+7 lines)
Issue: #31 Add CSV export (checklist: 3 items) Key files: src/export.py, tests/test_export.py Constraints: none Branch: feat/issue-31-csv-export Gotchas: none Size, shape, model: small, pair, sonnet: narrow and well-specified Divide: no
Agent(subagent_type="manager", prompt="working directory: /home/you/code/_worktrees/myrepo-issue-31-csv-export; <the brief, verbatim>; prefix=feat; protected=main; max_rounds=3; never push or merge") (+7 lines)
Branch: feat/issue-31-csv-export, base 1a2b3c4, head 5d6e7f8 Commits: 5d6e7f8 feat: CSV export (#31) Tests: pytest, 118 passed; lint clean (run by me) Findings: none Rounds: 1 of 3 Unfinished: none Manual steps for caller: push, open the PR, merge
Bash(git push -u origin feat/issue-31-csv-export && gh pr create --fill) (+1 line)
https://github.com/you/myrepo/pull/44
Merged PR #44; saved the manager's report to skilleddocs/orchestrator/reports/.
Agent(subagent_type="verifier", prompt="skilleddocs/orchestrator/reports/<#31 report>; interview=park; review-done=yes") (+5 lines)
Verified by: 118 passed · CI run 9876543210 Findings: none Decided for you: none Manual steps for user: none 1. #28 Rework auth flow (unestimated, strong model: needs-design)

Prereqs

  • handoff-auto and session-handoff installed.
  • gh for reads (card moves are the caller's).
  • Python 3.8+ (and Git Bash on Windows) for the guard hook.

You get back

  • A handoff written by session-handoff (which wraps handoff-auto).
  • Final message ends with the handoff document's absolute path on its own line.
  • The handoff cites any open A-n it assumed.

Guard

guard-git.py hook (below).

Sample workflows

  • Run the backlog unattended
    you → lanes → you → meta-orchestrator → planner → manager → implementer → verifier → you → switch → remind → progress-report → you
    Install just this one: ./scripts/install-skills.sh --workflow unattended-backlog or .\scripts\install-skills.ps1 -Workflow unattended-backlog
  • One issue to a reviewed PR
    pair → manager → implementer → you → pr-watch → you
    Install just this one: ./scripts/install-skills.sh --workflow pair-to-pr or .\scripts\install-skills.ps1 -Workflow pair-to-pr
  • Match each issue to a shape: swarm, pair or flat
    you → meta-orchestrator → planner → implementer → manager → verifier → you
    Install just this one: ./scripts/install-skills.sh --workflow orchestration-shapes or .\scripts\install-skills.ps1 -Workflow orchestration-shapes

Source

Use cases & tips from the community