Skip to content

Development & Operations

How GE builds software. Operational truth. Living documentation.

Quick Navigation

Section Purpose
Infrastructure Current infra state, k8s, networking, DBs, secrets, monitoring
Agents Executor, identity system, orchestration, discussions, providers
Procedures Deploy code, add agent, rebuild executor, manage vault, debug agent
Standards Enforceable coding and naming conventions
Contracts Interface documentation: API surface, event formats, config authority
Patterns Proven implementation patterns by domain
Pitfalls Anti-patterns and known gotchas
Learnings Per-agent and cross-agent learning synthesis
File Map Authoritative file locations

Key Principle

Before starting ANY work, load context:

  1. Read this page for orientation
  2. Read infrastructure/overview.md for current system state
  3. Read pitfalls/ relevant to your task domain
  4. Read standards/ relevant to your task domain
  5. If modifying shared interfaces, read contracts/

Session Handoff

The latest session state is always at handoff.md. Read it before starting work. Write it before ending your session.