Complete Workflow Overview
The workflow is linear and session-based.- One
sessionIdties all six stages - You move forward only
- Each stage depends on the previous
- You cannot skip or reorder
- An idea
- Answers to questions
- A platform choice
- Payment
- ZIP with README
- PRD
- PLAN
- Specs
- LLM prompts
- Infra notes
meta/github_push.yaml- Optionally pushed to GitHub
Stage-by-Stage Breakdown
Stage 1 — Idea (/)
Input
- Natural-language idea
- One or two sentences
- Can include core features
- IdeaProcessor
- Analyzes scope, complexity, features
- Generates clarifying questions
- Analysis summary
- Feature hints
- Complexity
- Clarifying questions (typically 3–5)
- Taken to Intent with idea and questions in context
- “A Solana wallet for beginners with simple send/receive and token list.”
- Analysis + questions about:
- Target users
- Must-have vs nice-to-have
- Platform preference
Stage 2 — Intent (/intent)
Input
- Answers to clarifying questions (in chat)
- IntentAnalyzer
- Merges idea + answers into a structured spec
- Refined title
- Description
- Feature list
- Target audience
- Tech requirements
- Taken to Platform
- “Teams 5–20”
- “Must-have: assignees, due dates, list view; Nice: Kanban”
- “Web first”
- Refined PRD-style requirements
Stage 3 — Platform (/platform)
Input
- Selection of one platform
- PlatformSelector
- Recommends options with:
- Tech stack
- Cost ($SOL)
- Timeline (seconds)
- Agents
- Chosen platform
- Cost
- Execution timeline
- Taken to Payment
| Platform | Best for | Execution time (typical) |
|---|---|---|
| Website | Landing pages, marketing, static content | ~45 s |
| Web Application | Dashboards, SaaS, tools with auth/DB | ~75 s |
| Android | Native Android, Play Store | ~100 s |
| iOS | Native iOS, App Store | ~100 s |
Stage 4 — Payment (/payment)
Input
- Solana: connect wallet, sign transfer
- Dodo: complete card / UPI checkout
- Validates balance (Solana)
- Processes Dodo checkout and webhook
- Payment confirmation:
transactionSig(Solana)dodoPaymentId(Dodo)
- Workflow marked paid
- Redirect to Execution with:
sessionIdplatform- Payment proof
- Solana: Phantom or AppKit; SOL (devnet fallback)
- Dodo: Hosted checkout; webhook at
/api/dodo/webhook
Stage 5 — Execution (/execution)
Input
- None from you
- Uses Idea, Intent, Platform from the session
- X402 Orchestrator
- Product Manager (PRD, PLAN)
- UX Designer (structure, components)
- Frontend Dev (specs, prompts)
- Backend Dev (specs, prompts)
- DevOps Engineer (hosting, infra)
- Technical Writer (docs)
- Coordination via A2A (Agent-to-Agent)
- Full project structure
- Markdown
- Prompts
- Infra
- ZIP generated and stored (
ZipFile/Workflow)
- Taken to Completion
Stage 6 — Completion (/completion)
Input
- Optional: connect GitHub and trigger Push to GitHub
- Displays summary
- Serves Download ZIP
- GitHub upload via OAuth (if configured)
- Summary
- ZIP download
- Optional GitHub repo with project files
- End of workflow
Timeline Expectations
| Stage | Typical duration | Notes |
|---|---|---|
| Idea | 5–15 s | Depends on AI model and idea length |
| Intent | 5–15 s | Depends on number of answers and model |
| Platform | 5–10 s | AI recommendation + your click |
| Payment | 10 s – 2 min | Solana or Dodo |
| Execution | Platform-dependent | See below |
| Completion | < 5 s | Summary + ZIP |
Execution time by platform
| Platform | Typical execution time |
|---|---|
| Website | ~45 s |
| Web Application | ~75 s |
| Android | ~100 s |
| iOS | ~100 s |
End-to-end (idea → ZIP)
- Website: ~2–3 min
- Web Application: ~2.5–4 min
- Android / iOS: ~3–4.5 min
Best Practices
Idea
- Be specific enough to scope
- Name one or two core features
- Avoid very broad ideas
Intent
- Answer every question
- Separate must-have vs nice-to-have
- State platform preference if you have one
Platform
- Website — Fastest execution
- Web Application — Auth, DB, API
- Android / iOS — Native or app-store distribution
Payment
- Solana (testing):
NEXT_PUBLIC_SOLANA_NETWORK=devnet - Dodo (local): Use a tunnel so webhook reaches
/api/dodo/webhook
Execution and Completion
- Do not close the tab during Execution
- Download the ZIP on Completion
- Ensure
GITHUB_CALLBACK_URLmatches your environment