Files
markitect-tool/workplans/MKTT-WP-0008-agent-working-memory-context-cache.md

110 lines
2.3 KiB
Markdown

---
id: MKTT-WP-0008
type: workplan
title: "Agent Working Memory Context Cache"
domain: markitect
status: todo
owner: markitect-tool
topic_slug: markitect
planning_priority: P3
planning_order: 90
depends_on_workplans:
- MKTT-WP-0006
- MKTT-WP-0007
- MKTT-WP-0009
created: "2026-05-03"
updated: "2026-05-03"
state_hub_workstream_id: "6269f338-4f5c-40ee-90e5-0371f5c3874c"
---
# MKTT-WP-0008: Agent Working Memory Context Cache
## Purpose
Create activatable context packages that let agents drop, reactivate, and
reuse project knowledge efficiently while preserving provenance and policy
metadata.
## P8.1 - Define context package schema
```task
id: MKTT-WP-0008-T001
status: todo
priority: high
state_hub_task_id: "21ee9c37-4add-4886-bd03-a7bb4b20e957"
```
Represent source spans, summaries, token estimates, freshness, provenance,
policy labels, and retrieval recipes.
## P8.2 - Implement package creation from queries
```task
id: MKTT-WP-0008-T002
status: todo
priority: high
state_hub_task_id: "4df06b93-13ce-41fb-a8c3-f04d4ad9d752"
```
Create context packages from simple selectors, cached search results, or
manifest files.
## P8.3 - Implement activation lifecycle
```task
id: MKTT-WP-0008-T003
status: todo
priority: medium
state_hub_task_id: "9f3d9792-d655-482d-bae0-262df5fc0136"
```
Support activate, deactivate, refresh, and explain operations for a package.
## P8.4 - Add memory namespaces
```task
id: MKTT-WP-0008-T004
status: todo
priority: medium
state_hub_task_id: "2d090494-0e10-44cd-8e2d-c418d7530b27"
```
Support project, user, agent, thread, and task namespaces without hard-coding
any external agent platform.
## P8.5 - Add summary layers
```task
id: MKTT-WP-0008-T005
status: todo
priority: medium
state_hub_task_id: "4d1cf970-3d6d-4bd5-8da9-ec2399aa7efe"
```
Support deterministic summaries first, then optional LLM-generated summaries
through an injected adapter.
## P8.6 - Add CLI commands
```task
id: MKTT-WP-0008-T006
status: todo
priority: medium
state_hub_task_id: "2f18386c-9d2c-4af1-b8e2-75cb487c1692"
```
Add:
```text
mkt context pack <manifest-or-query>
mkt context activate <package-id>
mkt context explain <package-id>
mkt context refresh <package-id>
```
## Exit Criteria
- Agents can reactivate project context by stable id.
- Context packages show included sources and token budgets.
- Memory writes remain explicit and inspectable.