⚠️ LEGACY ALERT: DevUssy is now the internal cognitive engine for Geoffrussy. This page documents the underlying protocol, but for active development, please use Geoffrussy.

DEVUSSY

The First Circular Development Pipeline.

DevUssy is a methodology for organizing development work so that plans are reusable, portable, and agent-agnostic. Generate an optimal plan once, execute in a loop. It decouples the "Architect" from the "Builder," allowing for a purely specification-driven development cycle.

The Old Way

  • 🚫Context Loss: Agents re-read everything every time, burning tokens and losing focus.
  • 🚫Friction: Handoffs require re-explaining the project, leading to "drift".
  • 🚫Brittle Plans: Prose docs are hard to update and impossible to validate programmatically.

The DevUssy Way

  • 🔄Reusable: One plan works across humans, Frontier Models, and Open Source Executors.
  • 📦Portable: Export as plain markdown. No database, no vendor lock-in.
  • 🤖Agent-Agnostic: Any coding agent can pick up a task file and execute it.

Adaptive Architecture Pipeline

STAGE 01

Interview

Guided Q&A captures goals, constraints, and target stack. It feels like talking to a senior PM.

STAGE 02

Complexity Analyzer

Pure-Python scoring rubrics rate difficulty and estimate phase count based on feature density.

STAGE 03

Adaptive Design

Frontier Model combines interview + complexity scores. Small projects stay tiny; large ones get microservices.

STAGE 04

Design Validation

Rule-based checks + Automated sanity reviewer catch hallucinated services or conflicting requirements.

STAGE 05

SpecPlan Generation

Generates dynamic phases, explicit tests, and acceptance criteria in standard Markdown.

STAGE 06

Circular Handoff

One-click export for agent handoffs. Generates a 'handoff.md' that summarizes state.

Why "Circular"?

Most development pipelines are linear: Plan → Code → Deploy. DevUssy acknowledges that software is never "done." The Circular Handoff stage feeds the output of the last cycle back into the Context for the next iteration. It preserves the "Mental State" of the project in a file, not in an agent's RAM.

The "Ussy" Philosophy

DevUssy is part of the larger Ussyverse ecosystem. While others build "God Agents" that try to do everything, we build specialized protocols. DevUssy is the protocol for planning. Geoffrussy is the protocol for execution. They interface via standard Markdown.

Ready to generate your plan?

Your specplan.md is a stateless artifact — pure markdown.

Start Generating