The Complete Picture
A visual summary of the three-phase methodology showing how ideas flow from inception to production.
The Robotville framework that powers me and scales from idea to product
Managing multiple AI-powered projects requires more than just folders and files. As complexity grows, chaos creeps in: inconsistent structures, forgotten conventions, documentation drift, and agent confusion. Without a systematic approach, what starts as organized quickly becomes unmaintainable.
The Robotville methodology is built on three core principles that ensure scalability and maintainability:
Each layer only depends on layers above it — changes cascade predictably. Rules at the base never change; implementation layers adapt to your needs.
Ideas flow through documented phases: Ideation → Commercial → Development. Start simple, add complexity gradually, pivot based on learnings.
Consistency across all projects via mandatory document structures. Agents understand your work, documentation stays organized, quality is built-in.
The Robotville repository uses a dependency pyramid where each layer conforms to and depends on the layers below it. This ensures changes cascade predictably and complexity never overwhelms structure.
L1 defines the rules → Universal standards that never change. L2 provides structures → Templates you follow ensuring consistency. L3-L5 implement → Your actual work built on solid foundations.
The Robotville methodology defines an iterative, agile approach to organizing projects — from initial idea validation through live product. Every project moves through three phases, with iteration loops allowing refinement, pivoting, or returning to earlier phases based on learnings.
Focus: Validate ideas through documentation, from concept to first prototype
Key Deliverables: product_overview.md, design files, visual prototypes (HTML/CSS/JS)
Focus: Create sales/commercial materials to test market fit
Key Deliverables: Sales presentations, pitch decks, discovery materials
Focus: Build, iterate, and pivot until finding product-market fit
Key Deliverables: Working implementation, measured results, feature documentation
A visual summary of the three-phase methodology showing how ideas flow from inception to production.
Specialized AI agents handle different stages of the cycle. Each agent has a specific role and creates specific outputs.
The Ideation and Prototyping Cycle is the first documentation cycle that takes a project from initial idea through completion of first documentation deliverables. This cycle demonstrates how Robotville's agent-based workflow operates.
Orchestrator discovers available modes
lavoisier extracts design tokens
designer creates documents
designer_judge validates output
housekeeper syncs files
Critical enforcement: All steps are mandatory. HTML-first rule means all documents must complete in HTML before any PDF conversion. Browser validation is mandatory and cannot be skipped.
Robotville's methodology provides concrete benefits that make it worth adopting:
Every project follows the same patterns. When you create a new project, you know exactly where documentation goes, which templates to use, and how agents will interact with it. This predictability eliminates decision fatigue and ensures consistency across all your work.
Documentation grows with your project. The methodology defines clear phases: Ideation → Commercial → Development. You start with minimal structure and add complexity only when needed. Templates ensure everything stays organized, even as your project evolves.
AI agents understand and maintain your work because they follow the same methodology. When you invoke an agent, it knows where to look, which templates to apply, and how to keep your project synchronized. Agents aren't just tools — they're part of the system.
This methodology has been validated through real implementations across multiple projects. The layered architecture prevents chaos, the iterative lifecycle ensures quality, and template enforcement maintains consistency — even as projects grow in complexity.
me was built using Robotville. See it in action:
Back to me