From a66d502b958fec49d9226d0c62290116a3da8007 Mon Sep 17 00:00:00 2001 From: tegwick Date: Tue, 16 Jun 2026 07:13:07 +0200 Subject: [PATCH] docs: add kaizen-agentic project metrics correlation (WP-0005 T16) Link Helix Forge fleet session memory to kaizen-agentic ADR-004 project metrics via helix_session_uid. Reciprocal reference to the cross-repo correlation contract. --- docs/DESIGN-session-memory.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/DESIGN-session-memory.md b/docs/DESIGN-session-memory.md index 93e70f8..e3dc2ed 100644 --- a/docs/DESIGN-session-memory.md +++ b/docs/DESIGN-session-memory.md @@ -370,6 +370,32 @@ hub indexes). --- +## 11. Project metrics correlation (kaizen-agentic) + +Helix Forge owns **fleet-level** session capture and digests (this repo). The +**kaizen-agentic** framework owns **project-scoped** agent execution metrics +(ADR-004: `.kaizen/metrics//executions.jsonl`). The two layers correlate +by optional `helix_session_uid` on project records — link-by-reference, no +duplicate ingestion in either repo. + +| Layer | Owner | Storage | +|-------|-------|---------| +| Fleet | agentic-resources (Helix Forge) | digest store (`digests` table) | +| Project | kaizen-agentic | `.kaizen/metrics//executions.jsonl` | + +**Cross-repo contract:** [Helix Forge Correlation Contract](https://gitea.coulomb.social/coulomb/kaizen-agentic/src/branch/main/docs/integrations/helix-forge-correlation.md) +(kaizen-agentic). Field mapping from `Session.session_uid` → `helix_session_uid`, +`digest.cost` → `tokens`, `tool_histogram` MCP share → `infra_overhead_share`. + +**Read path:** `kaizen-agentic metrics correlate ` looks up a digest via +`HELIX_STORE_DB` (this repo's session store). No write path from kaizen-agentic +into Helix Forge. + +**Related kaizen-agentic docs:** [ADR-004 project metrics convention](https://gitea.coulomb.social/coulomb/kaizen-agentic/src/branch/main/docs/adr/ADR-004-project-metrics-convention.md), +[wiki/EcosystemIntegration.md](https://gitea.coulomb.social/coulomb/kaizen-agentic/src/branch/main/wiki/EcosystemIntegration.md). + +--- + *Next step: [AGENTIC-WP-0002] implements Phase 0 — the schema, the Claude collector, the Tier1/Tier2 store, and the budget-based eviction sweep.*