onehammer-forge

Implements planned feature beads through Herdr writers with independent verification and evidence gates.

28|7|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/DK625/OneHammer --skill onehammer-forge-dk625
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: onehammer-forge
Source: https://github.com/DK625/OneHammer/tree/main/.claude/skills/onehammer-forge
Command: npx skills add https://github.com/DK625/OneHammer --skill onehammer-forge-dk625

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Executing a fully planned feature across many task beads requires disciplined coordination: claiming work in dependency order, delegating implementation to isolated writers, and independently verifying every change before closing tasks. This Skill automates that entire execution loop so a planned feature is implemented end-to-end without losing state, duplicating writers, or accepting unverified work. ## Core Features & Use Cases - Bead-driven execution loop: Reads ready beads from the Beads manifest, claims them deterministically by dependency and priority, and processes them sequentially through a single reusable Herdr writer target. - Durable execution state: Records base SHA, branch, canonical bead IDs, and per-bead progress in .planning/executions/<feature>/forge-state.json, enabling safe resume after interruption. - Independent verification and evidence gates: Inspects diffs and transcripts, reruns targeted tests, and requires runtime/E2E evidence (numbered screenshots, README mapping) before closing any bead. - Use Case: After completing a Phase 6 plan for a new checkout feature, invoke Forge once and it claims each bead, delegates implementation to a Herdr writer, verifies the results, collects E2E screenshots, and finishes with a full report of changed files, tests, and residual risks. ## Quick Start Ask the assistant to run /onehammer:forge for your planned feature so it implements every bead, verifies each one, and reports the evidence.

Frequently Asked Questions about onehammer-forge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I execute a planned feature with Claude Code beads?

Invoke /onehammer:forge with the feature slug after planning reaches Phase 6. It reads ready beads via br, claims them in dependency order, delegates implementation to a Herdr writer, verifies each result independently, and closes beads only when their evidence contract is satisfied.

What is Herdr and how does it coordinate coding agents?

Herdr is a CLI transport layer that carries prompts, pane output, transcripts, and process visibility for execution agents. It is not a task database: beads remain the source of truth for readiness and ownership, while repository diffs and validation prove completion.

Can I run multiple writer agents in parallel on one feature?

Yes, but only with isolated Git worktrees. Each parallel writer needs an independent bead, unique branch, separate worktree, and its own Herdr target with non-overlapping write scope. A shared checkout permits at most one writer at a time.

What happens if a Herdr writer times out or stops responding?

A timeout is treated as an observation point, not a failure. The coordinator inspects the process, transcript, cwd, branch, and Git state before deciding, and never launches a duplicate writer until the prior execution is proven absent, failed, or abandoned.

What evidence is required before a bead can be closed?

Each bead must satisfy its contract-specific evidence: implementation beads need code and automated tests, runtime-verification beads need real service or API proof, and E2E beads need numbered screenshots plus a README mapping steps to results. Herdr state or agent claims alone are never sufficient.