diff --git a/AGENTS.md b/AGENTS.md index 452f2fc..ab1f3d9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,9 +2,10 @@ ## What this repo is -Disinto is an autonomous code factory. It manages four agents (dev, review, -gardener, supervisor) that pick up issues from Codeberg, implement them, -review PRs, and keep the system healthy — all via cron and `claude -p`. +Disinto is an autonomous code factory. It manages five agents (dev, review, +gardener, supervisor, planner) that pick up issues from Codeberg, implement +them, review PRs, plan from the vision, and keep the system healthy — all +via cron and `claude -p`. See `README.md` for the full architecture and `BOOTSTRAP.md` for setup. @@ -15,6 +16,7 @@ disinto/ ├── dev/ dev-poll.sh, dev-agent.sh — issue implementation ├── review/ review-poll.sh, review-pr.sh — PR review ├── gardener/ gardener-poll.sh — backlog grooming +├── planner/ planner-poll.sh, planner-agent.sh — vision gap analysis ├── supervisor/ supervisor-poll.sh — health monitoring ├── lib/ env.sh, ci-debug.sh, matrix_listener.sh ├── projects/ *.toml — per-project config diff --git a/README.md b/README.md index d9e8428..00b3cfd 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@
- A tiny robot commanding a mountain-eating machine + A tiny robot commanding a mountain-eating machine

# Disinto diff --git a/VISION.md b/VISION.md new file mode 100644 index 0000000..c9e2cbb --- /dev/null +++ b/VISION.md @@ -0,0 +1,60 @@ +# 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 Codeberg/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 +- Single-project support with per-project config + +### 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) +- 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 diff --git a/site/al76.jpg b/site/al76.jpg new file mode 100644 index 0000000..6a9b2a3 Binary files /dev/null and b/site/al76.jpg differ diff --git a/site/al76.webp b/site/al76.webp new file mode 100644 index 0000000..5383eba Binary files /dev/null and b/site/al76.webp differ diff --git a/site/index.html b/site/index.html new file mode 100644 index 0000000..55ad33a --- /dev/null +++ b/site/index.html @@ -0,0 +1,337 @@ + + + + + + Disinto — Your AI Dev Team + + + + +
+ +
+

Disinto

+
your AI dev team
+
+ +
+ + + Robot AL-76 building a Disinto from scrap + +
+ A mining robot, lost and confused, builds a Disinto from + scrap — a device so powerful it vaporizes three-quarters of a mountain + on a single battery. Nobody can figure out how it works. + When ordered to explain, it calmly dismantles the machine into + rubble and flinders. + — Isaac Asimov, "Robot AL-76 Goes Astray" (1942) +
+
+ +
+

What it is

+

+ Disinto is an open-source framework for solo founders + who want to ship without hiring a team. Set the vision. Define + your quality gates. Agents derive the backlog, build, review, ship, + and operate — you're the founder, not the developer. +

+

+ Built for web apps and crypto projects. + SaaS dashboards, DeFi protocols, token launches — if it has + a repo and a CI pipeline, Disinto can work it. +

+

+ Like AL-76, it works with whatever's available. Point it at a repo, + give it a vision, and it starts building. +

+
+ +
+
+
dev-agent
+
Picks up backlog issues, implements in isolated worktrees, opens PRs. Handles CI failures and review feedback autonomously.
+
+
+
review-agent
+
Reviews PRs against project conventions. Approves, requests changes, or flags for discussion. JSON-structured verdicts.
+
+
+
supervisor
+
Monitors health — memory, disk, CI, stale processes. Auto-heals what it can, escalates what it can't.
+
+
+
planner
+
Maintains documentation tree. Compares project state against vision, creates backlog issues for gaps.
+
+
+
gardener
+
Grooms the backlog. Closes duplicates, promotes tech debt, escalates ambiguous items.
+
+
+
you
+
Set the vision. Define quality gates. Approve what matters, reject what doesn't. Find market fit.
+
+
+ +
+

The loop

+
+ vision + → + backlog + → + build + → + review + → + ship + → + operate + → + measure + → + vision +
+
+ +
+

How it works

+

+ Bash orchestration. Claude for implementation and review. + Woodpecker CI for build verification. + Codeberg for git hosting and issue tracking. + Cron jobs, shell scripts, and a lightweight listener daemon — + invoking an LLM only when thinking is needed. +

+

+ Each agent is a pair of bash scripts — a cron-driven poller and an + implementation script. The supervisor runs every 10 minutes. + When something breaks, it fixes it. When it can't fix it, it asks. +

+
+ +
+

For solo founders

+

+ You don't need a team. You need a VISION.md and a vault. + Disinto turns your product vision into a running development operation. + The vault is where you define what gets auto-approved + and what needs your sign-off — deployments, pricing changes, public posts. + Everything else runs without you. +

+

+ Opinionated over configurable. Good defaults, few knobs. + Works out of the box for web apps and crypto projects. +

+

+ Bash over frameworks. If it can be a shell script, it should be. + Claude is the only dependency that matters. +

+
+ +
+
Your startup's dev team — built from scrap, powered by a single battery.
+
+ source + issues +
+
+ +
+ +