Docs / agents/readme.md · mirrored from the repo
Agent docs
How agents are built, composed, and specialized in Namaste Ji. Read in this order:
| Doc | Layer | What it covers |
|---|---|---|
| AGENT-PLATFORM.md | Platform | The substrate (Agents SDK + Workflows), ModelPort/MemoryPort, the manifest schema, scheduling, BO management surfaces. How we build & run agents. |
| AGENT-KERNEL.md | Cell | The one reusable agent shape every agent instantiates: loop, STM/LTM, calibrated stop, subagent-as-tool firewall, Langfuse prompts, Control DO gate. The fundamentals. |
| ORCHESTRATION.md | Topology | How Kernel instances compose: thin orchestrator + subagents-as-tools, online/offline two-plane model, three-tier memory split. |
| CREATIVE-HEAD.md | Instance | The first agent — VP, Creative Content Strategy & Product: roster, the single strategy@vN artifact, cold-start bootstrap, delivery half. |
Plane/system docs live one level up in docs/ (ARCHITECTURE, CREATIVE-PLANE,
DISTRIBUTION, BACK-OFFICE). The creative org the Creative Head commissions is in
../CREATIVE-PLANE.md.