# Personal Agent Chat - Agent Guide

Mapper phase-flow packet for building a clean-room, self-hosted personal agent chatbot with streaming chat, provider routing, tools, skills, MCP, memory, subagents, telemetry, and WebUI/API workbench surfaces.

## Agent instruction

Do not scrape the human UI. Use this agent guide, the package manifest, and raw Buildprint files.

1. Fetch package manifest: `/buildprints/personal-agent-chat/package.json`
2. Read order: `BUILDPRINT.md` -> `01-questions.md` -> `02-project-setup.md` -> `blueprint.yaml` -> `03-phases/phase-index.yaml` -> `03-phases/01-contracts-storage.md` -> `04-evaluation.md` -> `05-evidence/evidence-ledger.jsonl`.
3. Do not scrape human cards. Use this manifest, agent.md, and raw files. BUILDPRINT.md is the canonical execution authority. Complete 01-questions.md and 02-project-setup.md before phase work; blueprint.yaml and other structured files are machine-readable mirrors/routers, not competing instructions.
4. Follow the Buildprint's alignment/question rules before implementation.
5. Run required validation and write requested validation evidence plus the final chat handover.

## Metadata

- slug: `personal-agent-chat`
- category: `Mapped Project`
- tier: `agent-grade`
- status: `validated`
- runtime: Mapper executable Buildprint, Any backend, Deterministic local proof first
- stack: Streaming chat, Provider router, Tools / Skills / MCP, Memory and compaction, Subagents, Telemetry, WebUI/API workbench

## Entrypoints

- Human page: /buildprints/personal-agent-chat/
- Manifest JSON: /buildprints/personal-agent-chat/package.json
- Prompt: /buildprints/personal-agent-chat/prompt.txt
- GitHub: https://github.com/DomEscobar/agent-buildprint/tree/main/buildprints/personal-agent-chat
- Raw base: https://agent-buildprint.com/buildprints/personal-agent-chat/files

## Files

- `01-questions.md` - Buildprint package file (required)
- `02-project-setup.md` - Buildprint package file (required)
- `03-phases/01-contracts-storage.md` - Buildprint package file (required)
- `03-phases/02-provider-streaming-runtime.md` - Buildprint package file (required)
- `03-phases/03-tools-skills-mcp-policy.md` - Buildprint package file (required)
- `03-phases/04-memory-subagents-telemetry.md` - Buildprint package file (required)
- `03-phases/05-safety-claim-boundaries.md` - Buildprint package file (required)
- `03-phases/06-webui-api-workbench.md` - Buildprint package file (required)
- `03-phases/phase-flow.md` - Buildprint package file (required)
- `03-phases/phase-index.yaml` - machine-readable mirror (required)
- `04-evaluation.md` - Buildprint package file (required)
- `05-evidence/evidence-ledger.jsonl` - Buildprint package file (required)
- `05-evidence/evidence-ledger.schema.json` - machine-readable mirror (required)
- `06-contracts/data-persistence.md` - Buildprint package file (required)
- `06-contracts/integration-runtime.md` - Buildprint package file (required)
- `06-contracts/product-architect.md` - Buildprint package file (required)
- `06-contracts/security-boundary.md` - Buildprint package file (required)
- `06-contracts/test-and-verification.md` - Buildprint package file (required)
- `06-contracts/ux-ui-craft.md` - Buildprint package file (required)
- `blueprint.yaml` - machine-readable executable packet router (required)
- `BUILDPRINT.md` - compatibility bootstrap or package contract (required)
- `checks/acceptance.md` - acceptance checklist (required)
- `CONTRACTS.md` - legacy interface/data contracts, when present (required)
- `generated/agent-prompt.md` - Buildprint package file (required)
- `PLAN.md` - legacy execution index, when present (required)
- `publication.json` - machine-readable mirror (required)
- `README.md` - human overview, non-authoritative (required)
- `SPEC.md` - legacy behavior requirements, when present (required)
- `TEST_MATRIX.md` - legacy risk-to-test alignment, when present (required)
- `VALIDATION_TEMPLATE.md` - legacy completion report template, when present (required)

## Copyable implementation prompt

```txt
Use the Personal Agent Chat Buildprint. First bootstrap exact snapshots: agb start https://agent-buildprint.com/buildprints/personal-agent-chat/package.json . If agb is not installed, clone https://github.com/DomEscobar/agent-buildprint and run node agent-buildprint/bin/agb.js start https://agent-buildprint.com/buildprints/personal-agent-chat/package.json . Then read .buildprint/next-agent.md and continue. Do not write Buildprint snapshots manually. The bootstrapped packet is the source of truth — follow its read order (BUILDPRINT.md, 01-questions.md, 02-project-setup.md, blueprint.yaml, 03-phases/phase-index.yaml, 04-evaluation.md, and the active phase files) instead of restating its rules here.
```