36 lines
1.4 KiB
Markdown
36 lines
1.4 KiB
Markdown
|
---
|
||
|
|
id: "0009"
|
||
|
|
date: 2026-06-03
|
||
|
|
status: Accepted
|
||
|
|
supersedes:
|
||
|
|
superseded-by:
|
||
|
|
affected-paths: []
|
||
|
|
affected-components: []
|
||
|
|
migration_confidence: medium
|
||
|
|
migration_source: "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.
|