Skip to content

Commit 6e99207

Browse files
Update docs for agent rename and KV changes
1 parent e50f041 commit 6e99207

2 files changed

Lines changed: 26 additions & 27 deletions

File tree

packages/memory/CHANGELOG.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1010
### Added
1111

1212
- Project KV store for ephemeral project state with TTL management
13-
- `memory-kv-set`, `memory-kv-get`, `memory-kv-delete`, `memory-kv-list` tools for managing project state
13+
- `memory-kv-set`, `memory-kv-get`, `memory-kv-list` tools for managing project state
1414
- Automatic cleanup of expired KV entries (30-minute interval)
1515
- Default 24-hour TTL for KV entries
1616

@@ -23,9 +23,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
2323
### Added
2424

2525
- `experimental.chat.messages.transform` hook: automatically injects project conventions and decisions into system prompts for every LLM call, with configurable token budget and caching
26-
- Skill tool awareness in Code and Architect agent prompts
27-
- `plan_enter` permission on Code agent for switching to Architect mode
28-
- `memory-edit` documentation in Memory agent's tool list
26+
- Skill tool awareness in code and architect agent prompts
27+
- `plan_enter` permission on code agent for switching to architect mode
28+
- `memory-edit` documentation in Librarian agent's tool list
2929
- Agent name logging in all tool handlers via new ToolContext.agent field
3030

3131
### Changed
@@ -35,24 +35,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
3535

3636
### Fixed
3737

38-
- Memory agent tool documentation now lists all 7 available tools (was missing memory-edit)
38+
- Librarian agent tool documentation now lists all 7 available tools (was missing memory-edit)
3939

4040
## [0.0.9] - 2026-02-27
4141

4242
### Added
4343

44-
- `experimental.chat.messages.transform` hook that injects read-only enforcement reminder into Architect agent sessions, preventing file edits and non-readonly tool usage at the message level
45-
- Code Review agent (`ocm-code-review`) — read-only subagent for convention-aware code reviews with memory integration, invoked via Task tool
46-
- `/review` command that triggers the Code Review agent to review current changes
44+
- `experimental.chat.messages.transform` hook that injects read-only enforcement reminder into architect agent sessions, preventing file edits and non-readonly tool usage at the message level
45+
- auditor agent (`ocm-auditor`) — read-only subagent for convention-aware code reviews with memory integration, invoked via Task tool
46+
- `/review` command that triggers the auditor agent to review current changes
4747

4848
### Changed
4949

50-
- Restricted `memory-planning-update` and `memory-planning-search` tools to Memory subagent only — Code and Architect agents now delegate planning operations via @Memory Task tool
51-
- Overhauled Code and Architect agent system prompts with tone/style guidelines, tool usage policies, task management instructions, and planning state delegation patterns
50+
- Restricted `memory-planning-update` and `memory-planning-search` tools to librarian subagent only — code and architect agents now delegate planning operations via @librarian Task tool
51+
- Overhauled code and architect agent system prompts with tone/style guidelines, tool usage policies, task management instructions, and planning state delegation patterns
5252
- `memory-plan-execute` now accepts optional `objective`, `phases`, and `findings` parameters and saves planning state inline before dispatching the plan, eliminating the need for a separate `memory-planning-update` call
53-
- Planning instruction appended to dispatched plans now directs Code agent to delegate planning updates to @Memory subagent
54-
- Updated Memory agent description to include planning state and session progress management
55-
- Updated Code Review agent description to accurately reflect its capabilities
53+
- Planning instruction appended to dispatched plans now directs code agent to delegate planning updates to @librarian subagent
54+
- Updated librarian agent description to include planning state and session progress management
55+
- Updated auditor agent description to accurately reflect its capabilities
5656

5757
## [0.0.6] - 2026-02-24
5858

@@ -62,9 +62,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
6262
- Planning state tools: `memory-planning-update` and `memory-planning-get` for tracking session objectives, phases, findings, and errors
6363
- `memory-plan-execute` tool for creating new Code sessions with approved implementation plans
6464
- Three embedding providers: local (`all-MiniLM-L6-v2`), OpenAI (`text-embedding-3-small/large`, `ada-002`), and Voyage (`voyage-code-3`, `voyage-2`)
65-
- Bundled Code agent (`ocm-code`) with memory-aware coding workflows
66-
- Bundled Architect agent (`ocm-architect`) for read-only planning with automatic plan handoff
67-
- Bundled Memory agent (`ocm-memory`) for expert knowledge curation and post-compaction extraction
65+
- Bundled code agent (`ocm-code`) with memory-aware coding workflows
66+
- Bundled architect agent (`ocm-architect`) for read-only planning with automatic plan handoff
67+
- Bundled librarian agent (`ocm-librarian`) for expert knowledge curation and post-compaction extraction
6868
- Compaction context injection with custom prompt, planning state, conventions, and decisions
6969
- Configurable compaction settings: custom prompt, inline planning, token budget, snapshot storage
7070
- CLI export/import for backing up and migrating memories as JSON or Markdown

packages/memory/README.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ The local embedding model downloads automatically on install. For API-based embe
3434
- **Compaction Context Injection** - Injects conventions and decisions into session compaction for seamless continuity
3535
- **Automatic Memory Injection** - Injects relevant project memories into user messages via semantic search with distance filtering and caching
3636
- **Project KV Store** - Ephemeral key-value storage with TTL management for project state
37-
- **Bundled Agents** - Ships with Code, Architect, and Memory agents preconfigured for memory-aware workflows
37+
- **Bundled Agents** - Ships with Code, Architect, and Librarian agents preconfigured for memory-aware workflows
3838
- **CLI Tools** - Export, import, list, stats, and cleanup commands via `ocm-mem` binary
3939
- **Dimension Mismatch Detection** - Detects embedding model changes and guides recovery via reindex
4040

@@ -44,14 +44,14 @@ The plugin bundles four agents that integrate with the memory system:
4444

4545
| Agent | ID | Mode | Description |
4646
|-------|----|------|-------------|
47-
| **Code** | `ocm-code` | primary | Primary coding agent with memory awareness. Checks memory before unfamiliar code, stores architectural decisions and conventions as it works. Delegates planning operations to @Memory subagent. |
48-
| **Architect** | `ocm-architect` | primary | Read-only planning agent. Researches the codebase, delegates to @Memory for broad knowledge retrieval, designs implementation plans, then hands off to Code via `memory-plan-execute`. |
49-
| **Memory** | `ocm-memory` | subagent | Expert agent for managing project memory. Handles post-compaction memory extraction and contradiction resolution. |
50-
| **Code Review** | `ocm-code-review` | subagent | Read-only code reviewer with access to project memory for convention-aware reviews. Invoked via Task tool to review diffs, commits, branches, or PRs against stored conventions and decisions. |
47+
| **code** | `ocm-code` | primary | Primary coding agent with memory awareness. Checks memory before unfamiliar code, stores architectural decisions and conventions as it works. Delegates planning operations to @librarian subagent. |
48+
| **architect** | `ocm-architect` | primary | Read-only planning agent. Researches the codebase, delegates to @librarian for broad knowledge retrieval, designs implementation plans, then hands off to code via `memory-plan-execute`. |
49+
| **librarian** | `ocm-librarian` | subagent | Expert agent for managing project memory. Handles post-compaction memory extraction and contradiction resolution. |
50+
| **auditor** | `ocm-auditor` | subagent | Read-only code auditor with access to project memory for convention-aware reviews. Invoked via Task tool to review diffs, commits, branches, or PRs against stored conventions and decisions. |
5151

52-
The Code Review agent is a read-only subagent (`temperature: 0.0`) that can read memory but cannot write, edit, or delete memories or execute plans. It is invoked by other agents via the Task tool to review code changes against stored project conventions and decisions.
52+
The auditor agent is a read-only subagent (`temperature: 0.0`) that can read memory but cannot write, edit, or delete memories or execute plans. It is invoked by other agents via the Task tool to review code changes against stored project conventions and decisions.
5353

54-
The Architect agent operates in read-only mode (`temperature: 0.0`, all edits denied) with additional message-level read-only enforcement via the `experimental.chat.messages.transform` hook. After the user approves a plan, it calls `memory-plan-execute` which creates a new Code session with the full plan as context.
54+
The architect agent operates in read-only mode (`temperature: 0.0`, all edits denied) with additional message-level read-only enforcement via the `experimental.chat.messages.transform` hook. After the user approves a plan, it calls `memory-plan-execute` which creates a new code session with the full plan as context.
5555

5656
## Tools
5757

@@ -74,7 +74,6 @@ Ephemeral key-value storage for project state with automatic TTL-based expiratio
7474
|------|-------------|
7575
| `memory-kv-set` | Store a value with optional TTL (default 24 hours) |
7676
| `memory-kv-get` | Retrieve a value by key |
77-
| `memory-kv-delete` | Delete a value by key |
7877
| `memory-kv-list` | List all active KV entries for the project |
7978

8079
## CLI
@@ -260,11 +259,11 @@ When enabled, logs are written to the specified file with timestamps. The log fi
260259
#### Execution
261260
- `executionModel` - Model override for plan execution sessions, format: `provider/model` (e.g. `anthropic/claude-haiku-3-5-20241022`). When set, `memory-plan-execute` uses this model for the new Code session. When empty or omitted, OpenCode's default model is used (typically the `model` field from `opencode.json`). **Recommended:** Set this to a fast, cheap model (e.g. Haiku or MiniMax) and use a smart model (e.g. Opus) for the Architect session — planning needs reasoning, execution needs speed.
262261

263-
## ArchitectCode Workflow
262+
## architectcode Workflow
264263

265-
Plan with a smart model, execute with a fast model. The Architect agent researches and designs; the Code agent implements.
264+
Plan with a smart model, execute with a fast model. The architect agent researches and designs; the code agent implements.
266265

267-
Set `executionModel` in your config to a fast model (e.g., Haiku) and use a smart model (e.g., Opus) for the Architect session.
266+
Set `executionModel` in your config to a fast model (e.g., Haiku) and use a smart model (e.g., Opus) for the architect session.
268267

269268
See the [full workflow guide](https://chriswritescode-dev.github.io/opencode-manager/features/memory/#architect--code) for setup details.
270269

0 commit comments

Comments
 (0)