# AI Swarm Simulator - Agent Guide

AI Swarm Simulator Buildprint remapped from MiroFish with Foundation scaffold rules: seed intake, ontology, Zep graph memory, simulation prep/run, observability, reports, and interaction as a proof-gated AI swarm prediction workbench.

## Agent instruction

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

1. Fetch package manifest: `/buildprints/ai-swarm-simulator/package.json`
2. Read order: `BUILDPRINT.md` -> `01-questions.md` -> `02-project-setup.md` -> `blueprint.yaml` -> `03-phases/phase-index.yaml` -> `03-phases/01-seed-ontology-workbench.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: `ai-swarm-simulator`
- category: `Mapped Project`
- tier: `agent-grade`
- status: `proof-required`
- runtime: Full-stack web runtime, Foundation scaffold gate, Provider adapters, Worker/runtime lifecycle, Browser/e2e proof required
- stack: Base project scaffold, Architecture and clean-code standards, Document ingestion, Ontology generation, Graph memory, Simulation runtime, Report interaction, Durable lifecycle

## Entrypoints

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

## Files

- `01-questions.md` - Buildprint package file (required)
- `02-project-setup.md` - Buildprint package file (required)
- `03-phases/01-seed-ontology-workbench.md` - Buildprint package file (required)
- `03-phases/02-graph-memory-build.md` - Buildprint package file (required)
- `03-phases/03-simulation-environment.md` - Buildprint package file (required)
- `03-phases/04-simulation-run-observability.md` - Buildprint package file (required)
- `03-phases/05-report-and-interaction.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 AI Swarm Simulator Buildprint. First bootstrap exact snapshots: agb start https://agent-buildprint.com/buildprints/ai-swarm-simulator/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/ai-swarm-simulator/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.
```