# plugins

## Purpose

Canonical native plugin distribution material.

## Ownership

tree-ring-memory contains Codex/Claude manifests, commands, skills, hooks, legal text and public ZIP builder. Root marketplaces point here.

## Local Contracts

Ship all four native lifecycle hooks. Codex skills-only means no MCP dependency; retain hooks and executable ZIP permissions. Effective host-owned project hooks cause plugin hooks to stand down; Codex linked-worktree root layers use the proven primary hook source, while Claude keeps local ownership checks. A genuinely absent project-local .tree-ring is a quiet skip; an existing entry, including a dangling symlink, must retain runtime diagnostics. Never redirect worktree memory to the primary checkout's store.

## Work Guidance

Keep shared skill instructions aligned with the CLI and preserve canonical hook bytes when syncing standalone marketplaces. Do not put stores or user paths in archives.

## Verification

`python3 scripts/validate-plugin-packages.py`; inspect deterministic archives and run unpacked hook probes.

## Child DOX Index

None. This document owns the full subtree.