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, owner, and template as usual.
- Type your intent in the "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 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