cc-os/openspec/specs/plugin-source/spec.md

# Spec: Plugin Source

## Purpose

Defines the requirements for moving the memory plugin's authoritative source into the cc-os repository under git version control, and updating the Claude Code marketplace to load from that path.

## Requirements

### Requirement: Plugin source in cc-os repo
Plugin source SHALL live at `cc-os/plugins/memory/` under git version control.

#### Scenario: Source is tracked in git
- **WHEN** a developer inspects the cc-os repository
- **THEN** `plugins/memory/` directory exists with all hook scripts and plugin config under git tracking

### Requirement: Marketplace points to cc-os source
The `local-plugins` marketplace entry for `memory` SHALL reference `cc-os/plugins/memory/` as its source path.

#### Scenario: Plugin loads from cc-os path
- **WHEN** Claude Code starts a session after cutover
- **THEN** the memory plugin is loaded from `cc-os/plugins/memory/` (not `~/.claude/plugins/memory/`)

### Requirement: No unversioned in-place edits
Plugin files at `~/.claude/plugins/memory/` SHALL NOT be the authoritative source after cutover.

#### Scenario: Edit is versioned
- **WHEN** a developer modifies a hook script
- **THEN** the change is made in `cc-os/plugins/memory/`, committed to git, and takes effect on next session load
Source memory plugin in git; port hooks to Python; archive change - Move memory plugin source from ~/.claude/plugins/memory (untracked) into cc-os/plugins/memory under git - Port four bash hooks to Python deep-module architecture (config.py, hook_io.py, session_state.py + thin entry points) - Split memsearch auto-commit+push into dedicated memsearch_sync.py SessionEnd hook (relocation of ADR-015, behavior preserved) - Cutover via symlink + settings.json rewrite; fresh-session test verified all hooks fire - Add ADR-016; update CLAUDE.md, build plan, and fix stale bash-hook/source-path references - Sync three new-capability delta specs into openspec/specs; archive change as 2026-06-12-memory-plugin-source-and-port 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> 2026-06-12 16:42:05 +00:00			`# Spec: Plugin Source`

			`## Purpose`

			`Defines the requirements for moving the memory plugin's authoritative source into the cc-os repository under git version control, and updating the Claude Code marketplace to load from that path.`

			`## Requirements`

			`### Requirement: Plugin source in cc-os repo`
			Plugin source SHALL live at `cc-os/plugins/memory/` under git version control.

			`#### Scenario: Source is tracked in git`
			`- WHEN a developer inspects the cc-os repository`
			- THEN `plugins/memory/` directory exists with all hook scripts and plugin config under git tracking

			`### Requirement: Marketplace points to cc-os source`
			The `local-plugins` marketplace entry for `memory` SHALL reference `cc-os/plugins/memory/` as its source path.

			`#### Scenario: Plugin loads from cc-os path`
			`- WHEN Claude Code starts a session after cutover`
			- THEN the memory plugin is loaded from `cc-os/plugins/memory/` (not `~/.claude/plugins/memory/`)

			`### Requirement: No unversioned in-place edits`
			Plugin files at `~/.claude/plugins/memory/` SHALL NOT be the authoritative source after cutover.

			`#### Scenario: Edit is versioned`
			`- WHEN a developer modifies a hook script`
			- THEN the change is made in `cc-os/plugins/memory/`, committed to git, and takes effect on next session load