AGENTS.md git:20260808.310e347A

Immutable. This exact content never changes and is served at /api/v1/blob/ba51595d7d25e7cc.

# Agent Configuration

This project is the CLI for spec-driven development with coach and builder agents.

## Public Repo

This repository is public. Never put private information — client or project names, personal or agent-user details, credentials, internal hosts — in any file, commit message, or PR. See `CONTRIBUTING.md`.

## Agent Prompts

**Builder Agent:** `specs/builder-agent/builder.prompt.md`
- Use this for implementing assertions and making specs true

**Coach Agent:** `specs/coach-agent/coach.prompt.md`
- Use this for refining user requests into well-formed specs

## CLI Usage

This CLI tool allows you to run spec-driven development workflows externally:

- `spekk coach` - Start the coach agent for spec creation
- `spekk builder` - Start the builder agent for implementation
- `spekk next` - Get the next priority assertion to work on

## Project Structure

- `cmd/spekk/` - CLI entry point
- `internal/` - Core Go packages (parser, agent, cli, show, serve, sandbox, status)
- `specs/` - Specification files organized by feature

## Development

- `go build ./cmd/spekk` - Build the binary
- `go test ./...` - Run all tests