Codebase File Map¶
Root: /home/claude/ge-bootstrap/
Active Code Directories¶
| Directory | Purpose | Language |
|---|---|---|
ge_agent/ |
Agent execution engine (runner, listener, identity, PTY) | Python |
ge_engine/ |
Business logic (billing, learning, monitoring, communication) | Python |
ge_common/ |
Shared utilities (logging, ports) | Python |
ge_comm/ |
Communication layer (state machine, routing, retry, DLQ) | Python |
ge_orchestrator/ |
Orchestration (completion scanner, hooks, discussion handler) | Python |
ge-orchestrator/ |
Event-driven HA orchestrator (replaces dolly-orchestrator.py monolith). See Orchestrator docs. | Python |
admin-ui/ |
Admin portal v2 (Next.js 16, 16 routes, Drizzle ORM). See Admin UI docs. | TypeScript |
admin-ui-old/ |
Archived admin-ui v1 — kept as reference only | TypeScript |
config/ |
All authoritative config files | YAML/JSON/MD |
ge-ops/ |
Operational data (agents, wiki, master configs, system state) | Mixed |
k8s/ |
Kubernetes manifests | YAML |
scripts/ |
Utility scripts | Bash/Python |
tools/ |
Token monitor, diagnostics | Python |
tests/ |
Test suites (unit, integration, e2e, simulation) | Python |
websites/ |
Client-facing sites (www.growing-europe.com) | TypeScript |
File Allocation Rules¶
Source of truth: CLAUDE.md
- Communication code →
ge_comm/ - Orchestration →
ge_orchestrator/ - Agent execution →
ge_agent/ - Shared utils →
ge_common/ - Engine/Billing →
ge_engine/ - NEVER create
.pyfiles in root directory - NEVER duplicate code across packages
Archived / Legacy¶
| Directory | Status |
|---|---|
archive/ |
Pre-wiki-brain archived files (Phase 0, 2026-02-15) |
identities/ |
Legacy single-file identities (archived, replaced by tiered system) |
maf/ |
Legacy MAF framework (pre-k8s) |
guardian_framework/ |
Guardian pattern library |
docs/ |
Legacy documentation (pre-wiki) |
tdd-delivery/ |
Legacy TDD delivery artifacts |