EVOLITH · E2E PRODUCT VISION Governed Composition · Stateless Evaluation Core · Federated Five-Phase SDLC repo · evolith_arch32 ADR-0101 · 0074 · 0075 · 0102 1 FEDERATED GOVERNANCE · HUB-AND-SPOKE (INH-04) Evolith Core — Level 0 the Constitution Satellite Products — Level 1 e.g., UMS · other trackers Architecture Board approves upstream promotion Rule Heritage (inherit) Upstream Proposal Approved promotions flow upstream through evidence-backed review; every satellite re-inherits the evolved Constitution. 2 CONSUMPTION · AI-NATIVE (Convention over Configuration) HUMAN-DRIVEN Tracker PWA (Web · Mobile) VS Code / IDEs CI / CD Enterprise integrations AGENT-DRIVEN Claude Desktop Open-Source LLMs (free & paid) Autonomous Agents / MCP clients The chatbox is an intermediary, not the source of authority — LLMs and agents consume approved context, rulesets, skills and permissions through Evolith contracts. humans → Tracker PWA 3 EVOLITH TRACKER · repo evolith_tracker — SaaS SDLC ORCHESTRATOR & AUDITOR (external client) PWA · Web · Mobile BFF · Application Gateway (NestJS · ADR-0075) device payloads · PII stripping · session / cookies Owns runtime governance state phases · gates · evidence · exceptions · agent runs · immutable audit SDLC EXECUTION ENGINE · orchestrated by Tracker · evaluated by Core PHASE 1 DISCOVERY & IDEATION Gate: Business Sign-Off Discovery Canvas Build-vs-Compose PHASE 2 ARCHITECTURE SPEC-DRIVEN Gate: Design Baseline Contracts · ADRs Threat & risk PHASE 3 CONSTRUCTION TRACKING Gate: Successful Build CI · DoD Architecture drift PHASE 4 AUTOMATED QA & INTEGRATION Gate: RC Stamped Tests · Coverage Security · Contracts PHASE 5 DYNAMIC RELEASE PLANNER Gate: Production Live Rollout · Rollback Observability Granularity = Initiatives — no tasks / backlog / epics / user-stories. Agile work items are ExternalReferenceContext ingested via ACL. Tracker decides every phase transition · Core recommendations are non-binding. 4 CORE API EXPOSURE LAYER · product-neutral (ADR-0074) apps/core-api REST · 8 controllers mcp-server MCP · 26 tools · 9 resources smart-cli CLI · 20 commands Tracker BFF consumes this surface as an external client — ADR-0074 explicitly rejected placing the BFF inside Core. REST · MCP · CLI delegate evaluation EvaluationResult 5 EVOLITH CORE · repo evolith_arch32 — the Constitution & stateless engine AGENT RUNTIME · @evolith/agent-runtime (ADR-0102) AgentRuntimeService — 12 hexagonal ports · 30 adapters InteractionAdapters: CLI Chat Hermes MCP External Governed orchestration: OPA + HITL Agents are replaceable executors, not authorities. DOMAIN · @evolith/core-domain — STATELESS EVALUATION ENGINE (ADR-0101) EvaluationOrchestrator · 5 KindEvaluators · OPA dual-engine parity (Native TS + OPA/WASM) Kinds gate artifact evidence architecture blueprint topology checkpoint deployment rule compliance EvaluationContext → EvaluationResult non-binding verdicts + recommendations Does not persist — Tracker owns governance state at runtime. REFERENCE CORPUS · Constitution human-readable · machine-consumable ADRs · core · platform · ai-augmented Rulesets · 26 categories Standards & Taxonomies Artifact & Evidence Schemas Phase Gate Definitions Adapter & Integration Contracts Knowledge OS — canonical glossary · executable-test oracle · CI freshness gate · "memory for the product, not the AI" NEW · M0+M1 6 GOVERNED COMPOSITION Build the kernel · compose commodities behind replaceable Ports & ACLs. Provider Ports (Adapter Taxonomy) Work Repository CI/CD Testing Security Deployment Analytics LLM Obs. Agent Exec Collab Memory Approval Scheduler Harness Core Eval Policy Val Anti-Corruption Layers (ACLs) preserve lineage · map to canonical · reject non-compliant External Tools Cluster Jira GitHub / GitLab CI/CD runners Test runners Security scanners Observability Deployment Doc engines Disposition per capability Adopt Embed Integrate Extend Build Reject Data ownership stays with the source of record; Tracker judges evidence. commands · events · evidence Source of truth: product/suite/vision/evolith-product-vision-master.md
Evolith · E2E Product Vision — drag to pan · scroll to zoom
+ / − zoom · 0 fit · F fullscreen · PNG / JPG / SVG to save