diff --git a/docs/phase-memory-optimization-suggestions.md b/docs/phase-memory-optimization-suggestions.md index ec4c22a..c76864b 100644 --- a/docs/phase-memory-optimization-suggestions.md +++ b/docs/phase-memory-optimization-suggestions.md @@ -1,10 +1,12 @@ # Optimization Suggestions & Missing Functionality for phase-memory -**Date:** 2026-05-28 +**Date:** 2026-05-28 (finalized in CYA-WP-0005 T04) **Source:** CYA-WP-0005 (Agentic Memory Profiles) + persisted research `history/2026-05-28-CYA-Agentic-Memory-Research-Variations.md` **Audience:** phase-memory / markitect owners (sister repo) **Purpose:** Actionable, prioritized feedback from the cya consumer so that Profiles 0–3 (and the self-improving loops they enable) can be realized cleanly, safely, and with excellent user control / explainability. +**Updated after T03:** Cross-references added to the crisp profile definitions and Capability Matrix now living in MemoryVision.md. The 9 categories below remain the concrete interface asks needed to enable the three variations. + ## Context (Why This Feedback Exists) `can-you-assist` (`cya`) is a **consumer** of the phase-memory profile-driven memory layer. After CYA-WP-0002/0003 we have a high-quality local approximation (Profile 0) behind explicit ports that already uses `profile`, `kinds`, `activation_context`, retrospection outcomes as higher-order memory, provenance, and phase hints. This delivers real directory/project-bound activation and a `cya retrospect` continuous-optimization loop today. @@ -26,6 +28,8 @@ All suggestions respect cya invariants: ## Prioritized Suggestions (9 Categories) +See the "Profiles 1–3: Definitions and cya Integration Plans" section + Capability Matrix in MemoryVision.md for the detailed intent and cya mappings that these interface asks are designed to enable. + ### 1. Refined Port Signatures & Activation Context (Must-have for Profile 1, baseline for 2/3) - Make `activation_context: dict[str, Any]` (cwd, git_root, task_class, recent_kinds, token_budget_hint) a first-class, documented parameter on `recall_preferences` / context-package requests (cya already prototypes this locally). - Support `kinds: list[str]` filter + boost natively (cya has `KIND_PREFERENCE | RETROSPECTION | INTERACTION_GOAL`; will add `REFLECTION`, `SYNTHESIZED_CONVENTION`, `PROCEDURAL_RULE`, etc.). diff --git a/workplans/CYA-WP-0005-agentic-memory-profiles-and-phase-memory-feedback.md b/workplans/CYA-WP-0005-agentic-memory-profiles-and-phase-memory-feedback.md index 75d5390..00a9fbe 100644 --- a/workplans/CYA-WP-0005-agentic-memory-profiles-and-phase-memory-feedback.md +++ b/workplans/CYA-WP-0005-agentic-memory-profiles-and-phase-memory-feedback.md @@ -115,9 +115,11 @@ completed: "2026-05-28 ralph iter 3" ```task id: CYA-WP-0005-T04 -status: todo +status: done priority: high state_hub_task_id: "d5bc201c-ba10-4031-87fd-fe8207cdee8f" +started: "2026-05-28 ralph iter 4" +completed: "2026-05-28 ralph iter 4" ``` **Description**: Extract, polish, and package the "Optimization Suggestions & Missing Functionality for phase-memory" content (already drafted in the research doc) into a clean, reviewable, sister-repo-targeted deliverable. This is one of the primary outputs of the workplan.