{
  "markdown": "# 🚀 Vibe Games Gemini CLI Extension (Hacker Vibe Edition)\n\n![Vibe Games Team](assets/vibe-games-all.jpeg)\n\nA ruthless, high-velocity extension for the Gemini CLI, specifically optimized for building, validating, and demoing agentic prototypes in under 40 minutes for the **Vibe Games Competition**.\n\nThis extension abandons traditional, bloated software development lifecycles in favor of a deterministic, 5-step terminal pipeline that launches a visually stunning `tmux` swarm of AI subagents.\n\n---\n\n## 📺 Interactive Showcase & Slide Deck\n\nThe project includes a stunning, local-first interactive presentation showcasing the development process, architecture, and live demo trace of **ClassVibe AI**.\n\n👉 **[Launch the Live Presentation](https://sapientcoffee.github.io/vibe-games/)** *(Or open [index.html](./index.html) locally)*\n\n![Vibe Games Player Card - Rob](assets/vibe-games-rob.jpeg)\n\n---\n\n## 🏎️ The Winning Playbook: The Hacker Vibe Pipeline\n\nIn a 40-minute live sprint, context switching is fatal. This pipeline replaces interactive manual scaffolding with a straight-line, data-first execution path starting with pre-flight automated ideation.\n\n### The Swarm Architecture\n\n```mermaid\nsequenceDiagram\n    participant User\n    participant G as Gemini CLI\n    participant FS as File System (.plans/ & data.json)\n    participant Tmux as Tmux Swarm\n    \n    User->>G: activate_skill ideator (Discovery)\n    G->>FS: Write CONTEXT_DRAFT.md\n    User->>G: /vibe-check (Lock Scope)\n    G->>FS: Init KANBAN.md & CONTEXT.md\n    User->>G: /blueprint (Skeleton & Data)\n    G->>FS: Write blueprint.md & seed data.json\n    User->>G: /chop-shop (Task Slicing)\n    G->>FS: Write issue-*.md slices\n    User->>G: /send-it (Ignite Swarm)\n    G->>Tmux: spawn watch-kanban.sh & subagents\n    loop Parallel Stage Execution\n        Tmux->>G: agents-cli create --adk --yes\n        Tmux->>FS: Subagents write code & update .state files\n        FS-->>Tmux: Watcher safely rebuilds KANBAN.md diagram\n    end\n```\n\n### The Hacker Vibe Pipeline Flow\n\n```mermaid\ngraph LR\n    Pre[💡 ideator] -->|Draft Context| A[🏁 /vibe-check]\n    A -->|Scope Lock| B[🏗️ /blueprint]\n    B -->|Schema & Skeleton| C[🔪 /chop-shop]\n    C -->|Task Slices| D[🚀 /send-it]\n    D -->|TMUX Swarm| E{✨ PROTOTYPE}\n    style Pre fill:#fff2cc,stroke:#333,stroke-width:2px\n    style A fill:#f9f,stroke:#333,stroke-width:2px\n    style B fill:#bbf,stroke:#333,stroke-width:2px\n    style C fill:#bfb,stroke:#333,stroke-width:2px\n    style D fill:#fdb,stroke:#333,stroke-width:2px\n    style E fill:#fff,stroke:#333,stroke-width:4px\n```\n\n---\n\n## 🔥 The Pipeline Commands\n\n### 0. `ideator` Skill (Pre-Flight Discovery)\nDeconstructs any raw product or hackathon prompt into structured ideas.\n*   **Action:** Dynamically researches domain friction points, designs target personas, details high-impact Customer User Journeys (CUJs), aligns with ADK topologies, and drafts a mock `data.json` schema.\n*   **Result:** Outputs `.plans/CONTEXT_DRAFT.md` to feed into the `/vibe-check` process, allowing for 100% future-proof, generic ideation on any prompt.\n\n### 1. `/vibe-check` (The Pit Stop)\nRapid-fire Hackathon Q&A to nail down the core demo scope.\n*   **Action:** Reads `.plans/CONTEXT_DRAFT.md`, asks a strict maximum of 3-5 Yes/No default questions to choose, refine, and lock in the transactional flow and edge cases.\n*   **Result:** Outputs the final context payload (`CONTEXT.md`) and initializes the `KANBAN.md` tracker.\n\n### 2. `/blueprint` (The Spellbook)\nConverts the raw vibe-check context into a strict Technical Skeleton.\n*   **Action:** Generates the ADK System Prompt, defines Deep Modules, and—crucially—**seeds the initial `data.json` database** with 3-5 realistic mock records based on the audience's chosen use case.\n*   **Result:** The immutable data schema is locked in for the subagents.\n\n### 3. `/chop-shop` (The Slicer)\nBreaks the blueprint into independently-grabbable parallel tasks.\n*   **Action:** Slices the build into max 4 tasks tagged with `[FRONTEND]`, `[BACKEND]`, or `[ADK-INIT]`. \n*   **Result:** Populates the `To Do` column of the live Mermaid Kanban board.\n\n### 4. `/send-it` (The Swarm Orchestrator) **[STAGE MAGIC]**\nIgnites the parallel execution engine.\n*   **Action:** Spawns specialized subagents (`vibe-adk-hacker`, `vibe-ui-artist`) into isolated `tmux` panes.\n*   **Result:** The audience watches multiple terminal panes stream code simultaneously while the main pane dynamically updates the Mermaid Kanban board as tasks move to `DONE`.\n\n---\n\n## 🎯 Architecture & Infrastructure Rules\n\n1.  **The Agents CLI Advantage**: Subagents MUST scaffold the backend using `agents-cli create <name> --adk --yes`. Zero manual boilerplate.\n2.  **Model Selection Strategy**: Exclusively use `gemini-2.5-flash` or `gemini-3.1-flash-lite` for prototyping. Run a pre-flight model check to avoid 404s.\n3.  **Data-First Execution**: The dynamic `data.json` schema generated by the Blueprint is the immutable law. No Postgres, no Firestore. Instantaneous local JSON reads/writes only.\n4.  **Local-First / Zero-Cloud**: ALL infrastructure (UI, APIs) runs locally. The ONLY external dependency is the LLM via `GOOGLE_API_KEY`.\n5.  **CORS-by-Default**: ADK backends MUST pre-emptively include CORS middleware to ensure seamless React UI connectivity.\n6.  **State Directory Safety**: Subagents NEVER write directly to `.plans/KANBAN.md`. They write to isolated `.state` files; a background daemon aggregates them to rebuild the board safely.\n7.  **Spectator Logging**: Use the Gold Standard Emoji Set (📥, 🧠, 🛠️, 💾, ✅) and `flush=True` for real-time stage visibility.\n8.  **Zero Tests**: Standard TDD is suspended. If the endpoint returns valid JSON, it ships.\n\n---\n\n## 🗑️ Deprecated Commands (Pruned for Speed)\n\nThe following legacy commands have been removed as they introduce too much friction or hallucination risk for a 40-minute sprint:\n*   `/grill-me`, `/to-prd`, `/to-slices`, `/to-code` (Replaced by the Hacker Vibe Pipeline).\n*   `/vibe:blitz`, `/vibe:kickoff`, `/vibe:scaffold` (Replaced by `agents-cli` integrated initialization).\n\n---\n\n## 📜 License\n\nCopyright 2026 Google LLC.\nLicensed under the Apache License, Version 2.0. See [LICENSE](./LICENSE) for details.",
  "bytes": 6252,
  "sha": "a7f80864492f55938d349811be17c36c41634fbbe6566a8b977736f912ef2bd3",
  "repo_slug": "sapientcoffee/vibe-games",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_sapientcoffee_vibe_games_c4a9cf23/readme"
}