Skip to content

Commit 68f623e

Browse files
DarKWinGTMclaude
andcommitted
Refine end-to-end language-aligned goal surface.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
1 parent 86339fd commit 68f623e

26 files changed

Lines changed: 560 additions & 69 deletions

README.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -19,16 +19,16 @@
1919
<table>
2020
<tr>
2121
<td align="center" width="200">
22-
<b>v10.23</b><br><sub>P115 Released</sub>
22+
<b>v10.24</b><br><sub>P116 Active</sub>
2323
</td>
2424
<td align="center" width="200">
2525
<b>18</b><br><sub>Active Runtime Rules</sub>
2626
</td>
2727
<td align="center" width="200">
28-
<b>Released</b><br><sub>Validation passed</sub>
28+
<b>Active</b><br><sub>Source sync in progress</sub>
2929
</td>
3030
<td align="center" width="200">
31-
<b>Playground</b><br><sub>Case family update</sub>
31+
<b>Language Surface</b><br><sub>End-to-end refinement</sub>
3232
</td>
3333
</tr>
3434
</table>
@@ -195,11 +195,10 @@ Codex CLI and Gemini CLI are not supported for this install surface in the curre
195195

196196
#### Runtime Context Discipline
197197
- 18 active runtime rules in the current compact merged source install set
198-
- P115 language-aware candidate-goal promotion playground case update is released as `v10.23`.
199-
- It adds one new scenario family showing dominant-session-language ownership, candidate-goal-first successor recommendations, and selective promotion into advisory `/goal` form.
200-
- It keeps the playground non-runtime and outside the 18-file runtime install payload.
201-
- It preserves the existing governed fact / observed case / virtual variant separation and uses pointer-level README integration instead of turning the top-level README into the scenario owner.
202-
- It passed runtime install-boundary recheck plus 18/18 source/runtime parity and source/destination body sufficiency.
198+
- P116 end-to-end language-aligned goal surface refinement is the active wave for `v10.24`.
199+
- It refines RULES so candidate goals, advisory `/goal`, recommendation labels, and recap/closing lines follow the dominant session language end-to-end instead of leaving English wrappers around Thai-first goal output.
200+
- It adds one new governed non-runtime playground case family for this language-surface behavior and keeps `playground/` outside the 18-file runtime install payload.
201+
- It preserves advisory `/goal`, keeps exact literals such as `/goal`, file paths, version tags, and code identifiers intact when they should remain exact, and keeps pointer-level README integration rather than turning the top-level README into the scenario owner.
203202
- P073 source compression completed and audited
204203
- P073/P077/P078/P079 runtime install parity was verified only after explicit install gates
205204
- P080 source governance is synchronized and runtime install parity is verified for the 42-rule set

TODO.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,22 @@
22

33
> **Last Updated:** 2026-05-20
44
> **Current Release:** v10.23 / P115 language-aware candidate-goal promotion playground case update
5-
> **Active Wave:** none currently open
5+
> **Active Wave:** P116 / v10.24 end-to-end language-aligned goal surface refinement
66
> **History:** [todo/history/2026-05-16.md](todo/history/2026-05-16.md); [todo/history/2026-05-08.md](todo/history/2026-05-08.md); [pre-rollover TODO snapshot](todo/history/2026-05-08-pre-rollover-TODO.md)
77
> **Done Detail:** [todo/done/rules-release-closeouts.md](todo/done/rules-release-closeouts.md); [todo/done/](todo/done/)
88
99
---
1010

1111
## ✅ Completed
1212

13+
## 🚧 Active / In Progress
14+
15+
- [ ] P116 / v10.24 end-to-end language-aligned goal surface refinement is in progress.
16+
- Scope: update the language surface of candidate goals, advisory `/goal`, recommendation labels, and recap/closing lines so dominant-session-language behavior is end-to-end rather than English-wrapper-first; add one new governed non-runtime playground case plus index update; and sync touched runtime/design/changelog/TODO/phase/patch/master surfaces.
17+
- Pending gate: preserve advisory `/goal`, keep exact literals exact, keep the active runtime install scope at 18 files, keep `playground/` outside the runtime payload, rerun install plus 18/18 source/runtime parity and source/destination body sufficiency, run `git diff --check`, push, verify GitHub release `v10.24`, and finalize closeout records.
18+
19+
## ✅ Completed
20+
1321
- [x] P115 / v10.23 language-aware candidate-goal promotion playground case update was completed, installed, pushed, and released.
1422
- Verified: `case-15-language-aware-candidate-goal-promotion.md`, playground index update, touched master/design/changelog/TODO/phase/patch sync, playground still excluded from the active runtime install payload, runtime install into `~/.claude/rules`, 18/18 source/runtime parity, source/destination body sufficiency, `git diff --check`, branch push, and GitHub release verification passed.
1523
- Release URL: https://github.com/DarKWinGTM/claude-code-rules/releases/tag/v10.23

accurate-communication.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Accurate Communication Standard
2-
> **Current Version:** 2.28
3-
> **Design:** [design/accurate-communication.design.md](design/accurate-communication.design.md) v2.28
2+
> **Current Version:** 2.29
3+
> **Design:** [design/accurate-communication.design.md](design/accurate-communication.design.md) v2.29
44
> **Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
55
> **Full history:** [changelog/accurate-communication.changelog.md](changelog/accurate-communication.changelog.md)
66
---
@@ -102,7 +102,7 @@ When reporting phase progress, phase meaning, next-step reasoning, or phase-back
102102
- if a candidate goal is promoted into `/goal`, keep that promotion visibly advisory and do not phrase it as queued or already-selected execution
103103
- if a `/goal` suggestion is offered, keep it visibly advisory and do not phrase it as queued or already-selected execution
104104
- when a `/goal` suggestion depends on proof, name only proof/checks that can be surfaced in the conversation rather than implying hidden verification
105-
- candidate goals and promoted `/goal` wording should follow the dominant session language by default unless the user explicitly selects another language
105+
- candidate goals, promoted `/goal`, surrounding recommendation labels, and recap/closing lines should follow the dominant session language by default unless the user explicitly selects another language style; exact literals such as `/goal`, file paths, version tags, and code identifiers may remain exact when they should not be translated
106106
### 9) Governing basis, post-compact, and memory
107107
- if multiple plausible policies/frames materially change the answer and evidence/instruction does not settle one, ask compactly for the governing basis first
108108
- after compact, use a short post-compact re-anchor, separate carried-forward facts from needs-recheck details, preserve the latest selected frame, and recheck material exact details before verified wording

changelog/accurate-communication.changelog.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Changelog - Accurate Communication Standard
22

33
> **Parent Document:** [../accurate-communication.md](../accurate-communication.md)
4-
> **Current Version:** 2.28
4+
> **Current Version:** 2.29
55
> **Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
66
77
---
@@ -10,6 +10,7 @@
1010

1111
| Version | Date | Changes | Session ID |
1212
|---------|------|---------|------------|
13+
| 2.29 | 2026-05-20 | **[Added P116 end-to-end language-surface wording refinement](#version-229)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1314
| 2.28 | 2026-05-20 | **[Added P114 language-aware candidate-goal wording refinement](#version-228)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1415
| 2.27 | 2026-05-19 | **[Added P110 meaning-first identifier wording refinement](#version-227)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1516
| 2.26 | 2026-05-18 | **[Added P107 advisory `/goal` wording guard](#version-226)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
@@ -73,6 +74,23 @@
7374

7475
---
7576

77+
<a id="version-229"></a>
78+
## Version 2.29: Added P116 end-to-end language-surface wording refinement
79+
80+
**Date:** 2026-05-20
81+
**Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
82+
83+
### Changes
84+
- Updated `accurate-communication.md` from v2.28 to v2.29.
85+
- Updated `design/accurate-communication.design.md` from v2.28 to v2.29.
86+
- Extended dominant-session-language wording from candidate-goal and promoted-`/goal` body text into surrounding recommendation labels and recap/closing lines.
87+
- Added explicit exact-literal preservation for `/goal`, file paths, version tags, and code identifiers when they should remain exact.
88+
89+
### Summary
90+
`accurate-communication.md` now closes the wording gap where non-English goal output could still be surrounded by English-first wrapper labels or recap text.
91+
92+
---
93+
7694
<a id="version-228"></a>
7795
## Version 2.28: Added P114 language-aware candidate-goal wording refinement
7896

changelog/changelog.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Master Changelog - Claude Code Rules
22

33
> **Project:** Claude Code Rules System
4-
> **Current Version:** 10.23
4+
> **Current Version:** 10.24
55
> **Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
66
> **Version Shards:** [changelog/](changelog/)
77
> **Legacy Archive:** [done/master-legacy-v6.3-v9.59.changelog.md](done/master-legacy-v6.3-v9.59.changelog.md)
@@ -12,6 +12,7 @@
1212

1313
| Version | Date | Changes | Session ID |
1414
|---------|------|---------|------------|
15+
| 10.24 | 2026-05-20 | **[Opened end-to-end language-aligned goal surface refinement](changelog/v10.24-added-end-to-end-language-aligned-goal-surface-refinement.changelog.md#version-1024)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1516
| 10.23 | 2026-05-20 | **[Released language-aware candidate-goal promotion playground case update](changelog/v10.23-added-language-aware-candidate-goal-promotion-playground-case-update.changelog.md#version-1023)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1617
| 10.22 | 2026-05-20 | **[Released language-aware candidate goal and goal-command doctrine](changelog/v10.22-added-language-aware-candidate-goal-and-goal-command-doctrine.changelog.md#version-1022)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1718
| 10.21 | 2026-05-20 | **[Released governed-work-only `/goal` context sourcing doctrine](changelog/v10.21-added-governed-work-only-goal-context-sourcing-doctrine.changelog.md#version-1021)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# Changelog Detail - Version 10.24: Added end-to-end language-aligned goal surface refinement
2+
3+
> **Parent Changelog:** [../changelog.md](../changelog.md)
4+
> **Parent Design:** [../../design/design.md](../../design/design.md)
5+
> **Current Version:** 10.24
6+
> **Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
7+
> **Status:** Prepared detail shard
8+
9+
---
10+
11+
<a id="version-1024"></a>
12+
## Version 10.24: Opened end-to-end language-aligned goal surface refinement
13+
14+
**Date:** 2026-05-20
15+
**Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
16+
17+
### Changes
18+
- Opened P116 on top of the released `v10.23 / P115` baseline.
19+
- Kept the README-listed source-owned active runtime set at 18 files.
20+
- Began refining RULES so candidate goals, advisory `/goal`, recommendation labels, and recap/closing lines follow the dominant session language end-to-end while preserving exact-literal boundaries.
21+
- Added one new governed non-runtime playground case family for end-to-end language-aligned goal-surface behavior.
22+
- Updated the playground index and touched release/design surfaces for this refinement.
23+
- Runtime install-boundary proof, parity/body-sufficiency verification, push, and GitHub release proof remain pending at this stage.
24+
25+
### Summary
26+
P116 opens a focused runtime + playground refinement wave so language-aligned goal output can be inspected as one end-to-end governed behavior rather than as command-body wording only.

changelog/communication-register.changelog.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Changelog - Communication Register
22

33
> **Parent Document:** [../communication-register.md](../communication-register.md)
4-
> **Current Version:** 1.6
4+
> **Current Version:** 1.7
55
> **Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
66
77
---
@@ -10,6 +10,7 @@
1010

1111
| Version | Date | Changes | Session ID |
1212
|---------|------|---------|------------|
13+
| 1.7 | 2026-05-20 | **[Added P116 end-to-end goal-surface register refinement](#version-17)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1314
| 1.6 | 2026-05-20 | **[Added P114 session-language and candidate-goal register refinement](#version-16)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1415
| 1.5 | 2026-05-19 | **[Added P110 easy-explanation register refinement](#version-15)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1516
| 1.4 | 2026-05-18 | **[Added P107 high-signal `/goal` pruning refinement](#version-14)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
@@ -22,6 +23,23 @@
2223

2324
---
2425

26+
<a id="version-17"></a>
27+
## Version 1.7: Added P116 end-to-end goal-surface register refinement
28+
29+
**Date:** 2026-05-20
30+
**Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
31+
32+
### Changes
33+
- Updated `communication-register.md` from v1.6 to v1.7.
34+
- Updated `design/communication-register.design.md` from v1.6 to v1.7.
35+
- Extended dominant-session-language guidance from candidate goals and promoted `/goal` body text into wrapper labels and recap lines.
36+
- Added an explicit register boundary so exact literals can remain exact instead of being translated by habit.
37+
38+
### Summary
39+
`communication-register.md` now keeps the whole visible goal surface aligned to the user's working language without forcing translation of exact tokens that should stay exact.
40+
41+
---
42+
2543
<a id="version-16"></a>
2644
## Version 1.6: Added P114 session-language and candidate-goal register refinement
2745

changelog/execution-and-goal-frame.changelog.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Changelog - Execution and Goal Frame
22

33
> **Parent Document:** [../execution-and-goal-frame.md](../execution-and-goal-frame.md)
4-
> **Current Version:** 1.8
4+
> **Current Version:** 1.9
55
> **Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
66
77
---
@@ -10,6 +10,7 @@
1010

1111
| Version | Date | Changes | Session ID |
1212
|---------|------|---------|------------|
13+
| 1.9 | 2026-05-20 | **[Added P116 end-to-end language-surface alignment](#version-19)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1314
| 1.8 | 2026-05-20 | **[Added P114 candidate-goal promotion bridge](#version-18)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1415
| 1.7 | 2026-05-20 | **[Added P113 governed-work-only `/goal` successor bridge](#version-17)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1516
| 1.6 | 2026-05-18 | **[Added P109 lineage-first continuation enforcement](#version-16)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
@@ -25,6 +26,23 @@
2526

2627
---
2728

29+
<a id="version-19"></a>
30+
## Version 1.9: Added P116 end-to-end language-surface alignment
31+
32+
**Date:** 2026-05-20
33+
**Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
34+
35+
### Changes
36+
- Updated `execution-and-goal-frame.md` from v1.8 to v1.9.
37+
- Updated `design/execution-and-goal-frame.design.md` from v1.8 to v1.9.
38+
- Extended dominant-session-language behavior from promoted `/goal` wording alone into candidate-goal labels, surrounding recommendation labels, and recap/closing lines.
39+
- Preserved exact-literal boundaries so `/goal`, file paths, version tags, and code-level identifiers can remain exact when needed.
40+
41+
### Summary
42+
`execution-and-goal-frame.md` now makes the visible goal surface end-to-end language-aligned instead of allowing English wrappers around non-English goal output.
43+
44+
---
45+
2846
<a id="version-18"></a>
2947
## Version 1.8: Added P114 candidate-goal promotion bridge
3048

changelog/explanation-and-presentation.changelog.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Changelog - Explanation and Presentation
22

33
> **Parent Document:** [../explanation-and-presentation.md](../explanation-and-presentation.md)
4-
> **Current Version:** 1.5
4+
> **Current Version:** 1.6
55
> **Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
66
77
---
@@ -10,6 +10,7 @@
1010

1111
| Version | Date | Changes | Session ID |
1212
|---------|------|---------|------------|
13+
| 1.6 | 2026-05-20 | **[Added P116 language-surface-neutral `/goal` output templates](#version-16)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1314
| 1.5 | 2026-05-20 | **[Added P114 candidate-goal presentation before `/goal` promotion](#version-15)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1415
| 1.4 | 2026-05-20 | **[Added P113 governed-work-only `/goal` output shaping](#version-14)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1516
| 1.3 | 2026-05-19 | **[Added P110 meaning-first identifier walkthroughs](#version-13)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
@@ -21,6 +22,23 @@
2122

2223
---
2324

25+
<a id="version-16"></a>
26+
## Version 1.6: Added P116 language-surface-neutral `/goal` output templates
27+
28+
**Date:** 2026-05-20
29+
**Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
30+
31+
### Changes
32+
- Updated `explanation-and-presentation.md` from v1.5 to v1.6.
33+
- Updated `design/explanation-and-presentation.design.md` from v1.5 to v1.6.
34+
- Replaced hardcoded English-first user-visible `/goal` wrapper examples with dominant-session-language-driven placeholders.
35+
- Preserved compact advisory `/goal` output while making wrapper labels and output examples language-surface-neutral.
36+
37+
### Summary
38+
`explanation-and-presentation.md` now shows user-visible `/goal` output shapes without hardcoding English wrappers that conflict with non-English session output.
39+
40+
---
41+
2442
<a id="version-15"></a>
2543
## Version 1.5: Added P114 candidate-goal presentation before `/goal` promotion
2644

changelog/phase-todo-artifact.changelog.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# Changelog - Phase, TODO, and Artifact Initiation
22

33
> **Parent Document:** [../phase-todo-artifact.md](../phase-todo-artifact.md)
4-
> **Current Version:** 1.11
4+
> **Current Version:** 1.12
55
> **Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
66
77
---
@@ -10,6 +10,7 @@
1010

1111
| Version | Date | Changes | Session ID |
1212
|---------|------|---------|------------|
13+
| 1.12 | 2026-05-20 | **[Added P116 language-surface concept-slot clarification](#version-112)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1314
| 1.11 | 2026-05-20 | **[Added P114 candidate-goal shaping before `/goal` sourcing](#version-111)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1415
| 1.10 | 2026-05-20 | **[Added P113 governed-work-only `/goal` sourcing order](#version-110)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
1516
| 1.9 | 2026-05-18 | **[Added P109 lineage-first phase identity enforcement](#version-19)** | 1f1873d2-0feb-485f-a5ff-d383254590dd |
@@ -27,6 +28,23 @@
2728

2829
---
2930

31+
<a id="version-112"></a>
32+
## Version 1.12: Added P116 language-surface concept-slot clarification
33+
34+
**Date:** 2026-05-20
35+
**Session:** 1f1873d2-0feb-485f-a5ff-d383254590dd
36+
37+
### Changes
38+
- Updated `phase-todo-artifact.md` from v1.11 to v1.12.
39+
- Updated `design/phase-todo-artifact.design.md` from v1.11 to v1.12.
40+
- Reframed `Done when` / `Prove with` / `Scope` / `Keep` / `Stop after` as concept-slot examples rather than mandatory English surface labels.
41+
- Preserved design-first and material-only governed `/goal` sourcing while allowing emitted wording to follow the dominant session language.
42+
43+
### Summary
44+
`phase-todo-artifact.md` now keeps governed `/goal` sourcing semantics stable without forcing English slot labels into non-English goal output.
45+
46+
---
47+
3048
<a id="version-111"></a>
3149
## Version 1.11: Added P114 candidate-goal shaping before `/goal` sourcing
3250

0 commit comments

Comments
 (0)