🎯 Goalkit
The Framework for Goal-Driven Development (GDD)
Anchor your AI agents in outcomes, not just code. No external APIs. Fully offline. Pure Markdown.
Quick Start | Methodology | Documentation | Contributing
🚀 Stop "Vibe-Coding." Start Delivering.
AI agents are incredible at writing code, but they often lack strategic alignment. Without a framework, agents tend to "vibe-code"—implementing features without clear success metrics or strategic trade-offs.
Goalkit implements Goal-Driven Development (GDD), a methodology that forces AI agents to:
- Define the "Why" before the "How."
- Quantify Success with measurable metrics.
- Explore Strategies instead of picking the first path.
- Validate Progress through evidence-based milestones.
🛠️ Quick Start
1. Install Goalkit
uv tool install --from git+https://github.com/Nom-nom-hub/goal-kit.git goalkit
2. Initialize Your Project
goalkit init my-project
cd my-project
3. Activate Your AI Agent
Open your project in Claude Code, Cursor, or Copilot and run:
/goalkit.vision
[!IMPORTANT] Goalkit generates a
CLAUDE.md(or.cursorrules) that contains the GDD Protocol. Your agent will automatically follow the strict workflow once initialized.
📖 The GDD Methodology
Goalkit isn't just a CLI; it's a structured workflow enforced through local scripts and markdown files.
The 5-Step Alignment Loop
| Step | Command | Outcome |
|---|---|---|
| 1. Vision | /goalkit.vision |
Establishes the project's "North Star" and principles. |
| 2. Goal | /goalkit.goal |
Defines a measurable, tech-agnostic outcome. |
| 3. Strategy | /goalkit.strategies |
Compares 3+ implementation paths and trade-offs. |
| 4. Milestone | /goalkit.milestones |
Breaks the strategy into measurable checkpoints. |
| 5. Execute | /goalkit.execute |
Implements, measures, and adapts in real-time. |
🏗️ How It Works
Goalkit creates a "shadow infrastructure" in your project that agents use to stay aligned.
flowchart LR
You -->|"/goalkit.vision"| Agent
Agent -->|"runs create-vision.sh"| Scripts
Scripts -->|"creates vision.md"| Files
Files -->|"read by agent"| Agent
Agent -->|"reports back"| You
- No External APIs: Works fully offline. Your data stays in your repo.
- Agent-Agnostic: Works with Claude, Cursor, Copilot, Gemini, and more.
- Git-Integrated: Automatically manages branches and commits for your goals.
📊 CLI Features
Real-time project health and goal completion insights.
goalkit status: Get a snapshot of project health and actionable insights.goalkit check: Verify available AI agents and system prerequisites.goalkit milestones: Track progress across all active goal branches.goalkit report: Generate professional progress reports for stakeholders.
👥 Contributors 💙
A huge thank you to the pioneers of Goal-Driven Development:
| Contributor | Role |
|---|---|
| Teck | Creator & Maintainer |
| shivam2931120 | Core Methodology & Testing |
Want to see your name here? Check out CONTRIBUTING.md and open a PR!
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
Goalkit: Focus on outcomes, not implementation details.