Project Structure
Module boundaries
Architecture
The agent
Agent Flow
How The Brain guides Pinky through topics, teaching and article writing.
Data Ingestion
How the curated corpus becomes the knowledge store and embeddings The Brain retrieves from — chunking, provenance, embedding, and where the artifacts go.
Retrieval (RAG)
How The Brain finds the source material it teaches and writes from — BM25, embeddings, and how the two are fused.
Article Writing Guide
The standard The Brain writes articles to, distilled from five sources on article craft.
Source Code Reference
Entrypoints
ACP Protocol
The raw ACP server (src/index.ts + src/protocol/acp-server.ts) implements a subset
Infrastructure cleanup
scripts/cleanup-infra.ps1 deletes AWS resources, in one of two scopes.
Infrastructure
The service is designed to run both locally (with local SQLite/mock storage) and as a
Contributing
Development loop