Skip to content

StackMap

StackMap is an AI onboarding workspace that turns a public GitHub repo into an interactive learning experience for new engineers.

Code Video Cerebral Valley

Core trick

Clones a repo and has a sandboxed managed agent build a service graph that a mentor chat continues via session chaining.

Tags

dev toolseducation

Description

StackMap is an AI onboarding workspace that turns a public GitHub repo into an interactive learning experience for new engineers. Paste a repo URL, pick your role (frontend, backend, full-stack, infra, QA, or OSS), and StackMap builds an interactive architecture map with services, APIs, data layers, entry points, and risks connected by relationships you can explore. Click any node to inspect summaries, key files (linked to GitHub), and flagged gaps. You get a Week-1 Path of five learning missions (not refactor tickets): trace flows, read key files, understand risks, and plan a first contribution. Missions unlock in order; you check off success criteria and mark steps complete as you go. A Familiarity Score tracks progress across architecture, frontend, backend, data, testing, infra, and risk awareness. Mentor AI chat answers questions in context about the selected node or mission, and can use a remote sandbox to inspect real source. Story Mode generates a short narrated walkthrough of the area you're focused on, with optional audio.
thesid42/Stackmap★ 00 forksTypeScriptCreated May 23, 2026 · last push May 24, 2026

README excerpt

# StackMap

StackMap is an AI onboarding workspace for engineering teams. It turns a GitHub repo or microservice monorepo into an architecture map, source-backed onboarding missions, mentor chat, and codebase familiarity progress.

## Hackathon MVP

- Paste a public GitHub repo URL (or use the built-in demo URL)
- Select an onboarding role
- Async analysis: clone → index → specialist Gemini agents → architecture graph
- **Antigravity managed agent** (`interactions.create`, `environment: remote`) bootstraps a remote sandbox per repo; mentor chat continues the same session via `previous_interaction_id`
- Role-specific onboarding missions with file evidence
- Inspect services, files, evidence, and risks
- Ask the mentor agent about the selected node or task
- Mark tasks complete and update familiarity progress

## Architecture

```txt
GitHub repo URL
  → Repo Ingestion (shallow clone; reused from `.data/repo-cache` when present)
  → Code Indexer (monorepo service discovery, import hints)
  → Gemini Agent Orchestrator (7 specialist agents in parallel)
  → Architecture Graph Builder (merge + normalize)
  → Knowledge Graph (.data/jobs JSON + in-memory)
  → StackMap API + Dashboard
```

Specialist agents: Service Discovery, Structure, API, Data, Dependency, Risk, Task Workflow.

## Run

```bash
npm install
npm run dev
```

Create `.env.local`:

```bash
GEMINI_API_KEY=your_key_here
GEMINI_MODEL=gemini-3.5-flash
# Antigravity managed agent (Interactions API + remote sandbox)
GEMINI_MA

Team