vfedotovs

Agentic Dev — Development skill for Claude Code

Development community

Turns a checked-in plan.md into reviewed pull requests.

How to install Agentic Dev

This entry records only its repository, not the path inside it, so there is no exact command to give. Open vfedotovs/agentic-dev and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agentic Dev does

Turns a checked-in plan.md into reviewed pull requests. Three cron-driven stages — slice into issues, write failing tests, then implement until green — each running Claude Code or Grok in a disposable Docker container. Test-first by construction; human review is the only merge gate.

Alternatives in Development

Clawk — Give coding agents a disposable Linux VM, not your laptop 996 ★
Taskmaster — Stop hook for Claude Code that keeps the agent working until all plans and user requests are 100% complete 494 ★
Convex Cron Jobs 354 ★

README

agentic-dev

A three-stage agentic pipeline that turns a checked-in `plan.md` into merged pull requests, so a Python project can go from 1–2 hand-written PRs/week to 10–20+ agent-produced PRs/week — with **human review as the only merge gate**.

plan.md ─▶ [1 slice] ─▶ GitHub issues ─▶ [2 write-tests] ─▶ failing-tests branch ─▶ [3 implement] ─▶ PR ─▶ human review ─▶ merge
             daily              ≤10/day                          ≤10/day
                                              [gc] daily: retire stale branches/PRs, unstick dead runs

Each stage runs an agent CLI — `claude` (Anthropic) or `grok` ([xai-org/grok-build](https://github.com/xai-org/grok-build)), selected with `AGENT_BACKEND` — inside a disposable Docker container, does one unit of work, and hands off through **issues** and **branches/PRs** — never shared local state. See [`agentic-dev-plan.md`](agentic-dev-plan.md) for the full design rationale, label state machine, rollout plan, and failure-mode analysis.

Repository layout

agentic-dev-plan.md            design doc (read this for the "why")
README.md                      this file
Dockerfile                     builds agentic-dev:{claude,grok}-latest
.dockerignore                  build context is an allowlist: agentic/ only
Makefile                       build / run / operate targets (`make help`)
examples/plan.md               sample plan.md the slicer consumes
agentic/
  entrypoint/                  run INSIDE the container, one unit of work each
    slice.sh                   Stage 1  — plan.md -> issues
    write-tests.sh             Stage 2  — issue -> failing tests   (env: ISSUE)
    implement.sh               Stage 3  — failing tests -> green -> PR (env: ISSUE)
    gc.sh                      housekeeping
  lib/
    common.sh                  shared bash helpers: phases, the exit trap,
                               budget_guard, run_agent, the heartbeat
    stream_filter.py           summarises the agent's NDJSO