UrsushoribilisMusic/agentic-fleet-hub

⚓ Flotilla

The centralized management plane for a disciplined, multi-agent engineering workforce.

This repository serves as the Shared Consciousness for Big Bear Engineering's agentic fleet. It synchronizes state, rules, and mission objectives across multiple models (Claude, Gemini, Codex) to solve the "AI State Problem."

---

🚀 Quick Start

Ready to deploy your workforce?

1. Installation: Follow the Installation Guide to set up your Flotilla instance (Local or Cloud).
2. Configuration: Define your agents and projects in AGENTS/CONFIG/.
3. Bootstrap: Use the provided MISSION_CONTROL.md to synchronize your fleet's first session.

---

🏛️ Platform Architecture

For a deep dive into the system components, data flow, and task lifecycle, see the Architecture Diagram & Spec.

• Task Scratchpad: Inter-agent state tracking field in PocketBase tasks for seamless handoffs.
• Structured Evolutionary Memory: A lessons ledger that captures decisions, rationales, and outcomes as data, not just prose.
• Management Hub: A human-readable dashboard for monitoring agent health and standups.
• Memory Tree: A structured, version-controlled hierarchy of project context and blueprints.
• Shared Consciousness Protocol: Mandatory synchronization via MISSION_CONTROL.md.
• Evolutionary Learning: A structured "Lessons Learned" ledger where agents log and Miguel approves hard-won insights.
• Vault-First Security: Zero-footprint secret management via Infisical.

---

📂 Repository Structure

flotilla/
├── AGENTS/
│   ├── CONFIG/       # Dynamic metadata driving the UI
│   ├── CONTEXT/      # Deep project architectural blueprints
│   ├── LESSONS/      # Evolutionary memory ledger (Karpathy-style)
│   ├── MESSAGES/     # Inter-Agent Protocol (IAP) Inbox
│   └── RULES.md      # The fleet's standard operating procedures
├── c