disinto/VISION.md

# Vision

Disinto is an opinionated, lightweight framework that lets **solo entrepreneurs** automate their software startup — from first commit to market fit.

## Who it's for

Solo founders and small teams building in the **software and crypto** space. People who want to ship a web app or launch a token without hiring a team of ten. Disinto is the team.

## What it does

A solo founder sets the vision and defines quality gates. Disinto derives the backlog and handles the rest:

- **Build**: dev-agent picks up backlog issues, implements in isolated worktrees, opens PRs
- **Review**: review-agent checks PRs against project conventions, approves or requests changes
- **Ship**: CI runs, PRs merge, deployments happen — the vault controls what needs your sign-off
- **Operate**: supervisor monitors health, fixes what it can, escalates what it can't
- **Plan**: planner compares project state against this vision, creates issues for gaps
- **Groom**: gardener maintains the backlog — closes duplicates, promotes tech debt, keeps things moving

## Target projects

- **Web applications** — SaaS, dashboards, APIs
- **Cryptocurrency projects** — smart contracts, DeFi protocols, token launches
- **Any repo with a CI pipeline** — if it has tests and builds, Disinto can work it

## Design principles

- **Opinionated over configurable** — good defaults, few knobs. Works out of the box for the common case.
- **Bash over frameworks** — if it can be a shell script, it is. Claude is the only dependency that matters.
- **Pull over push** — agents pull work when ready. No scheduler, no queue, no orchestrator daemon.
- **One PR at a time** — sequential pipeline. Saves compute, avoids merge conflicts, keeps the factory predictable.
- **Self-improving** — when an agent solves a new problem, the lesson is captured for next time.

## Growth goals

- **Attract developers** — the project should be easy to understand, easy to fork, easy to contribute to.
- **Stars and forks** — measure traction through forge/GitHub engagement.
- **Contributors** — lower the barrier to entry. Good docs, clear architecture, working examples.
- **Reference deployments** — showcase real projects built and operated by Disinto.
- **Vault as differentiator** — the quality gate model (vision + vault) is what sets Disinto apart from generic CI/CD. Make it visible and easy to understand.

## Milestones

### Foundation (current)
- Core agent loop working: dev → CI → review → merge
- Supervisor health monitoring
- Planner gap analysis against this vision
- Multi-project support with per-project config (harb, disinto, versi)

### Adoption
- One-command bootstrap for new projects (`disinto init`)
- Documentation site with quickstart, tutorials, architecture guide
- Example project that demonstrates the full lifecycle
- Landing page that communicates the value proposition clearly

### Scale
- ~~Multi-project support (multiple repos, one factory)~~ — done (Foundation)
- Plugin system for custom agents
- Community-contributed formulas for common project types (Next.js, Solidity, Python)
- Hosted option for founders who don't want to run their own VPS