# Fleet Pi Orientation

> Map the Fleet Pi codebase before planning or editing. Use when asked what the app does, where chat/session/resource code lives, or how the monorepo fits together.

- Skill: `qredence/fleet-pi-orientation` (Agent Skill)
- Install (CLI): `npx get-skill add qredence/fleet-pi-orientation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qredence/fleet-pi-orientation/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Qredence (https://skillmd.com/u/qredence)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/qredence/fleet-pi-orientation

---


# Fleet Pi Orientation

Use this skill before broad codebase analysis or feature planning.

## Fast Map

- App shell and chat client: `apps/web/src/routes/index.tsx`
- Chat stream route: `apps/web/src/routes/api/chat.ts`
- Supporting chat endpoints: `apps/web/src/routes/api/chat/*.ts`
- Pi runtime/session/resource bridge: `apps/web/src/lib/pi/server.ts`
- Plan mode extension: `apps/web/src/lib/pi/plan-mode.ts`
- Browser-safe chat protocol: `packages/pi-protocol/src/chat-protocol.ts`
- Shared Agent Elements UI: `packages/hax-design/src/components/agent-elements/`
- Built-in/project Pi resources: `.pi/skills`, `.pi/prompts`, `.pi/extensions`
- Chat-installed Pi resources: `agent-workspace/pi/skills`,
  `agent-workspace/pi/prompts`, `agent-workspace/pi/extensions`, and
  `agent-workspace/pi/packages`
- Persistent Pi sessions: `.fleet/sessions`

## Workflow

1. Read `AGENTS.md`, `README.md`, and `docs/project-structure.md`.
2. Inspect the files above that match the user's task.
3. Prefer the smallest relevant validation lane from `AGENTS.md`.
4. Mention when generated files such as `apps/web/src/routeTree.gen.ts` should not be edited manually.

