Intent-Driven Repos
Documentation and guides for OutcomeDev.
OutcomeDev transforms how you create repositories. Instead of writing a flat description, you describe your intent, what you envision doing with the repo, and AI generates the rest.
How It Works
- Click "New Repo" and fill in your repository name and owner.
- Choose a Template: Select from our Template Center containing 48+ production-ready foundations. Whether you need a minimal Nuxt starter, a full-stack T3 Stack project, or a specialized LangGraph AI agent, our curated catalog ensures you start with the best possible structure.
- Type your intent in the "Custom Intent" field. Be as specific or as broad as you like. For example:
- "Build a SaaS platform for managing construction project timelines"
- "Create an AI-powered newsletter that curates and summarizes industry news"
- "Set up a home automation system for managing smart devices via voice commands"
- Click "Create Repository" and watch the AI generate your project foundation and Outcome Spec in real time.
What Gets Generated
When you submit your intent, OutcomeDev's AI generates two things:
GitHub Description
A concise, professional one-liner that appears on your GitHub repository page. This is derived from your intent and suitable for public display.
Outcome Spec README
A full-fledged README.md following the Outcome Spec Framework, a 7-section blueprint that gives your repository immediate substance and direction:
| Section | What It Covers |
|---|---|
| Domain & Product | What the project is and the domain it operates in |
| North Star Outcome | The measurable success criteria, what "done" looks like |
| Scope & Boundaries | What's in scope, what's not, and hard boundaries |
| Expected Artifacts | Code, workflows, docs, reports, and other deliverables |
| Decision-Making Heuristics | How to prioritize and choose "what's next" |
| Safety & Compliance | Guardrails, red lines, and regulatory considerations |
| Feedback & Evolution Loop | How the spec itself evolves over time |
This README replaces the default GitHub-generated README and gives AI agents (and human collaborators) the full context needed to start working on your project immediately.
Why Intent Matters
The repository is not just a code container, it's the operating system for a real-world outcome. Whether you're building an app, managing a farm, orchestrating a newsletter, or training a robot, it all starts with the repo.
By seeding your repository with an AI-generated Outcome Spec, you're creating the foundation for:
- AI-powered outcome generation, OutcomeDev can read your Outcome Spec and suggest targeted tasks
- Contextual agent work, When agents run tasks on your repo, they have full context from the spec
- Living documentation, Your README evolves as you complete outcomes and update the spec
After Creation
Once your repository is created, you're automatically redirected to the home page with your new repo pre-selected. From there, you can:
- Click "Generate for Me" to have AI propose outcomes based on your Outcome Spec
- Start creating tasks immediately with full repo context
- Invite collaborators who can instantly understand the project's direction from the README