tomevault-io AFO Kingdom Navigator
Your guide to navigating the AFO Kingdom codebase. Uses the royal map and compass to find any destination.
Kingdom Structure
./
├── packages/ # Core packages (monorepo)
│ ├── afo-core/ # Backend (FastAPI, Chancellor)
│ ├── trinity-os/ # Philosophy engine
│ ├── dashboard/ # Frontend (Next.js 16)
│ └── sixXon/ # CLI interface
├── .claude/ # Claude Code configuration
│ ├── commands/ # 25 slash commands
│ ├── agents/ # Autonomous agents
│ └── mcp.json # 9 MCP servers
├── skills/ # 23 skill modules
├── scripts/ # 400+ automation scripts
├── tools/ # 44 tool packages
├── docs/ # 240+ documentation files
└── tests/ # Test suites
Quick Navigation Guide
By Domain
| Domain | Path | Key Files |
|---|---|---|
| Backend API | packages/afo-core/ |
api/, AFO/ |
| Trinity Score | packages/trinity-os/trinity_os/ |
core/, servers/ |
| Frontend UI | packages/dashboard/ |
src/app/, components/ |
| CLI | packages/sixXon/ |
docs/SIXXON_*.md |
| MCP Servers | packages/trinity-os/trinity_os/servers/ |
*_mcp.py |
By Functionality
| Need | Location |
|---|---|
| Trinity Score calculation | packages/trinity-os/trinity_os/servers/trinity_score_mcp.py |
| Chancellor orchestration | packages/afo-core/api/chancellor_v2/ |
| 3 Strategists logic | packages/afo-core/AFO/chancellor/ |
| Dashboard components | packages/dashboard/src/components/ |
| API endpoints | packages/afo-core/api/ |
| Skills definitions | skills/*/SKILL.md |
| Commands | .claude/commands/*.md |
By File Type
| File Type | Glob Pattern |
|---|---|
| Python source | packages/**/*.py |
| TypeScript | packages/dashboard/**/*.tsx |
| Commands | .claude/commands/*.md |
| Skills | skills/*/SKILL.md |
| MCP servers | **/servers/*_mcp.py |
| Tests | tests/**/*.py |
Reference Documents
| Document | Path | Purpose |
|---|---|---|
| MAP_OF_KINGDOM | docs/MAP_OF_KINGDOM.md |
Complete documentation index |
| CONTEXT_COMPASS | .claude/CONTEXT_COMPASS.yaml |
Navigation guide |
| CLAUDE.md (Root) | CLAUDE.md |
Master guidelines |
| SSOT | docs/AFO_FINAL_SSOT.md |
Single source of truth |
Navigation Commands
Use these to explore:
# Find all Trinity-related files
Glob: **/trinity*.py
# Find Chancellor implementation
Grep: "class Chancellor"
# Find API endpoints
Grep: "@router\." path:packages/afo-core/api
# Find skill definitions
Glob: skills/*/SKILL.md
MCP Server Locations
| Server | Path |
|---|---|
afo-ultimate-mcp |
trinity_os/servers/afo_ultimate_mcp_server.py |
trinity-score-mcp |
trinity_os/servers/trinity_score_mcp.py |
afo-skills-mcp |
trinity_os/servers/afo_skills_mcp.py |
afo-obsidian-mcp |
trinity_os/servers/obsidian_mcp.py |
context7 |
External (npx @upstash/context7-mcp) |
sequential-thinking |
External (npx) |
memory |
External (npx) |
mcp-docker-gateway |
Docker (111 tools) |
Port Map (Local Kingdom)
| Service | Port | Package |
|---|---|---|
| Dashboard | 3000 | dashboard |
| Soul Engine API | 8010 | afo-core |
| PostgreSQL | 15432 | infrastructure |
| Redis | 6379 | infrastructure |
| Ollama | 11435 | infrastructure |
Common Searches
"Where is the Trinity Score calculated?"
→ packages/trinity-os/trinity_os/servers/trinity_score_mcp.py
"Where are the API routes?"
→ packages/afo-core/api/
"Where is the dashboard home page?"
→ packages/dashboard/src/app/page.tsx
"Where are the 3 strategists?"
→ packages/afo-core/AFO/chancellor/
"Where is the Claude configuration?"
→ .claude/ (commands, agents, mcp.json)
Pro Tips
- Use
Globfor pattern-based file discovery - Use
Grepfor content-based search - Check
docs/MAP_OF_KINGDOM.mdfor documentation index - Reference
.claude/CONTEXT_COMPASS.yamlfor context guidance - All paths are relative to
./
Converted and distributed by TomeVault — claim your Tome and manage your conversions.