💡 Inspiration: The Pivot that Sparked Idea Lint

Like many developers entering this hackathon, I didn't start with the project you see today. My original project was an ambitious autonomous vulnerability scanner and patch tournament (CodeColosseum-AI). The plan was deceptively simple: clone an arbitrary Kotlin project from GitHub, compile and run it in a sandbox, and have agents discover and remediate security vulnerabilities.

However, reality hit fast: the initial assumption that one can "simply" compile, build, and run arbitrary third-party repositories from GitHub without deep environment idiosyncrasies was completely unrealistic under hackathon constraints.

I found myself spending days doing grueling manual research:

  • Is this concept novel?
  • What is the feature matrix of existing tools?
  • Where is my competitive niche?
  • Is there an actual market need, and is it technically feasible in 3 days?

After burning hours on manual market comparisons and hitting a massive feasibility roadblock, I hit the pause button and had an epiphany:

"What if I had an autonomous AI tool that could have saved me those days of manual research in 3 minutes—and warned me upfront that the idea had critical feasibility flaws before I wrote a single line of code?"

As someone who starts projects often and has always had to do this validation manually, I decided to pivot and build the exact tool I desperately needed: Idea Lint—an autonomous multi-agent panel that rigorously vets startup concepts, debates pros and cons, checks feasibility, and drafts actionable PRDs.

🚀 What It Does

Idea Lint transforms raw startup concepts into battle-tested PRDs through an autonomous 7-agent debate:

  1. Autonomous Market Research (Researcher): Performs live web research via Google Search tools powered by gemini-3.7-flash to map competitors and market signals.
  2. Dialectic Debate (Advocate vs. Critic): The Advocate (gemini-3.7-flash) builds the strongest case for the idea, while the Critic (gemini-3.1-pro-preview) red-teams every claim with live counter-evidence.
  3. Lateral Pivot Engine (Creative): Generates high-temperature pivots, untapped customer segments, and non-obvious business models using gemini-3.7-flash.
  4. Structured Scoring (Judge): Objectively scores Novelty, Feasibility, and Market Viability (1–10) with detailed risk assessments using gemini-3.1-pro-preview.
  5. Human-in-the-Loop Clarification Gate: When an idea hits a roadblock or receives a PARK verdict, the orchestrator (gemini-3.1-pro-preview) durably pauses to let the founder steer or approve pivots.
  6. PRD & Security Synthesis (PRD Writer & Security Auditor): Produces an exhaustive Product Requirements Document audited for technical gaps and compliance risks using gemini-3.1-pro-preview.
  7. Client-Side Privacy (Zero-Trust BYOK): Ideas and API keys stay exclusively in your browser's IndexedDB. The backend is completely stateless and ephemeral.

🛠️ How We Built It

  • Vibe Coding with Antigravity & Pi Agent: The entire application was engineered using Google Antigravity paired with a detached Pi agent workflow, enabling rapid, test-driven iterations.
  • Agent Framework: Built natively on Google ADK (Agent Development Kit Python) using LlmAgent, Runner, FunctionTool, and google_search.
  • LLM Models: We use Google's latest Gemini 3 models, configured per agent role in config.json:
    • gemini-3.7-flash: Powers the Researcher (with real-time Google Search grounding), Advocate, and Creative Ideator for fast, cost-effective reasoning.
    • gemini-3.1-pro-preview: Powers the Critic, Judge, PRD Writer, Security Auditor, and Orchestrator for deep analytical evaluation and structured synthesis.
  • Stateless Backend: Asynchronous FastAPI service running in-memory ephemeral debate lifecycles with strict BYOK key-scrubbing.
  • Local-First Frontend: Pure TypeScript SPA (bundled with esbuild) featuring live status polling, interactive decision gates, and local IndexedDB persistence with JSON/CSV/PDF export.
  • Infrastructure: Automated container builds and deployment to Google Cloud Run via GitHub Actions CI/CD with custom domain routing via Firebase Hosting (https://idea-lint.my).

⚡ Challenges We Ran Into & Architectural Pivots

1. From Self-Improving Server to Cloud Reality: My first local proof-of-concept had a huge scope—a stateful, self-improving server inspired by ADK long-horizon samples. While it worked locally, deploying it via the GCP Console UI proved time-consuming and error-prone. Transitioning to automated gcloud deployment scripts helped, but hitting early API rate limits forced a disciplined rethink of the architecture.

2. The Authentication Rabbit Hole & The Zero-Trust Pivot: I initially built a traditional multi-user system with Google OAuth login. It worked locally and on my VPS, but configuring OAuth consent screens, redirect URIs, and credentials across multiple Cloud Run environments became a huge friction point under the deadline.

The breakthrough decision: I scrapped the complex auth layer entirely and pivoted to a Local-First, Zero-Trust Architecture. Instead of storing user accounts and private startup ideas on a central server database, users Bring Their Own Key (BYOK). Ideas and history are saved strictly in the browser's IndexedDB, and the backend remains 100% stateless. This made the app faster, infinitely more private for founders, and immune to server-side credential leaks.

3. Domain, CDN Proxies, and the Frontend Polling Architecture: Securing the domain idea-lint.my and pointing it to Cloud Run required routing through Firebase Hosting. However, Firebase Hosting's CDN proxy does not support long-lived SSE streaming (returning 503s). To make the system rock-solid across any CDN or mobile network, I rewrote the frontend into a pure TypeScript polling client that reliably streams each agent turn live.

🏆 Accomplishments That We're Proud Of

  • Turning a Failed Idea into a Working Product: Converting a stalled hackathon concept into a meta-tool that prevents the exact trap I fell into.
  • 100% Privacy-Preserving Architecture: A zero-trust startup validator where founders can pressure-test sensitive, unreleased ideas without worrying about their IP being saved in a database.
  • Autonomous 7-Agent Coordination: Building an ADK multi-agent debate mesh that produces genuinely insightful, adversarial market and technical critiques in under 3 minutes.
  • Robust Test Harness: Backed by 159 passing automated tests ensuring API contract fidelity, security headers, and rate-limit guardrails.

📚 What We Learned

  • Validate before you build: The harness and rapid feasibility checks matter more than spending days deep in the weeds of unvalidated code.
  • Stateless + Local-First wins: For AI tools dealing with sensitive user IP, a stateless server + client-side IndexedDB with BYOK is vastly superior to traditional heavy databases and auth setups.
  • Google ADK's modularity: ADK’s clean separation of LlmAgent, tools, and session runners made coordinating 7 distinct agent personas intuitive and maintainable.

🔮 What's Next for Idea Lint

  • One-Click Scaffold Generator: Clicking "Build Prototype" to scaffold starter code directly from the audited PRD.
  • Multi-Modal Flowcharts: Using Gemini Imagen to generate conceptual UI mockups and user journey diagrams inside the exported PRD.
  • Custom Model Selection: Allowing founders to configure custom model pairs (e.g. testing gemini-3.7-flash vs gemini-3.1-pro-preview across different judging criteria) to benchmark evaluation perspectives.

Built With

Share this project:

Updates

Submission history