Use case

Run PRD-driven coding agents

Use Hal to turn product requirements into small AI coding iterations with validation, review, CI, reporting, and archived state.

brew tap j-yw/tap && brew install --cask hal
Short answer

Hal gives AI coding agents a structured loop: start from a PRD, implement one story at a time, keep state, and produce reviewable progress.

The agent workflow gap

AI coding agents can implement a lot of work quickly, but they still need structure. Without a loop, a developer has to manually decide the next task, rewrite context, check progress, run review, and clean up state.

A PRD-driven workflow solves part of the problem by defining what should be built. Hal solves the loop around it.

How Hal structures the work

Hal stores project workflow state in .hal/, reads product requirements, and runs implementation iterations against structured user stories. It can generate or convert PRDs, validate them, run the coding loop, and update progress as stories complete.

Each iteration has a narrow target. That keeps the agent focused and makes the result easier to review.

A practical workflow

  1. Initialize Hal in the repository.
  2. Capture the feature as a PRD.
  3. Convert and validate the PRD.
  4. Run a bounded number of implementation iterations.
  5. Review, test, report, and archive the completed feature state.

For teams that want more automation, hal auto can run a fuller pipeline from analysis through archive.

Why fresh context matters

Fresh context reduces the chance that an agent carries old assumptions into the next story. Hal keeps persistent state in files while giving each implementation pass a cleaner working window.

When to use this workflow

Use PRD-driven coding agents when the feature has multiple steps, when you need an audit trail, when you want CI and review gates, or when a solo founder needs to run development loops without acting as a full-time project manager.

FAQ

How do I run an AI coding agent from a PRD?

Use a structured workflow that converts requirements into stories, validates the work, then runs an agent one iteration at a time. Hal provides that CLI workflow.

Why not use one long agent session?

Long sessions can lose focus and mix unrelated context. Hal gives each story a fresh context window and keeps progress in explicit project state.

Can Hal work with different coding agents?

Yes. Hal supports pluggable engines including Codex, Claude Code, and Pi.

Next step

Run autonomous PRD-driven coding loops with AI agents.

Get Hal