feat(v1.8.5 Stage 8 DONE): changelog-spec v1 三语 + violations.md F-code mapping + SKILL.md 3 new HARD RULES

jasonhnd · jasonhnd · commit 33ee80a2e77e · 2026-05-23T19:54:52.000+09:00
Files (5):
- references/changelog-spec.md v1 (EN, ZH, JA) — CHANGELOG entry schema for v1.8.5+ (7 required YAML fields: version/date/type/breaking_changes/alternatives_considered/ordering_dependency/regression_cases_added)
- pro/compliance/violations.md +F-code mapping reference table + v1.8.5+ format spec (7 cols incl. F-Code)
- SKILL.md +3 new HARD RULES (No .py/.sh in repo, violations.md F-Code required v1.8.5+, CHANGELOG schema v1 required v1.8.5+) + references section updated with 6 new v1.8.5 specs

Stage 8 borrowed from eou-foundry:
- CHANGELOG YAML frontmatter pattern: self-evolution/ecp/*.yml schema (12+ fields → simplified to 7 for life_OS)
- alternatives_considered + ordering_dependency: ECP-0011 + ECP-0015-0017 cohort precedent
- F-code mapping: engine/failure-taxonomy.yml F1-F17 mapped to existing A-F process taxonomy

Stage 8 trade-offs:
- HARD RULE tabularization of all old rules: DEFERRED (would be its own Stage)
- v1.8.5 release entry in CHANGELOG.md: DEFERRED to Stage 10 大同步
- Retroactive F-code labeling of 77 historical violation rows: OPTIONAL (lazy during AUDITOR reviews)

Stage 8 DONE. Next: Stage 9 (28 regression fixtures — partly done already, fill remaining).
diff --git a/SKILL.md b/SKILL.md
@@ -347,10 +347,42 @@ Platform auto-detects → reads `pro/CLAUDE.md` (Claude) / `pro/GEMINI.md` (Gemi
 
 **Update**: Say "update" (or theme equivalent) when prompted, or at any time to check and apply updates.
 
+## v1.8.5 NEW HARD RULES (per RFC `_meta/rfc/v1.8.5-cleanup-and-hardening.md`)
+
+### HARD RULE · No .py / .sh files in lifeos repo (Stage 2)
+
+After v1.8.5 hook-layer retirement, the repo MUST contain ZERO `.py` and `.sh` files (excluding `backup/`, `.git/`, `.venv/`). All executable logic moves to `.claude/commands/*.md` slash commands invoked via Claude CLI / Codex CLI / Gemini CLI.
+
+**Verification**: `find . -type f \( -name '*.py' -o -name '*.sh' \) -not -path './backup/*' -not -path './.git/*' -not -path './.venv/*'` MUST return empty. `/verify-release` check #8 enforces.
+
+**Violation**: F4 SCOPE_FAILURE (re-introducing executable scripting after v1.8.5 retirement).
+
+### HARD RULE · violations.md F-Code required for v1.8.5+ entries (Stage 8)
+
+Every new row in `pro/compliance/violations.md` from v1.8.5 onwards MUST include the `F-Code` column (one of F1-F17 from `references/failure-taxonomy.md`). The legacy A-F process taxonomy (A1/A2/A3/B/C/D/E/F) and the new F1-F17 architecture taxonomy are complementary — both apply per violation.
+
+**Format**: `| Timestamp | Trigger | Type (A-F) | F-Code | Severity | Details | Resolved |`
+
+**Mapping reference**: see `pro/compliance/violations.md` §"A-F → F-Code Typical Mappings".
+
+**Violation**: F3 SCHEMA_FAILURE (violation row missing required F-Code column).
+
+### HARD RULE · CHANGELOG schema v1 for v1.8.5+ release entries (Stage 8)
+
+Every release entry from v1.8.5 onwards MUST conform to `references/changelog-spec.md` v1 schema:
+- 7 required YAML frontmatter fields (version / date / type / breaking_changes / alternatives_considered / ordering_dependency / regression_cases_added)
+- `alternatives_considered` MUST contain ≥1 substantive `option` + `rejected_because` pair
+- Three-language sync (EN + zh + ja) per HARD RULE `三语文档同步`
+
+**Validation**: AUDITOR Mode 7 (planned). Manual check: every v1.8.5+ release has YAML frontmatter with all 7 fields.
+
+**Violation**: F3 SCHEMA_FAILURE (CHANGELOG entry without v1.8.5+ schema).
+
 ## References
 
 - Orchestration: `pro/CLAUDE.md` · Agent definitions: `pro/agents/*.md` · Global rules: `pro/GLOBAL.md`
 - Themes: `themes/*.md` · Domain details: `references/domains.md` · Scenario configs: `references/scene-configs.md`
 - Data architecture: `references/data-layer.md` · Data model: `references/data-model.md`
 - Strategic Map: `references/strategic-map-spec.md`
 - Wiki: `references/wiki-spec.md` · SOUL: `references/soul-spec.md` · DREAM: `references/dream-spec.md`
+- **v1.8.5 new**: `references/failure-taxonomy.md` (F1-F17) · `references/refactoring-patterns.md` (8+2) · `references/risk-domains.md` (R1-R8) · `references/lifecycle-gates.md` (8 transitions) · `references/agent-spec.md` (v2) · `references/changelog-spec.md` (v1)
diff --git a/i18n/ja/references/changelog-spec.md b/i18n/ja/references/changelog-spec.md
@@ -0,0 +1,121 @@
+---
+spec_id: changelog.v1
+description: CHANGELOG.md entry schema v1（v1.8.5+ 有効）。eou-foundry ECP YAML frontmatter パターンを借用 —— 各 release entry が構造化された YAML frontmatter（version、breaking_changes、alternatives_considered、ordering_dependency、regression_cases_added）+ markdown 本文を持つ。v1.8.5 前のエントリは叙述的のまま（legacy）。
+status: active
+authoritative: true
+source_attribution: xiaolai/eou-foundry @ e4b12ce, self-evolution/ecp/ YAML schema
+introduced_in: v1.8.5
+---
+
+# CHANGELOG 仕様書 v1
+
+CHANGELOG.md エントリは v1.8.5 以降、構造化された YAML frontmatter + markdown 本文を持つ。v1.8.5 前のエントリは叙述的のまま変更なし（legacy）。
+
+## なぜ構造化 frontmatter
+
+v1.8.4 CHANGELOG エントリは叙述的 —— 人間には有用だが機械パース不可能。eou-foundry が浮き彫りにした 3 つの問題：
+
+1. **alternatives_considered なし**: エントリは何をしたかを記録するが、何を考慮して拒否したかを記録しない。「なぜ X をしなかったか」は歴史から失われる。
+2. **ordering_dependency なし**: コホート release（例 ECPs 0015-0017 が一緒に land しなければならない）に明示的宣言がない。cherry-pick が問題を引き起こした。
+3. **regression_cases_added なし**: 「これを修正した」から「再発防止のために回帰テストを追加した」へのリンクが暗黙的でしばしば欠落。
+
+v1.8.5+ schema がこれらを修正。
+
+## v1.8.5+ Entry Schema
+
+```markdown
+---
+version: 1.8.5
+date: 2026-07-15
+type: major | minor | patch
+breaking_changes:                          # 箇条書きリスト
+  - "SOUL.md schema v1 → v2（X-over-Y formulation 必須）"
+  - "wiki entry schema v1 → v2（active+ エントリで outlier slot 必須）"
+  - "21 agent frontmatter v1 → v2（authority_level / blast_radius 必須）"
+new_features:
+  - "F1-F17 失敗分類法（references/failure-taxonomy.md）"
+fixes: []
+
+# v1.8.5+ 必須: 少なくとも 1 つの拒否されたオプションと理由
+alternatives_considered:
+  - option: "v1.8 のまま、6 ヶ月で 30 個の minor patch として ship"
+    rejected_because: "30 個の独立した release = 30 個の移行パス；ユーザーは 1 回のアップグレードを希望"
+  - option: "叙述的 CHANGELOG を保持（YAML frontmatter なし）"
+    rejected_because: "grep 可能性とコホート依存追跡を失う"
+
+# v1.8.5+ 必須: クロス release 依存宣言
+ordering_dependency:
+  blocked_by: []                           # 先に land しなければならない SHA / version ref
+  must_coexist_with:                       # 一緒に ship しなければならない他の commits/refs
+    - Stage 0（failure-taxonomy + refactoring-patterns）
+    - Stage 1（SOUL v2）
+    - Stage 2（wiki v2）
+
+# v1.8.5+ 必須: この release で追加された回帰ケース
+regression_cases_added:
+  - rc-soul-no-priority
+  - rc-soul-no-outlier
+  - rc-soul-strawman-y
+  - rc-wiki-no-outlier
+  - rc-wiki-no-hypothesis
+  - rc-agent-no-authority
+  - rc-agent-blast-radius-violation
+---
+
+## v1.8.5 — Hook Retirement + EOU Hardening · 2026-07-15
+
+> 1 段落の release 概要。
+
+### ハイライト
+
+- ユーザーが見える項目のリスト
+
+### 移行
+
+- ユーザーが前のバージョンからアップグレードする方法
+- 実行する slash command（例 `/migrate-soul-v2`）
+- 後方互換性ノート（D3 12 ヶ月 legacy 共存）
+
+### 謝辞 / 背景
+
+- （オプションの叙述セクション）
+```
+
+## v1.8.5+ 必須 YAML フィールド
+
+v1.8.5 以降の各 release entry:
+
+1. **version**: semver 文字列、例 `"1.8.5"`
+2. **date**: ISO YYYY-MM-DD
+3. **type**: `major | minor | patch | prerelease` のいずれか
+4. **breaking_changes**: 配列（非破壊的 release では空可；空でも必須フィールド）
+5. **alternatives_considered**: `option` + `rejected_because` を持つ ≥1 エントリ。「他に何も考慮しなかった」は有効値ではない。
+6. **ordering_dependency**: `blocked_by` 配列 + `must_coexist_with` 配列（独立 patch では空可）
+7. **regression_cases_added**: `rc-*` id 配列（回帰ケースなしで空可だがレビューすべき —— ほとんどの修正は回帰カバレッジに値する）
+
+`new_features` と `fixes` は推奨だが必須ではない。
+
+## 検証
+
+AUDITOR Mode 7（Stage 10 で追加、v1.8.5 release で計画中）が検証:
+- v1.8.5+ の各 release entry が 7 つの必須フィールドすべてを持つ
+- `alternatives_considered` が ≥1 実質的エントリ（LLM 啟發式: rejected_because ≥20 文字 + 非自明）
+- `ordering_dependency.must_coexist_with` 参照が実際の commits/PRs/Stages に解決
+- `regression_cases_added` 参照が `evals/regression-fixtures/` に存在
+
+## Legacy entries（v1.8.5 前）
+
+v1.8.5 前の CHANGELOG エントリ（v1.0.0 から v1.8.4）は叙述的のまま。遡及的移行不要。Schema は v1.8.5 entry から適用。
+
+## 三言語同期
+
+HARD RULE `三言語ドキュメント同期` に従い、YAML frontmatter schema はすべての 3 CHANGELOG ファイルに適用:
+- `CHANGELOG.md`（EN）
+- `i18n/zh/CHANGELOG.md`（ZH）
+- `i18n/ja/CHANGELOG.md`（JA）
+
+3 つすべてが同じ v1.8.5+ entry を同じ YAML frontmatter で持つ必要がある（翻訳された本文だが同じ構造化フィールド）。
+
+## ソース出典
+
+eou-foundry @ e4b12ce — `self-evolution/ecp/*.yml` YAML schema（各 ECP は id / target_eou / target_version_from / target_version_to / problem / proposed_change / alternatives_considered / ordering_dependency を持つ）。life_OS CHANGELOG 向けに適応（release-level vs ECP-level）: 7 フィールドに簡略化、最も重要な 3 つを保持（alternatives_considered / ordering_dependency / regression_cases_added）。
diff --git a/i18n/zh/references/changelog-spec.md b/i18n/zh/references/changelog-spec.md
@@ -0,0 +1,125 @@
+---
+spec_id: changelog.v1
+description: CHANGELOG.md entry schema v1（v1.8.5+ 生效）。借鉴 eou-foundry ECP YAML frontmatter 模式 —— 每个 release entry 有结构化 YAML frontmatter（version、breaking_changes、alternatives_considered、ordering_dependency、regression_cases_added）+ markdown body 用于叙事 release notes。v1.8.5 前的 entry 保持叙事性（legacy）。
+status: active
+authoritative: true
+source_attribution: xiaolai/eou-foundry @ e4b12ce, self-evolution/ecp/ YAML schema
+introduced_in: v1.8.5
+---
+
+# CHANGELOG 规范 v1
+
+CHANGELOG.md entry v1.8.5 起有结构化 YAML frontmatter + markdown body。v1.8.5 前的 entry 是叙事性的，保持不变（legacy）。
+
+## 为什么结构化 frontmatter
+
+v1.8.4 CHANGELOG entry 是叙事性的 —— 对人类有用但机器不可解析。eou-foundry 帮助暴露 3 个问题：
+
+1. **无 alternatives_considered**: entry 记录做了什么，没记录考虑了什么并拒绝了什么。"为什么没做 X" 失去历史。
+2. **无 ordering_dependency**: cohort releases（如 ECPs 0015-0017 必须一起 land）没有显式声明。cherry-pick 造成问题。
+3. **无 regression_cases_added**: 从"修了这个"到"加了回归测试防复发"的链接是隐式的，常缺失。
+
+v1.8.5+ schema 修复这些。
+
+## v1.8.5+ Entry Schema
+
+```markdown
+---
+version: 1.8.5
+date: 2026-07-15
+type: major | minor | patch
+breaking_changes:                          # 项目列表
+  - "SOUL.md schema v1 → v2（X-over-Y formulation 必填）"
+  - "wiki entry schema v1 → v2（active+ entry outlier slot 必填）"
+  - "21 agent frontmatter v1 → v2（authority_level / blast_radius 必填）"
+new_features:                              # 项目列表
+  - "F1-F17 失败分类法（references/failure-taxonomy.md）"
+  - "..."
+fixes:                                     # 项目列表
+  - "..."
+
+# v1.8.5+ 必需: 至少 1 个被拒选项及原因
+alternatives_considered:
+  - option: "保持 v1.8，分 6 个月做 30 个 minor patch"
+    rejected_because: "30 个独立 release = 30 个迁移路径；用户要一次升级"
+  - option: "保持叙事 CHANGELOG（无 YAML frontmatter）"
+    rejected_because: "失去 grep-ability + cohort dependency 追踪"
+
+# v1.8.5+ 必需: 跨 release 依赖声明
+ordering_dependency:
+  blocked_by: []                           # 必须先 land 的 SHA / version ref
+  must_coexist_with:                       # 必须一起 ship 的其他 commits/refs
+    - Stage 0（failure-taxonomy + refactoring-patterns）
+    - Stage 1（SOUL v2）
+    - Stage 2（wiki v2）
+    # ... 等
+
+# v1.8.5+ 必需: 此次 release 加的回归用例
+regression_cases_added:
+  - rc-soul-no-priority
+  - rc-soul-no-outlier
+  - rc-soul-strawman-y
+  - rc-wiki-no-outlier
+  - rc-wiki-no-hypothesis
+  - rc-agent-no-authority
+  - rc-agent-blast-radius-violation
+---
+
+## v1.8.5 — Hook Retirement + EOU Hardening · 2026-07-15
+
+> 1 段 release 总结。
+
+### 亮点
+
+- 用户可见亮点项目列表
+- ...
+
+### 迁移
+
+- 用户如何从之前版本升级
+- 跑哪些 slash command（如 `/migrate-soul-v2`）
+- 向后兼容说明（D3 12 个月 legacy 共存）
+
+### 致谢 / 背景
+
+- （可选叙事段）
+```
+
+## v1.8.5+ 必需 YAML 字段
+
+v1.8.5 起每个 release entry:
+
+1. **version**: semver 字符串，如 `"1.8.5"`
+2. **date**: ISO YYYY-MM-DD
+3. **type**: `major | minor | patch | prerelease` 之一
+4. **breaking_changes**: 数组（非破坏性 release 可空；即使空也必需字段）
+5. **alternatives_considered**: ≥1 entry 含 `option` + `rejected_because`。"我们没考虑别的" 不是有效值。
+6. **ordering_dependency**: `blocked_by` 数组 + `must_coexist_with` 数组（独立 patch 可空）
+7. **regression_cases_added**: `rc-*` id 数组（无回归用例可空，但应 review —— 多数修复值得回归覆盖）
+
+`new_features` 和 `fixes` 推荐但非必需。
+
+## 验证
+
+AUDITOR Mode 7（Stage 10 添加，v1.8.5 release 规划中）将验证:
+- v1.8.5+ 每个 release entry 有所有 7 个必需字段
+- `alternatives_considered` 有 ≥1 实质条目（LLM 启发式: rejected_because ≥20 字符 + 非平凡）
+- `ordering_dependency.must_coexist_with` 引用解析到实际 commits/PRs/Stages
+- `regression_cases_added` 引用存在于 `evals/regression-fixtures/`
+
+## Legacy entries（v1.8.5 前）
+
+v1.8.5 前的 CHANGELOG entry（v1.0.0 到 v1.8.4）保持叙事性。无需追溯迁移。Schema 从 v1.8.5 entry 开始适用。
+
+## 三语同步
+
+按 HARD RULE `三语文档同步`，YAML frontmatter schema 适用所有 3 个 CHANGELOG 文件:
+- `CHANGELOG.md`（EN）
+- `i18n/zh/CHANGELOG.md`（ZH）
+- `i18n/ja/CHANGELOG.md`（JA）
+
+3 个都必须有同一 v1.8.5+ entry 含同一 YAML frontmatter（body 翻译但结构化字段相同）。
+
+## 来源出处
+
+eou-foundry @ e4b12ce — `self-evolution/ecp/*.yml` YAML schema（每个 ECP 有 id / target_eou / target_version_from / target_version_to / problem / proposed_change / alternatives_considered / ordering_dependency）。为 life_OS CHANGELOG 适配（release-level vs ECP-level）：简化到 7 字段，保留 3 个最关键（alternatives_considered / ordering_dependency / regression_cases_added）。
diff --git a/pro/compliance/violations.md b/pro/compliance/violations.md
@@ -4,10 +4,60 @@
 
 ## Format
 
+### v1.8.4 and earlier (legacy — 77 historical rows)
+
 ```
 | Timestamp (ISO 8601) | Trigger | Type | Severity | Details | Resolved |
 ```
 
+### v1.8.5+ format (HARD RULE per RFC Stage 8)
+
+```
+| Timestamp (ISO 8601) | Trigger | Type (A-F) | F-Code | Severity | Details | Resolved |
+```
+
+Every v1.8.5+ violation row MUST include the `F-Code` column with a value from `references/failure-taxonomy.md` (F1-F17). The legacy A-F process taxonomy (A1/A2/A3/B/C/D/E/F) and the F1-F17 architecture taxonomy are complementary — both apply per violation.
+
+## F-Code Quick Reference
+
+| F-Code | Class | When to use |
+|--------|-------|-------------|
+| F1 | INPUT_FAILURE | Required input missing / malformed / stale / ambiguous |
+| F2 | CONTEXT_FAILURE | Wrong context loaded / source of truth omitted |
+| F3 | SCHEMA_FAILURE | spec / input / output / validator schemas diverge |
+| F4 | SCOPE_FAILURE | agent / EOU / skill too broad / too narrow / mixed |
+| F5 | INSTRUCTION_FAILURE | Steps unclear / contradictory / non-executable |
+| F6a | STRUCTURAL_JUDGMENT | Agent conflates distinct judgments |
+| F6b | COVERAGE | Right judgment, no validation criteria |
+| F7 | VALIDATION_FAILURE | Validator passes invalid OR rejects valid |
+| F8 | TOOL_FAILURE | Script / model / API / external tool hard fail |
+| F9 | TRACE_FAILURE | Run unreconstructible / trace missing |
+| F10 | RESPONSIBILITY_FAILURE | No owner / approval gate / executor=approver |
+| F11 | LIFECYCLE_FAILURE | Wrong maturity standard applied |
+| F12 | DRIFT_FAILURE | Specs / scripts / docs / validators diverged |
+| F13 | PERFORMANCE_FAILURE | Correct but degrades at scale |
+| **F14** | **SILENT_JUDGMENT_FAILURE** | **Contested choice without value_invocations (most dangerous)** |
+| F15 | VALUE_HIERARCHY_FAILURE | Lower-priority SOUL dim over higher-priority |
+| F16 | VALUE_DRIFT_FAILURE | Multi-run invocation drift from SOUL priority |
+| F17 | VALUE_HALLUCINATION_FAILURE | Cited SOUL dim id doesn't exist |
+
+## A-F → F-Code Typical Mappings
+
+For legacy A-F violations, the typical F-code mapping (one A-F class often spans multiple F-codes; pick the most specific):
+
+| A-F Class | Common F-codes |
+|-----------|----------------|
+| A1 (skip retrospective subagent) | F11 LIFECYCLE_FAILURE |
+| A2 (skip archiver phase) | F11 LIFECYCLE_FAILURE |
+| A3 (skip mandatory tool call) | F1 INPUT_FAILURE OR F9 TRACE_FAILURE |
+| B (confabulated path / fabricated evidence) | F12 DRIFT_FAILURE OR F17 VALUE_HALLUCINATION |
+| C (skip step / placeholder phase / no audit trail) | F9 TRACE_FAILURE OR F11 LIFECYCLE_FAILURE |
+| D (self-approve / responsibility violation) | F10 RESPONSIBILITY_FAILURE |
+| E (release alignment failure / publish-skip) | F11 LIFECYCLE_FAILURE |
+| F (outbound PII leak) | F2 CONTEXT_FAILURE + F8 TOOL_FAILURE |
+
+Retroactive F-code labeling of 77 historical rows is OPTIONAL — done lazily during AUDITOR Mode 3 reviews or during incident triage.
+
 ## Violations
 
 | Timestamp | Trigger | Type | Severity | Details | Resolved |
diff --git a/references/changelog-spec.md b/references/changelog-spec.md
