spec/README.html は spec cluster の entry point (人間読者 = 仕様を参照する開発者) だが、 §5 Change Log (2026-05-22〜24 で更新停止) と §6.2 の解消済 defer 行は dated 作業記録であり、 入口層の可読性を下げていた。 ADR-0039 §2.4 の編集規範 (「作業ログ類の人間面からの撤去 — research / git 履歴へ」) に従い 2026-06-11 に本 doc へ verbatim 退避した。 frozen ADR divergence trace と未解消の既知制限は spec/README §6.2 に残置 (退避対象は解消済・stale 行のみ)。 以後の変更履歴の SSoT は git log + ADR + delta marker (rules §5)。
| date | change | related ADR / commit |
|---|---|---|
| 2026-05-24 | Phase 2.5 完遂: hooks/ を plugin root 直下に移動 (Option C 採用、 Claude Code 公式仕様 plugins-reference L733 準拠)。 scripts/ は .claude-plugin/ 維持で P-11 部分隔離継続。 実機検証 (claude --plugin-dir 経由) で 3 hook 全 fire 確認、 PostToolUse blocking error も検証 (Issue #39344 一部解消の証拠) |
commit 1b18ddb、 spawn 検証 × 3 (folio-test-090218 / -b093240 / -c094741) で 真因確定 + Option A/B/C 比較 → Option C 採用 |
| 2026-05-24 | §6 Open TODO を 3 sub-section に再編 (§6.1 dogfood / §6.2 Phase X3 deferred / §6.3 ADR 候補)。 Phase X3 Step 0-2 完遂 (sandbox-verified 2/3、 14/14 PASS) 過程で発生した deferred 事項を集約 trace。 spec 本文の編集なし、 informative TODO の整理のみ | Phase X3 Step 0 (b0a1155) / Step 1 (53f9929 + dffe235) / Step 2 (e01f089 + 63c9cc6) 累積 |
| 2026-05-23 | Phase X3 着手準備: scope 漏れ統合 + verification framework spec 化。 新 file verification.html 新設 (REQ-VER-001〜005)、 folio-self-spec.html §7.6 (Phase X3 minimal plugin scope = 1 skill + 4 hook + 6 script + 1 CLI)、 rules.html §10.2 REQ-CI-016 (JSON-LD validation gate)、 relations.html §4.4 (inventory I/O behavior)、 ADR-0003 / 0013 / 0015 起票 |
research/plugin-architecture-research.html + research/plugin-sandbox-verification-research.html 結論の規範化 |
| 2026-05-22 | Phase 1 残り要素規範化: folio-self-spec.html head JSON-LD dogfood 解消、 rules.html §10.2 内 lychee + hyperlink enforcement 補強 (REQ-CI-010 詳細化)、 relations.html §5 normative 化 + EARS REQ-REL-001/002/003、 §4.2 3-tier mapping 具体例追加 | 本 commit |
| 2026-05-22 | relations.html を新設 (Phase 1 = JSON-LD + W3C 語彙 + inventory schema)、 rules.html §4.1 に JSON-LD 関係性表現を追加、 rules.html 自身の <head> JSON-LD も新規定準拠化、 README を index 化 (本 §1-§5) |
research/spec-graph-management-research.html 結論の規範化 |
| 2026-05-22 | scratch/specs/ dir 新設、 rules.html + folio-self-spec.html を移動 (ブラッシュアップ可化) | ADR-0002 |
| 2026-05-22 | architecture-rules.html を rules.html + folio-self-spec.html に分離 | ADR-0001 (v3) |
severity 「✓ 完遂」 の純作業記録、 および退避時点で stale と判明していた行 (SessionStart 未実装 = ADR-0007 で実装済 / Phase X1 placeholder = agents・skills・static は X4-F で撤去済、 bin・scripts・refs の予約 README は dormant のまま現存 — 残整理は bd issue で追跡)。
| 項目 | severity | 内容 | 解消 timing |
|---|---|---|---|
| verification §3.2 schema 拡張 | ✓ 完遂 | scenario YAML の given.{env, file_path, content} + when.tool を §3.2 schema に展開 (Stage 2a / D-6、 実装と整合) |
解消済 (Stage 2a、 commit 54c57b3) |
| shared lib 化 (実装済) | ✓ 完遂 | plugin-lib.sh 実装 (Phase 3 DRY refactor、 commit c292b47)。 8 関数 (folio_spec_path / read_payload / require_jq / json_field / under_spec_path / is_html / require_write_tool / deny) を 4 hook script が source 再利用 |
解消済 (Phase 3) |
| plugin 実機 install 確認 | ✓ 完遂 | Phase 2.5 で verification.html §4.1 Step 2 (worktree-based integration test) 達成。 symlink (~/.claude/plugins/folio) + Option C 構造 (hooks/ plugin root 直下) で cld auto discovery 経由 plugin load、 3 hook 全実機 fire 確認 (caller marker / path boundary / jsonld-lint)。 検証経過: plugin 構造誤り発覚 → 公式仕様調査 (plugins-reference L733) → Option C 採用 → 再検証 PASS |
commit 1b18ddb、 解消済 |
| LOW 級 review findings | LOW | yq 多重呼び (R1-2) / NotebookEdit test / subdirectory test / absolute path test / matcher array 形式 / 用語 cross-ref / FOLIO_SPEC_PATH override scenario | Step 3 以降の shared lib 化 + fold back |
| Phase X1 placeholder README.md | LOW | .claude-plugin/{agents,skills,scripts,bin,refs,static}/README.md は Phase X1 placeholder のまま |
試作完了時に整理 (Phase X3 終盤) |
| PostToolUse README update (check 型、 Step 4 完遂) | ✓ 完遂 | ADR-0003 §2.1「PostToolUse: README update」の試作 slice = check-readme-index.sh 実装済 (commit 5a2d9f2)。 挙動型 = check 型 (cluster README index 未掲載の .html を staleness notify、 file 改変なし)。 REQ-VER-008 / verification.html §3.6 (下記 divergence 行参照) |
Step 4 完了 (解消済、 commit 5a2d9f2) |
| SessionStart / inject-inventory 未実装 | MEDIUM | ADR-0003 §2.1 SessionStart hook (inject-inventory script、 Beads pattern で inventory.json を agent context に inject) は宣言済だが未実装。 hooks.json に SessionStart entry なし、 inject-inventory.sh 不在 |
Step 5 (context injection slice) で実装 |