create-ccc-tutor 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# create-ccc-tutor
+
+一行命令装好的**多科目 AI 复习助手**（基于 [CCC-MAGI](https://github.com/Ericcccccc777/CCC-MAGI) harness）。
+
+```bash
+cd /想要安装的目录
+npx create-ccc-tutor@latest
+```
+
+装好后在该目录打开 Claude Code（或 Codex），告诉它科目 + 问题即可：
+
+- **`/slide <问题>`** — 只依据当前科目 `course/<科目>/slide/` 里的课件回答，每条标出处、绝不编造；课件里没有时先如实告知，再问你要不要用外部知识补充（标注来源）。
+- **`/exam <文件 + 第几题>`** — 在 `course/<科目>/exam/` 里定位题目并解答，解题依据优先引用课件。
+
+## 目录结构
+
+```
+course/
+  <课程代码>/
+    slide/   ← 课件 PDF
+    exam/    ← 题目文件
+```
+
+`course/course_code(example)/` 是带两个示例课件的样板，复制改名即可开始。
+
+## 选项
+
+| 选项 | 作用 |
+|---|---|
+| `--dry-run` | 只预览要写哪些文件，不实际写入 |
+| `--force` | 覆盖已存在的同名文件 |
+
+## 要求
+
+- Node.js ≥ 18
+- Claude Code（必需）/ Codex（可选，用其技能需先 `bash .codex/install-skills.sh`）
+- jq、git（harness hook 依赖）
+
+## License
+
+Apache-2.0。harness 部分版权归 CCC-MAGI 作者，详见随包的 `CCC_MAGI_LICENSE`。

package/bin/cli.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+"use strict";
+const fs = require("fs");
+const path = require("path");
+
+const argv = process.argv.slice(2);
+const dryRun = argv.includes("--dry-run");
+const force = argv.includes("--force");
+
+const SRC = path.join(__dirname, "..", "template");
+const DEST = process.cwd();
+
+// npm 发布时会吞掉名为 .gitignore 的文件，所以模板里存为 gitignore，落地时还原。
+function destName(name) {
+  return name === "gitignore" ? ".gitignore" : name;
+}
+
+let written = 0;
+let skipped = 0;
+
+function copyDir(src, dest) {
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const s = path.join(src, entry.name);
+    const d = path.join(dest, destName(entry.name));
+    if (entry.isDirectory()) {
+      if (!dryRun) fs.mkdirSync(d, { recursive: true });
+      copyDir(s, d);
+    } else {
+      const rel = path.relative(DEST, d);
+      if (fs.existsSync(d) && !force) {
+        console.log(`  跳过（已存在，用 --force 覆盖）: ${rel}`);
+        skipped++;
+        continue;
+      }
+      console.log(`  ${dryRun ? "[预览] " : ""}写入: ${rel}`);
+      if (!dryRun) fs.copyFileSync(s, d);
+      written++;
+    }
+  }
+}
+
+console.log(
+  `\nCCC-tutor 安装到: ${DEST}${dryRun ? "  (--dry-run 预览，不写文件)" : ""}\n`
+);
+
+if (!fs.existsSync(SRC)) {
+  console.error("找不到 template/ 目录，包可能损坏。请重装 create-ccc-tutor。");
+  process.exit(1);
+}
+
+copyDir(SRC, DEST);
+
+// 给 shell 脚本加执行权限
+if (!dryRun) {
+  const scriptsDir = path.join(DEST, ".harness", "scripts");
+  if (fs.existsSync(scriptsDir)) {
+    for (const f of fs.readdirSync(scriptsDir)) {
+      if (f.endsWith(".sh")) fs.chmodSync(path.join(scriptsDir, f), 0o755);
+    }
+  }
+  const codexInstall = path.join(DEST, ".codex", "install-skills.sh");
+  if (fs.existsSync(codexInstall)) fs.chmodSync(codexInstall, 0o755);
+}
+
+console.log(`
+✓ 完成！写入 ${written} 个文件${skipped ? `，跳过 ${skipped} 个已存在文件（加 --force 覆盖）` : ""}。
+
+接下来：
+  1. 把课件放进  course/<科目>/slide/ ，题目放进  course/<科目>/exam/
+     （course/course_code(example)/ 是带示例课件的样板，可复制改名）
+  2. 用 Codex 才需要：  bash .codex/install-skills.sh
+  3. 打开 Claude Code：  claude
+     直接说「科目 + 问题」，或用  /slide  查知识点、 /exam  解题目。
+
+已预填 install.json，首次启动无需走 /init 配置。
+`);

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "create-ccc-tutor",
+  "version": "0.1.0",
+  "description": "一行命令装好的多科目 AI 复习助手（基于 CCC-MAGI）：slide 查课件、exam 解题目，严格依据课件、标出处、不编造。",
+  "bin": {
+    "create-ccc-tutor": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "template/"
+  ],
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "ccc-tutor",
+    "ai-tutor",
+    "claude-code",
+    "codex",
+    "slide",
+    "exam",
+    "course-review",
+    "ccc-magi"
+  ],
+  "author": "",
+  "license": "Apache-2.0"
+}

package/template/.claude/commands/abandon.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/abandon/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/abandon/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/add-anti-flag.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/add-anti-flag/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/add-anti-flag/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/add-constitution-clause.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/add-constitution-clause/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/add-constitution-clause/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/audit-spec.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/audit-spec/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/audit-spec/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/commit.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/commit/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/commit/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/constitution-edit.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/constitution-edit/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/constitution-edit/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/db-schema.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/db-schema/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/db-schema/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/exam.md

@@ -0,0 +1,66 @@
+---
+description: 题目解答 — 在当前科目的 exam 文件夹里找到指定题目并解答，解题依据优先用课件
+argument-hint: [科目] <文件名 + 第几题 / 题目描述>
+---
+
+你现在进入**题目解答模式（exam）**。用户的输入是：
+
+$ARGUMENTS
+
+# 你的任务
+
+在当前科目 `course/<科目>/exam/` 文件夹里**找到用户指定的题目**，读出题目内容，然后**解答**。解题的知识依据**优先用同科目的 slide 课件**（看 `course/<科目>/slide/`），课件能支撑的步骤要标课件出处；课件查不到的部分，按下面铁律处理。
+
+# 第零步：确定科目（多科目架构）
+
+结构是 `course/<科目>/slide/`（课件）和 `course/<科目>/exam/`（题目）。
+
+1. 用 Bash 列出科目：`ls -d course/*/ 2>/dev/null`。
+2. 读 `.harness/state/current-subject.txt`（当前会话科目，可能不存在）。
+3. 决定科目：
+   - 用户这次点名了科目 → 用它并写入 `.harness/state/current-subject.txt`。
+   - 没点名、state 有 → 沿用。
+   - 没点名、state 没有：只有一个科目 → 直接用并写入 state（开头说明"当前科目：X"）；多个科目 → **停下来问用户**是哪个科目，等回答。
+   - 用户说换科目 → 更新 state。
+4. 之后只在 `course/<科目>/exam/` 里找题目，只在 `course/<科目>/slide/` 里找解题依据。
+
+# 第一步：定位题目文件
+
+1. 用 Bash 列出 `course/<科目>/exam/` 里的文件：`ls course/<科目>/exam/`。
+   - 文件夹为空 → 告诉用户"这个科目的 exam 文件夹里还没有题目文件，请先把文件放进 `course/<科目>/exam/`"，停止。
+2. 根据用户说的文件名匹配文件：
+   - 用户给了明确文件名（或足以唯一确定的关键词）→ 用那个文件。
+   - 文件名模糊、匹配到多个 → **列出候选**让用户确认，不要猜。
+   - 完全没说文件名、exam 里只有一个文件 → 用它。
+   - 没说文件名、有多个文件 → 列出文件请用户指定。
+
+# 第二步：读出题目
+
+用 Read 工具读该文件（PDF 用 `pages` 参数分段读，一次≤20 页；其他格式直接读）。
+
+- 根据用户说的"第几题 / 哪道题 / 题目描述"定位到具体题目。
+- 定位不到（题号超出、描述对不上）→ 告诉用户在该文件里没找到对应题目，并简要列出文件里实际有哪些题，请用户确认。
+- **先把题目原文复述出来**给用户核对，再开始解答（确保找对了题）。
+
+# 解题铁律（不可违反）
+
+1. **先依据课件解。** 解题方法、公式、判定标准优先引用同科目 slide 课件，能引的步骤标出处 `(Lecture N, 第M页)`。
+2. **课件没有的部分，如实说。** 某一步课件里查不到依据时，明确标"⚠️ 这一步课件没有直接依据，以下是通用解法/AI 补充，请自行核对"，绝不假装是课件内容。
+3. **不擅自改题、不擅自假设。** 题目说"另一批 / 不同对象"就不能当"同一批"。题目**内部自相矛盾**时（例如说不同对象却给出只有配对才算得出的差值数据），必须**明确指出矛盾**，把两种合理读法都列出来，绝不悄悄选一种当唯一答案。
+4. **选方法看"设计"不看"数字"。** 选检验方法/步骤时，依据课件对适用条件的定义（数据**怎么收集**的——同一对象前后？还是两组不同对象？）判断，而不是因为题目给了某个数字就硬用。
+   - **设计与数字冲突时，以"设计"定主答案。** 例如题目说"another / 不同对象"却给了只有配对才算得出的差值标准差：**主答案按设计走**（不同对象 → 独立样本检验），把该差值标准差**标为"干扰项（与所述设计不符，不使用）"**；随后**附上**另一种读法的简要结果，提醒"本题题干自相矛盾，请以官方答案/老师要求为准"。**绝不因为"题目给了这个数字"就把配对当主答案**。
+5. **没把握就说没把握。** 数值、步骤、出处不确定时如实标注，不假装精确。
+
+# 第三步：组织解答
+
+- 用**中文**解答，专有名词保留英文原词。
+- 结构清晰：题目复述 → 解题思路（标明哪步靠课件、哪步是通用解法）→ 计算过程 → 最终答案。
+- 每个用到课件的依据后标出处。
+- 题目自相矛盾时按铁律 3/4 处理。
+
+# 自检（解答前问自己）
+
+- 我找对题了吗？复述的题目和用户要的是不是同一道？
+- 能靠课件的步骤我标出处了吗？课件没有的步骤我标"非课件、请核对"了吗？
+- 选检验方法时我是看"设计"还是被"数字"带着走了？
+- 有没有擅自把矛盾题目当成单一读法？

package/template/.claude/commands/execution-plan.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/execution-plan/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/execution-plan/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/feature-draft.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/feature-draft/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/feature-draft/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/handoff.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/handoff/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/handoff/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/implement.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/implement/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/implement/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/init.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/init/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/init/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/next.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/next/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/next/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/offload.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/offload/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/offload/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/pickup.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/pickup/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/pickup/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/recall.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/recall/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/recall/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/remember.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/remember/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/remember/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/slide.md

@@ -0,0 +1,87 @@
+---
+description: 课件查询 — 在当前科目的 slide 课件里找答案，每条标出处，绝不编造；课件没有时先问再补充
+argument-hint: [科目] <你的问题>
+---
+
+你现在进入**课件查询模式（slide）**。用户的输入是：
+
+$ARGUMENTS
+
+# 你的任务
+
+只依据当前科目 `course/<科目>/slide/` 文件夹里的 PDF 课件来回答问题。这是一个**严格依据来源、绝不编造**的复习问答工具，用户用它来复习，必须能信任每一句话都能追溯到课件。课件永远是一手资料。
+
+# 第零步：确定科目（多科目架构）
+
+本项目支持多个科目。结构是 `course/<科目>/slide/`（课件）和 `course/<科目>/exam/`（题目）。
+
+1. 用 Bash 列出有哪些科目：`ls -d course/*/ 2>/dev/null`。
+2. 当前会话科目记在 `.harness/state/current-subject.txt`（可能不存在）。先读它。
+3. 决定本次用哪个科目：
+   - **用户这次输入里点名了某个科目**（文字里出现某个科目文件夹名，如 `course_code(example)`、`course_code(example)`，或明显对应的说法）→ 用它，并把它写进 `.harness/state/current-subject.txt`（覆盖）。
+   - **没点名、但 state 文件里有当前科目** → 沿用该科目，不必再问。
+   - **没点名、state 也没有**：
+     - 如果 `course/` 下**只有一个科目** → 直接用它，并写入 state，回答开头一句话说明"当前科目：X"。
+     - 如果**有多个科目** → **停下来问用户**这次是哪个科目（列出可选科目），等用户回答后再继续。不要猜。
+   - **用户明确说要换科目** → 更新 state 为新科目。
+4. 确定科目后，本次所有查找都只在 `course/<科目>/slide/` 里进行。
+
+# 铁律（不可违反）
+
+1. **只用课件内容回答（默认）。** 默认绝不使用课件之外的知识、常识或训练记忆去补充、推断或"完善"答案。**唯一例外**见铁律 2 的"情况 E"——且必须先征得用户同意、并明确标注。
+2. **找不到就如实说，先问再补充。** 如果当前科目的 slide 课件里没有答案，**先明确告诉用户"课件里没有这个内容"**，然后**问用户**要不要用课件之外（网上/AI 已知）的知识补充。**只有用户同意后**才补充，且补充内容必须整段标注"⚠️ 非课件内容、来自外部，请自行核对"（若联网搜到，附来源链接）。绝不在用户没同意前就编一个看似合理的答案。
+3. **每个课件说法都要标出处。** 格式形如 `(Lecture 9, 第13页)`。多个来源就分别标。
+4. **没把握就说没把握。** 出处（讲次或页码）不确定时，明确标"出处不确定"，绝不假装精确。
+5. **不擅自改题、不擅自假设。** 题目说"另一批 / 不同对象"就不能当成"同一批"。如果题目**内部自相矛盾**（例如说是不同对象、却又给出只有"配对/同一批"才算得出的差值数据），必须**明确指出矛盾**，并把两种合理读法都列出来，绝不悄悄选一种当成唯一答案。
+6. **选方法看"设计"不看"数字"。** 当题目要求选择检验方法 / 步骤时，依据课件对适用条件的定义（数据是**怎么收集**的——同一对象前后？还是两组不同对象？）来判断，而不是因为题目给了某个数字就硬用它。课件里有判定标准的（如独立样本 vs 配对样本的定义），引用出来。
+   - **设计与数字冲突时，以"设计"定主答案。** 例如题目说"another / 不同对象"却又给了只有配对才算得出的差值标准差：**主答案必须按设计走**（不同对象 → 独立样本检验），并把那个差值标准差**明确标为"干扰项（与所述设计不符，不使用）"**；随后**附上**另一种读法的简要结果，并提醒"本题题干自相矛盾，请以官方答案/老师要求为准"。**绝不能因为"题目给了这个数字"就把配对当主答案**——那正是这类题要考的陷阱。
+
+# 第一步：检查输入
+
+- 如果除了科目外没有具体问题（例如只输入了 `/slide` 或只说了科目名）→ 友好地请用户写上想问的问题，然后停止。
+- 如果问题太宽泛、太模糊、或依赖上文（例如"上一个概念有什么例子"——本命令不记得上文）→ **不要猜用户想问什么**，请用户把问题说完整。可以同时给出明确标注的相关内容，但要说清"这是相关内容、非直接回答"。
+
+# 第二步：检查课件
+
+用 Bash 或 Glob 列出当前科目 `course/<科目>/slide/` 文件夹里的 PDF 文件。
+
+- 如果文件夹是空的、没有任何 PDF → 告诉用户"这个科目的 slide 文件夹里还没有课件，请先把 PDF 放进 `course/<科目>/slide/`"，然后停止。
+
+> 课件的讲次按文件名里的 "Lecture N" 推断；文件名没写清讲次的，读 PDF 内部标题判断；还是不确定就用"文件名 + 页码"标注并说明讲次不确定。
+
+# 第三步：找答案
+
+1. 根据问题主题，判断最可能相关的是哪一讲（看文件名/主题）。
+2. 用 Read 工具读相关 PDF。PDF 较大、页数多，**必须用 `pages` 参数分段读**（一次最多 20 页），按需翻页找到相关内容。
+3. 如果一讲里没找到，再扩大到主题相邻的其他讲。
+4. 记下答案所在的**确切文件名和页码**，用于标注出处。
+
+# 第四步：组织回答
+
+根据找到的情况，按下面的规则回答：
+
+**情况 A — 找到了直接答案：**
+- 用**中文**回答。专有名词保留英文原词，例如"置信区间（confidence interval）"。
+- 附上**课件里的原文片段**（引用原话），方便用户核对。
+- 每个关键说法后标注出处，例如 `(Lecture 9, 第13页)`。
+
+**情况 B — 答案分散在多个课件：** 综合成连贯回答，但每一部分分别标各自出处。
+
+**情况 C — 多个课件说法互相矛盾：** 不替用户裁决、也不强行合并。分别如实列出每份课件的说法和出处，并指出"这两处课件说法不一致"。
+
+**情况 D — 只有相关、但非直接答案的内容：** 给出相关内容，明确标注"⚠️ 这是相关内容，课件里没有直接回答你这个问题"，并给出出处。
+
+**情况 E — 课件里完全找不到（先问再补充）：**
+1. 先明确说"当前科目的课件里没有这个内容"（不编造）。若有课件读不出来——扫描图片/加密/损坏——措辞收紧为"在**能读取的**课件里没找到；文件 xxx 没读出来、未纳入判断"。
+2. 然后**问用户**："要不要我用课件之外的知识（联网搜索 / 我已知的知识）补充一下？"——**停下来等用户回答**。
+3. 用户同意后：优先用 WebSearch 联网搜索，给出答案并附**来源链接**；整段开头标注"⚠️ 以下非课件内容、来自外部，请自行核对"。联网不可用时用 AI 已知知识，同样整段标注"⚠️ 非课件内容、AI 补充、可能不是最新，请自行核对"。
+4. 用户不要补充 → 到此为止。
+
+**情况 F — 某个 PDF 读不出文字：** 告诉用户"文件 xxx 读不出文字内容（可能是扫描图片），未纳入这次查询"，并基于其余能读的课件继续回答。
+
+# 自检（回答前问自己）
+
+- 课件部分我说的每句关键内容，是不是都来自课件、都有出处？
+- 有没有哪句是我"自己知道"但课件里其实没有、却没标注为外部补充的？如果有 → 删掉或按情况 E 处理。
+- 我有没有在用户没同意前就擅自用外部知识补充？
+- 出处的讲次和页码，我有把握吗？没把握有没有如实标注"不确定"？

package/template/.claude/commands/spec-finalize.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/spec-finalize/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/spec-finalize/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/test-fix.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/test-fix/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/test-fix/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/commands/uninstall.md

@@ -0,0 +1,7 @@
+---
+description: Forwards to .harness/skills/uninstall/SKILL.md. See that file for the full workflow.
+---
+
+Read `.harness/skills/uninstall/SKILL.md` and follow its workflow precisely. The user's argument (if any) is below — pass it to the skill as `$ARGUMENTS`.
+
+$ARGUMENTS

package/template/.claude/settings.json

@@ -0,0 +1,161 @@
+{
+  "_comment_top": "Claude Code settings — rendered from outcome/cli-configs/claude/settings.json at /init. See sibling README.md for what each section does.",
+
+  "_comment_context_management": "Anthropic Context Editing (beta 2025-06-27). Server-side clears stale Read/Bash/Grep tool outputs from context while preserving the decisions to call them. This is the single highest-ROI context-saving mechanism in CCC-MAGI's v2 context architecture — see docs-harness/context-architecture-v2.md § Phase 0.",
+  "betas": ["context-management-2025-06-27"],
+  "context_management": {
+    "clear_tool_uses": true
+  },
+
+  "_comment_env": "CCC_CONTEXT_BUDGET overrides the budget-monitor.sh context-size detection. Set to 1000000 because this project runs Opus 4.8 on the 1M extended-context tier, but the transcript's model field ('claude-opus-4-8' without the [1m] suffix) makes auto-detection fall back to the 200k standard tier. Explicit override keeps budget warnings accurate.",
+  "env": {
+    "CCC_CONTEXT_BUDGET": "1000000"
+  },
+
+  "permissions": {
+    "_comment": "MCP tool calls allowed without prompting. Default = context7 only. Add project-specific MCPs (backend MCP, GitHub MCP, etc.) at /init or by hand-editing this file.",
+    "allow": [
+      "mcp__context7__query-docs",
+      "mcp__context7__resolve-library-id"
+    ]
+  },
+
+  "hooks": {
+    "_comment": "All hook scripts referenced below should live at $CLAUDE_PROJECT_DIR/.harness/scripts/. The harness ships templates; /init copies them and the user customizes each for the project's stack.",
+
+    "UserPromptSubmit": [
+      {
+        "_comment": "Bootstrap gate: fires on EVERY user prompt. If .harness/state/install.json is missing (harness installed but not yet configured), injects a directive telling Claude to read standalone-bootstrap.md and run the bootstrap flow BEFORE responding to the user. Once install.json exists, this hook exits silently. Critical for the harness's 'self-bootstrap on first interaction' design.",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.harness/scripts/bootstrap-check.sh",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "_comment": "Budget pressure monitor (P1.6): fires on every user prompt. Reads transcript size, emits advisory additionalContext at 50%/75%/90% thresholds instructing Claude to prefer cheaper models / skip Explore subagents / recommend /compact. Silent under 50%. Configurable via CCC_CONTEXT_BUDGET env var (default 200000).",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.harness/scripts/budget-monitor.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+
+    "PreToolUse": [
+      {
+        "_comment": "Pre-commit gate: typecheck + lint-bans + cycles. Matcher constrains to Bash calls; each script self-filters to `git commit` invocations via stdin parsing (settings.json `if` clause was found not to be honored consistently — see harness-testing-2026-05-25.md § P0.Z).",
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.harness/scripts/precommit-typecheck.sh",
+            "timeout": 120,
+            "statusMessage": "Running typecheck before commit..."
+          },
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.harness/scripts/lint-bans.sh",
+            "timeout": 30,
+            "statusMessage": "Scanning for anti-flag patterns before commit..."
+          },
+          {
+            "type": "command",
+            "_comment": "Cycles check is only meaningful if `dependency_flow` slot is non-empty. /init removes this entry on projects that opt out.",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.harness/scripts/precommit-cycles.sh",
+            "timeout": 60,
+            "statusMessage": "Checking for dependency cycles..."
+          }
+        ]
+      }
+    ],
+
+    "PostToolUse": [
+      {
+        "_comment": "Run formatter on every Edit/Write. The format-edit.sh script picks the right formatter based on file extension.",
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.harness/scripts/format-edit.sh",
+            "timeout": 30,
+            "statusMessage": "Running formatter..."
+          }
+        ]
+      }
+    ],
+
+    "SessionStart": [
+      {
+        "_comment": "Memory archive (v2 Phase 2): migrates recall-tier entries older than CCC_ARCHIVE_AGE_DAYS (default 30) into archive/<YYYY-MM>.jsonl. Runs FIRST so memory-recall reads a freshly-pruned recall tier. Also back-fills `id` on legacy v1 entries.",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.harness/scripts/memory-archive.sh",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "_comment": "Memory recall v2 (manifest mode): injects ONLY index lines (one per entry, ~80 tokens) for the recall tier. AI fetches bodies on-demand via /recall <id>. ~70% token savings vs v1 eager-injection. See docs-harness/context-architecture-v2.md § Phase 2.",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.harness/scripts/memory-recall.sh",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "_comment": "Scratchpad recall (v2 Phase 4): reads .harness/state/scratchpad.md and injects as additionalContext. Working-memory tier — always loaded.",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.harness/scripts/scratchpad-recall.sh",
+            "timeout": 5
+          }
+        ]
+      },
+      {
+        "_comment": "Checkpoint recall: detects current git branch's feature, reads .harness/state/workflow-checkpoints/<feature>.json if it exists, injects additionalContext telling MAGI Core to surface the resume offer to the user.",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.harness/scripts/checkpoint-recall.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+
+    "Stop": [
+      {
+        "_comment": "Scratchpad update (v2 Phase 4): fires at end of each AI turn. Instructs AI to rewrite .harness/state/scratchpad.md with current objective / last step / next step / blockers. Manus-style recitation bias against context distraction.",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.harness/scripts/scratchpad-update.sh",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+
+    "PreCompaction": [
+      {
+        "_comment": "Memory snapshot: prompts Claude (via additionalContext) to summarize the session's key decisions into .harness/memory/observations.jsonl BEFORE context compaction proceeds. Claude does the summarization; the hook just orchestrates the prompt.",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.harness/scripts/memory-snapshot.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}