cc-os/docs/adr/0009-package-as-a-global-cl...

1.4 KiB

id date status supersedes superseded-by affected-paths affected-components migration_confidence migration_source
0009 2026-06-03 Accepted
medium docs/memory-system/03-architecture-decisions.md### ADR-009 — Package as a global Claude Code plugin with skills

0009 — Package as a global Claude Code plugin with skills

Context

Every project, on every machine, should know how to use the vault — write conventions, query patterns, the hooks, and the CLI — without per-project setup.

Decision

Ship hooks + scripts + CRUD know-how as a global Claude Code plugin with skills, installed at the user level.

  • Rationale: Skills carry the "when to write / what conventions / how & when to query" guidance to the model; the plugin registers the session-start / session-end / PostToolUse hooks and wires up Graphify (extraction/update/query + MCP server). Global install = consistent behavior everywhere; single source of truth for the conventions themselves.

Consequences

The vault write/query conventions, hooks, and CLI knowledge are packaged as a global, user-level Claude Code plugin with skills, so every project on every machine gets consistent behavior without per-project setup. This centralizes the conventions in a single source of truth but was accepted as still to be built per the build plan.

Alternatives rejected

None stated in source.