Boards & Goals

​

Boards

• board.repo_root is the authoritative path for all file operations
• Each board has its own configuration, goals, and tickets
• Cascade deletes: removing a board removes all its goals, tickets, and jobs

​

Goals

​

Creating a Goal

“Add user authentication with JWT tokens, login/logout endpoints, and protected route middleware”

curl -X POST http://localhost:8000/goals \
  -H "Content-Type: application/json" \
  -d '{
    "title": "User Authentication",
    "description": "Add JWT-based auth with login/logout and protected routes"
  }'

​

Goal → Tickets

1. AI Analysis — The LLM analyzes the goal and your codebase
2. Ticket Breakdown — Creates specific, implementable tickets
3. Dependency Mapping — Sets up blocking relationships between tickets
4. Priority Ordering — Assigns priority based on dependency graph

​

Goal Status

​

Cost Budgets

curl -X POST http://localhost:8000/goals/{id}/budget \
  -H "Content-Type: application/json" \
  -d '{"max_cost_usd": 5.00}'