About goal-kit

Goal Driven Development - Transform software development from task execution to outcome achievement with goal-driven development methodology.

n

Published by

nom-nom-hub

Visit View Profile

README.md

View on GitHub

🎯 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.

goal-kit