Alphys - Autonomous AI Product Manager for Vibe-Coded Projects

"AI made it easy to start projects. Alphys makes it possible to finish them."

Alphys is an AI agent that acts as a product manager for side projects built with vibe-coding tools (Claude Code, v0, Bolt, Lovable, etc.). It analyzes your codebase, researches competitors, builds a visual roadmap, and exports structured tasks for any coding agent to execute.

Built solo at the Zero to Agent: Vercel x DeepMind Hackathon London (March 21, 2026).

---

The Problem

Millions of projects get started with AI coding tools but die after day 3. The developer gets "somewhere," loses direction, and graveyards the idea. There's no shortage of coding agents — the missing piece is an agent that decides what to build and why.

Alphys is the brain, not the hands. It plans, analyzes, and orchestrates. Users bring their own coding agent (Claude Code, Codex, Cursor) to execute the work.

How It Works

User pastes GitHub URL
    |
Alphys Agent (Gemini 3.1 Pro)
    |
    ├── 1. Analyzes repo (structure, tech stack, completeness score)
    ├── 2. Searches for real competitors
    ├── 3. Scrapes & analyzes top competitors (FireCrawl + Gemini)
    ├── 4. Generates prioritized roadmap (phases, tasks, dependencies)
    └── 5. Creates visual roadmap diagram (Gemini image generation)
         |
    Export → Markdown / JSON API → Any coding agent

Key Features

• GitHub Repo Analysis — Analyzes private/public repos via token auth. Reads file tree, README, key source files, and scores project completeness (0-100).
• Competitor Research — AI-powered competitor discovery + FireCrawl web scraping + Gemini multimodal analysis. Extracts features, pricing, positioning, and "features to steal."
• Interactive Canvas Dashboard — XYFlow-powered radial visualization: project at center, competitors in orbit, stealable features as draggable nodes with glow animations.
• Structured Roadmap Generation — Phased roadmap (PHASE-1, PHASE-2...) with individual tasks, acceptance criteria, file hints, and dependency tracking.
• Visual Roadmap Image — Gemini 3.1 Flash generates a styled dark-theme roadmap diagram with color-coded priorities.
• AI Chat Interface — Streaming chat with the Alphys agent. Ask follow-up questions, reprioritize tasks, add features — all via natural language.
• Real-time Updates — Supabase Realtime subscriptions push analysis progress, roadmap changes, and task updates live to the dashboard.
• Onboarding Wizard — 5-step guided setup: known competitors, goals, audience, schedule, and coding agent preference.
• Coding Agent Export — GET /api/roadmap/export returns full markdown. GET /api/roadmap/next-task returns the next unblocked task as structured JSON. POST /api/roadmap/tasks/{id}/complete accepts completion reports.
• Telegram Bot (Chat SDK) — Send a GitHub URL via Telegram DM, receive analysis + roadmap image + dashboard link. Full conversation support with history.

Tech Stack

Layer	Technology	Role
Framework	Next.js 16 + React 19	App Router, Server Components, streaming
AI Reasoning	Gemini 3.1 Pro via AI SDK v6	All analysis, competitor research, roadmap generation
AI Image Gen	Gemini 3.1 Flash Image Preview	Visual roadmap diagrams
AI SDK	Vercel AI SDK v6 (ai@6.0.134)	ToolLoopAgent, structured output, streaming, tool calling
Chat Bot	Vercel Chat SDK + @chat-adapter/telegram	Telegram bot with streaming AI responses
Database	Supabase (PostgreSQL + Realtime)	Projects, roadmaps, tasks, messages, real-time sync
Web Scraping	FireCrawl	Competitor page crawling and content extraction
UI Components	shadcn/ui + Tailwind CSS 4	Claymorphism dark theme, accessible components
Visualization	XYFlow React	Interactive radial canvas with animated nodes
Animations	Motion (Framer Motion)	Staggered entrances, glow effects, drag hints
Validation	Zod v4	Schema-driven validation for all AI outputs
Fonts	Plus Jakarta Sans + Roboto Mono	Body and code typography
Deployment	Vercel	Serverless functions, edge network

Partner Technologies Used

Google (Gemini)

• Gemini 3.1 Pro — All reasoning: repo analysis, competitor research, roadmap planning, chat conversations. Used via @ai-sdk/google direct provider for full multimodal support (audio/video/image input).
• Gemini 3.1 Flash Image Preview — Generates styled visual roadmap diagrams with dark theme, color-coded priorities, and claymorphism aesthetic.
• Structured Output — All AI outputs use Zod schemas with Output.object() for type-safe extraction (ProjectAnalysis, CompetitorAnalysis, Roadmap schemas).

Vercel

• AI SDK v6 — ToolLoopAgent with 5 custom tools (analyze_repo, search_competitors, analyze_competitor, generate_roadmap, generate_roadmap_image) + task editing tools. Uses createAgentUIStreamResponse() for streaming chat.
• Chat SDK — Telegram bot adapter with memory state, streaming responses, conversation history, and Card JSX for rich messages.
• Next.js 16 — App Router with Server Components, after() for background analysis, streaming route handlers.
• Vercel Deployment — Serverless functions with 300s max duration for long agent runs.

Supabase

• PostgreSQL — 5 tables: projects, roadmaps, tasks, messages, project_onboarding. Full relational schema with foreign keys and unique constraints.
• Realtime — Row-level subscriptions on projects, roadmaps, and tasks tables. Dashboard updates live as the agent works.
• Server + Client SDKs — Server client for API routes (service role key), public client for browser-side real-time subscriptions.

Architecture

app/
├── api/
│   ├── chat/route.ts              # Streaming chat (createAgentUIStreamResponse)
│   ├── projects/
│   │   ├── route.ts               # Create project
│   │   └── [id]/analyze/route.ts  # Background analysis pipeline
│   ├── roadmap/
│   │   ├── export/route.ts        # Markdown export for coding agents
│   │   └── next-task/route.ts     # Structured JSON for coding agents
│   └── webhooks/telegram/         # Telegram bot webhook
├── project/[id]/
│   ├── page.tsx                   # Server-rendered dashboard
│   ├── canvas-dashboard.tsx       # Interactive canvas + real-time subscriptions
│   ├── onboarding/page.tsx        # 5-step wizard
│   └── roadmap/page.tsx           # Timeline view
lib/
├── ai/
│   ├── agent.ts                   # ToolLoopAgent config + system prompt
│   └── tools/                     # 5 AI tools (analyze, compete, roadmap, image, edit)
├── supabase/                      # Client, server, types, queries
├── github/client.ts               # Private repo access via PAT
├── firecrawl/client.ts            # Web scraping (3 concurrent, 15s timeout)
└── canvas/layout.ts               # Radial layout algorithm

Getting Started

Prerequisites

• Node.js 20+
• A Supabase project
• A Google AI API key (Gemini access)
• A FireCrawl API key

Setup

git clone https://github.com/egorvert/alphys-hackathon.git
cd alphys-hackathon
npm install

Create .env.local:

NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY=eyJ...
SUPABASE_SECRET_KEY=eyJ...
GOOGLE_API_KEY=your_gemini_api_key
FIRECRAWL_API_KEY=your_firecrawl_key

Run the development server:

npm run dev

Open http://localhost:3000.

Demo Flow

1. Paste a GitHub repo URL on the landing page
2. Complete the onboarding wizard (competitors, goals, audience, schedule)
3. Watch as the AI agent analyzes the repo in real-time
4. Explore the interactive canvas — project, competitors, stealable features
5. Chat with the agent to refine priorities or add features
6. View the generated visual roadmap
7. Export tasks for your coding agent of choice

API for Coding Agents

Alphys exports roadmaps in formats any coding agent can consume:

# Get full roadmap as markdown
GET /api/roadmap/export?project_id=<uuid>

# Get next unblocked task as structured JSON
GET /api/roadmap/next-task?project_id=<uuid>

# Report task completion
POST /api/roadmap/tasks/<task-id>/complete

License

Built for the Zero to Agent: Vercel x DeepMind Hackathon London (March 21, 2026).