Goal Kit

A Goal-Driven Development toolkit for AI agents. Define outcomes, explore strategies, and execute with measurable progress — all through natural conversation with your AI coding assistant.

Install Goal Kit Quick Start →

Why Goal Kit?¶

🎯

Outcome-Driven

Focus on measurable success criteria, not feature checklists. Define what "done" looks like before you start.

🧭

Strategy Exploration

Explore multiple implementation approaches before committing. Compare trade-offs and pick the best path.

📊

Measurable Progress

Break goals into milestones with clear success metrics. Track velocity, momentum, and health scores over time.

🔄

Adaptive Execution

Treat plans as hypotheses. Pivot when metrics show a better path. Learn and adapt continuously.

🤖

AI-Native

Works with Claude Code, GitHub Copilot, Gemini CLI, Cursor, and all major AI coding assistants.

⚡

Zero Config

One command to initialize. Your AI agent handles the rest — scripts, files, context, and progress tracking.

Quick Start¶

1. Install Goal Kit

uv tool install goalkit --from git+https://github.com/Nom-nom-hub/goal-kit.git

2. Initialize a project

goalkit init my-project
cd my-project

3. Start with your AI agent

/goalkit.vision Create a vision focused on user outcomes and measurable success

That's it. Your AI agent handles the rest — creating goals, exploring strategies, tracking milestones, and measuring progress.

Predictive Analytics¶

Goal Kit can forecast your goals, not just track them. The goalkit predict command group uses your recorded velocity history to answer the questions that matter:

goalkit predict completion                      # When will this goal be done?
goalkit predict risk --deadline 2026-10-15      # Will we miss the deadline?
goalkit predict velocity --deadline 2026-10-15  # What pace do we need?
goalkit predict scenarios --deadline 2026-10-15 # What if we add resources or cut scope?

Every command supports --output json for scripting and agent integration. See the Analytics Guide for interpretation tips.

How It Works¶

Goal Kit implements a structured workflow that guides you from vision to execution:

Step	Command	What Happens
1	`/goalkit.vision`	AI agent creates `.goalkit/vision.md` with your project principles
2	`/goalkit.goal`	Agent creates a goal directory with measurable success criteria
3	`/goalkit.strategies`	Agent explores 3+ implementation approaches and documents trade-offs
4	`/goalkit.milestones`	Agent breaks the goal into measurable progress checkpoints
5	`/goalkit.execute`	Agent implements with continuous measurement and adaptation

Supported AI Agents¶

Goal Kit works with all major AI coding assistants:

Claude Code · GitHub Copilot · Gemini CLI · Cursor · Qwen Code · opencode · Codex CLI · Windsurf · Kilo Code · Auggie CLI · Roo Code · Amazon Q Developer CLI