HelmIt
HelmIt helps you guide software projects with coding agents. It adopts Spec-Driven Development (SDD) proportionally: the expected outcome and how to verify it are recorded before implementation, without requiring a long spec for every correction. You decide the important commitments; the agent organizes the work and preserves progress between sessions.
- Goal
- Specification
- Implementation
- Verified delivery
Set the goal. Record progress. Verify the delivery.
From outcome to delivery
Section titled “From outcome to delivery”The project’s goal, requirements, and current position are recorded in the repository. When you change conversations or agents, work can continue from that context without depending on one open session’s memory.
The agent plans and implements changes within the scope you authorized. Completed tasks receive focused checks; delivery closes with complete proof and the relevant acceptance criteria. Decisions that need your judgment stay visible to you.
Solo work and collaboration
Section titled “Solo work and collaboration”HelmIt is especially useful when you develop with agents on your own: it keeps the backlog, tasks, decisions, and proof in the repository so work is not lost between sessions. Another person can also take over a delivery from that shared context.
In a team, it helps guide and verify each delivery when someone is responsible for integrating it. HelmIt does not assign tasks to people or replace the tools the team uses to coordinate its work.
A simple core that stays out of the agent’s way
Section titled “A simple core that stays out of the agent’s way”HelmIt does not impose a prescribed persona on the agent. It gives intent, state, and proof a clear home while the agent uses its own capabilities to understand and change the project.
The core depends on no cloud service, database, or extra runtime layer. Artifacts live in the repository, and the core uses Bash and the Python standard library. Rather than a subjective score from another model, HelmIt favors deterministic proof: executable checks and acceptance criteria that can be examined.
Start in your project
Section titled “Start in your project”Install the plugin in Claude Code or Codex. In the project you want to guide,
run helmit:setup once to prepare its HelmIt files. Then helmit:next
reads the recorded position and offers the next action.
Follow Install and get started for platform-specific commands. The process map shows how project preparation connects to delivery by phases.