---
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.