Kartikeya
3223e331f4
Define the product (ambient AI teammate that prevents merge collisions before push), architecture, stack per folder, build order, and demo script. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
33 lines
1.6 KiB
Markdown
33 lines
1.6 KiB
Markdown
# 🛰️ PodMan — Jarvis for engineering teams
|
|
|
|
Ambient AI teammate for the **2026 AI Engineer World's Fair Hackathon** (track: **Continual Learning**).
|
|
|
|
Engineers join a **pod** and share their screen + mic. PodMan watches every screen in
|
|
**realtime**, understands what each person is working on, fuses that with the team's
|
|
GitHub state, and **proactively prevents collisions before code is even pushed** —
|
|
speaking up like Jarvis: _"Karti and Yahya are both editing `auth.ts`, Yahya has unpushed
|
|
changes — here's the diff, want a sync PR?"_
|
|
|
|
> **The moat:** unpushed local code is invisible to the GitHub API. The realtime
|
|
> screen-vision layer is the *only* way to catch a collision before the push. That is the
|
|
> whole product — and the reason this is an ambient agent, not a dashboard.
|
|
|
|
## Monorepo layout
|
|
|
|
| Folder | What |
|
|
|---|---|
|
|
| `frontend/` | React + Vite PWA — join pod, screen/mic/cam capture, PodMan voice + intervention cards |
|
|
| `backend/` | PodMan agent: LiveKit room subscriber, Gemini vision, GitHub fusion, collision detector, voice out |
|
|
| `infra/` | DigitalOcean deploy (App Platform / Droplet), IaC, Dockerfiles |
|
|
| `database/` | MongoDB Atlas schema + Voyage vector memory for continual learning |
|
|
| `shared/` | Shared TypeScript types (pod, engineer context, intervention) |
|
|
| `docs/` | `PLAN.md` (the north star), demo script |
|
|
|
|
## Prizes we're stacking
|
|
|
|
- 🏆 **Best Gemini 3.5** — $5,000 cash (realtime vision + Live API voice)
|
|
- 🏆 **Best LiveKit** — Keychron keyboards (realtime transport is the core)
|
|
- 🏆 **Best DigitalOcean** — credits (deploy target)
|
|
|
|
👉 **Read [`docs/PLAN.md`](docs/PLAN.md) first.**
|