CYA-WP-0005 T04 done (ralph iter 4): Polish + cross-link the phase-memory suggestions doc

- Added T04 finalization note and cross-references to the new Profiles 1–3 definitions / Capability Matrix in MemoryVision.md.
- Added one-line handoff pointer in the suggestions doc itself.
- T04 acceptance criteria satisfied (artifact already existed from pre-ralph creation; now polished and linked).

Small delta, committed. Ralph loop continuing to T05+.
This commit is contained in:
2026-05-28 03:23:09 +02:00
parent cd3a2fbecc
commit 16fde868cf
2 changed files with 8 additions and 2 deletions

View File

@@ -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 03 (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 13: 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.).

View File

@@ -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.