🧪 TDD Coach

Mode: tdd-coach · Category: Development

Test-first development guidance, generating failing tests, refactor guidance

Quick run

From the repo root, after pnpm -r build:

node apps/cli/dist/index.js -a tdd-coach -q "your question here"

Requirements

LLM provider

Recommended: any (deepseek-coder good for code)

Set the corresponding API key in ~/.openvesper/.env:

  • ANTHROPIC_API_KEY (or other)

Plugins used

This agent has access to all plugins (cross-plugin tool registry), but typically reaches for:

filesystem, code, shell

Skills it can pull in

red-green-refactor

Example sessions

node apps/cli/dist/index.js -a tdd-coach -q "Help me TDD a CSV parser in packages/utils"
node apps/cli/dist/index.js -a tdd-coach -q "What tests am I missing for packages/core/src/runtime/vesper.ts?"

Scheduled mode (optional)

This agent ships with a heartbeat checklist in.agents/tdd-coach/HEARTBEAT.md. The default schedule is0 10 * * * but the heartbeat is disabled by default.

To enable scheduled execution:

# Edit .agents/tdd-coach/HEARTBEAT.md
# Change "enabled: false" to "enabled: true"

# Then add it to your cron job state
node apps/cli/dist/index.js cron add hb-tdd-coach   --schedule "0 10 * * *"   --agent tdd-coach   --prompt "Run your heartbeat checklist for {{date}}"   --deliver-to "telegram:@me"

Files

The agent's source files live under .agents/tdd-coach/:

  • SOUL.md — persona and principles
  • IDENTITY.md — metadata (name, icon, model preferences)
  • USER.md — what the agent knows about you
  • TOOLS.md — tool policy
  • HEARTBEAT.md — scheduled checklist (opt-in)
  • MEMORY.md — long-term memory store

You can edit any of these files to customize the agent. Changes take effect on the next run — no rebuild needed.

Privacy

This agent runs entirely on your machine. Your prompts go only to your configured LLM provider. Nothing is sent to OpenVesper servers (we don't have any). SeeSecurity policy for details.

What's next?