制品注册表

制品集的规范登记册。 本文档承载命令、规则、委托工作者、钩子、技能、输出风格、制品演进纪律以及空制品类声明的完整枚举；实质性表格存放于此。项目源代码布局提供了精简的常驻视图。

1. 命令

从 src/apothem/commands/*.md（非递归）注册了三十个命令。每个命令都是一等的已注册文件；/plan 编排器仅串联本已是一等的 plan 阶段，自身不携带任何阶段逻辑，因此仍然没有单体调度器，也没有子命令分组。非 plan、非 workflow 的命令：

Plan 流水线命令

plan 流水线作为八个一等命令交付——每个阶段一个，可从其各自的已注册文件 src/apothem/commands/plan-<stage>.md 直接以 /plan-<stage> 调用。

操作员工作流与编排器命令

三个命令进入一套深度流程，而非自带阶段逻辑：两个操作员工作流入口点（各由同名的配套技能支持），外加薄型 plan 流水线编排器。

2. 规则

行为规则存放于 src/apothem/rules/ 下——一个小型的常驻核心加上一个较大的路径过滤集合（在匹配的制品触及时按需加载）。完整的逐规则枚举——带有 Scope（常驻 / 路径过滤）与 Implements 列——是源生成的 reference/rules.mdx，由参考清单生成器从 src/apothem/rules/*.md 刷新；权威的当前清单请查阅它。

CM-21 切面划分（三条规则以彼此不重叠的不同切面共同实现 CM-21）：创意过滤器与认知身份 → cognitive-identity.md；生成方法论（撰写与重写协议） → clean-room-generation.md；计划/审查技术 → planning-techniques.md。每条规则各拥其切面；其余规则向外引用。

交互式询问 schema 指针。 规范的结构化询问调用 schema——必填字段、字段摘要表、两个可执行的示例（§2.1 单选与 §2.2 多选）——存放于 src/apothem/rules/interactive-questions.md §2 "Structured-Inquiry Shape"。下游制品可复制 §2.1 或 §2.2 作为调用模板；每个选项的 description 主体所承载的三段式选项注释 schema 在同一文件的 §3 中规定。

3. 委托工作者

生态系统随附十二个持久化工作者定义；编排规则的团队模式向它们派遣。每个定义存放于下方列出的文件路径。

Worker              File                                       Pattern         Model Policy
------------------- ------------------------------------------ --------------- -------------
Codebase Explorer   src/apothem/agents/codebase-explorer.md   Research        host-selected
Convention Auditor  src/apothem/agents/convention-auditor.md  Audit           host-selected
Dependency Auditor  src/apothem/agents/dependency-auditor.md  Audit           host-selected
Fact Checker        src/apothem/agents/fact-checker.md        Audit           host-selected
MCP Builder         src/apothem/agents/mcp-builder.md         Generation      host-selected
Memory Auditor      src/apothem/agents/memory-auditor.md      Audit           host-selected
Prompt Evaluator    src/apothem/agents/prompt-evaluator.md    Quality         host-selected
Quality Gate        src/apothem/agents/quality-gate.md        Quality         host-selected
Refactor Surgeon    src/apothem/agents/refactor-surgeon.md    Implementation  host-selected
Research Scout      src/apothem/agents/research-scout.md      Research        host-selected
Security Scanner    src/apothem/agents/security-scanner.md    Audit           host-selected
Test Runner         src/apothem/agents/test-runner.md         Quality         host-selected

4. 钩子

每个已注册的钩子命令都使用 Claude Code 的 exec 形式命令形态 （command: "python" 加上 args 数组），并调用 -m apothem.hooks.dispatch 或 -m apothem.conformity.gate。调度器 导入 src/apothem/hooks/lib/resolve_root.py 用于生态系统根解析，并 委托给与其并列于 src/apothem/hooks/ 之下的两个辅助程序： src/apothem/hooks/emit_hook_context.py 为助手格式化事件载荷，而 src/apothem/hooks/session_start_bootstrap.py 承载调度器在路由该事件时移交的 SessionStart 准备工作。在受支持的事件触发时呈现给 助手的钩子消息，作为 Markdown 上下文文件存放于 src/apothem/hooks/messages/ 之下——每个事件变体一个：postcompact.md、precompact.md、 pretooluse-bash.md、pretooluse-bash-plan-guard.md、pretooluse-conformity.md、 pretooluse-dependency-guard.md、pretooluse-edit.md、pretooluse-edit-header-guard.md、 pretooluse-eval-guard.md、pretooluse-notebookedit.md、pretooluse-write.md、 pretooluse-write-header-guard.md、pretooluse-write-plan-guard.md、sessionstart.md、 stop.md。每个被路由的上下文文件在其事件触发且其上下文实参在 settings.json 中注册时 由调度器加载；三个上下文文件 （pretooluse-conformity.md、pretooluse-dependency-guard.md、pretooluse-eval-guard.md） 作为可用变体交付，但当前在 settings.json 中没有路由条目。

Event             Automates                Timeout  Purpose
----------------- ------------------------ -------- --------------------------------------------------
SessionStart      CM-14                    30s      Read memory, check plan state, report readiness
PreCompact        CM-24 §2.3               30s      Verify state externalized before compaction
PostCompact       CM-24 §6.2               30s      Restore working state after compaction
Stop              CM-14/CM-22/CM-24/CM-26  60s      Session-end externalization
PreToolUse        CM-7/CM-22               10s      Write/Edit/NotebookEdit validation — codebase-isolation, frontmatter, license-header, and plans-locality checks plus the conformity gate. Bash validation — git artifact isolation and plans-locality
PostToolUse       —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event
UserPromptSubmit  —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event
Notification      —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event

约定。 Automates 为 — 的行被 dispatch.py 接受但未在 settings.json 中接线；Timeout 列展示在该事件日后接线时适用的调度级默认值。

超时值规范块。 本表的 Timeout 列是生态系统中钩子超时值的单一真相源。settings.json 中的逐钩子 timeout 字段、site/content/docs/reference/settings-reference.mdx § Hook Events 和 site/content/docs/reference/artifact-schema.mdx § Hooks Pipeline 中的镜像表，以及 src/apothem/rules/persistent-conventions-vigilance.md § Convention Awareness 中的规则指导，全部源自此列。未来的超时修订落在此处，消费方在下次引用时重新推导。

设置模板审查节奏

settings.json 是单一的 Claude Code 模板。每个钩子命令使用 exec 形式而非特定于 shell 的包装器，因此跨 OS 行为 在单个文件内审查，而非通过对比成对模板。新的权限条目、 钩子事件、超时与状态消息原子性地落入该文件。

5. 技能

可复用技能存放于 src/apothem/skills/ 之下，每个技能一个文件夹。

约定。 每行的 Path 是一个文件夹；入口点是其内部的 SKILL.md 文件——例如 src/apothem/skills/plan-suite/SKILL.md——遵循项目源代码布局中声明的文件夹带 SKILL.md 的技能约定。

6. 输出风格

四个输出风格存放于 src/apothem/output-styles/ 之下。

7. 制品演进

强制性。 当一个可复用的模式、纠正或技术反复出现（一次会话中 2 次以上，或在记忆中被标注为反复出现）时，生态系统必须演进。该周期有四个步骤：在任何交互期间检测模式；搜索现有的技能、规则、命令、钩子与记忆以寻找重叠；通过就地演进匹配的制品（更新流程、反模式、范围）或在该关注点确实正交时创建新制品来行动；验证交叉引用仍然可解析且依赖制品保持一致。优先细化而非创建——新制品会累加维护面。完整协议（包括跨每个制品类的封闭式缺口检测触发器目录）参见 src/apothem/rules/persistent-conventions-vigilance.md §2+§4。

8. 空制品类

在生态系统注册表中已声明但在激活触发器触发之前刻意留空的界面。每行记录保留的界面、为该类搭建脚手架的文件或目录，以及将该行从空声明提升为已填充的触发器。

空声明是一种正向声明，而非缺口。该类的脚手架（如有）是追踪激活时刻的规范无操作制品。从空声明到已填充的提升，与脚手架的首个非空值原子性地落入相关注册表小节。