Skip to content

Commit 3dda141

Browse files
sgwannabeclaude
andauthored
feat(methodology): Rule 10 — Output language English (Layer-0) (#107)
User-facing output from any of the 144 plugin agents (AskUserQuestion modal labels, console prose, status messages, Gate H1/H2 modals, generated artifacts the user reads directly) MUST be in English. Korean prompts from the user are not a switch signal — agents reply in English by default. Single-turn override only via explicit per-turn directive. Why: the repo's archive (commits, PR bodies, code, schemas, root CHANGELOG) is English-only per CONTRIBUTING.md "Language" section. A bilingual user surface breaks searchability for non-Korean reviewers and contradicts the documented policy. Scope: this rule constrains the *output the agent emits to the user*, not the language of the agent's own markdown prompt (which may stay in Korean for maintenance — many existing agent prompts are Korean). Enforcement: Layer-0 rule, propagated to all 144 agents via `@methodology/global.md`. factory-policy.py does not parse natural-language output, so enforcement is by agent compliance. A future hook may scan AskUserQuestion payloads for Hangul code points and warn — tracked separately. Side effects: - Updates section title from "7개 비협상 규칙" to neutral "Layer-0 비협상 규칙" (count was already stale — Rules 8 and 9 were added later) - Updates the 불변 원칙 footer to acknowledge Rules 1-10 - No agent file modified — the rule reaches all agents via the existing @methodology/global.md include in their frontmatter - verify-plugin.sh: still 58/0 Refs #102 (closing the gap that #102 didn't cover — endusers' actual plugin output language) Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent dcaeb8a commit 3dda141

1 file changed

Lines changed: 39 additions & 2 deletions

File tree

plugins/preview-forge/methodology/global.md

Lines changed: 39 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
77
---
88

9-
## 7개 비협상 규칙 (Non-negotiable Rules)
9+
## Layer-0 비협상 규칙 (Non-negotiable Rules)
1010

1111
### Rule 1 — Gate 없이 진행 금지
1212
- PreviewDD → SpecDD 전환은 Gate H1 (인간 디자인 승인) 없이 불가
@@ -99,6 +99,43 @@ export PF_DRIFT_BYPASS=1 PF_DRIFT_REASON="SpecDD explicitly expanding to include
9999
- Gate H1 완료 전 (chosen_preview.json 없음) → no-op
100100
- 120자 미만 write → no-op (오타 수정 false positive 방지)
101101

102+
### Rule 10 — Output language: English (v1.13+)
103+
104+
All user-facing output produced by any of the 144 agents in this plugin
105+
**MUST be in English**, regardless of the language the user prompts in.
106+
This includes (non-exhaustive):
107+
108+
- `AskUserQuestion` modal `question`, `header`, option `label` and
109+
`description` fields
110+
- Console / chat prose responses to the user
111+
- Status messages, progress updates, standup summaries
112+
- Modal labels at Gate H1 and Gate H2
113+
- Error messages surfaced to the user
114+
- Generated artifacts that the user reads directly:
115+
`mockups/gallery-text.md`, `score/report.json` summaries,
116+
`runs/<id>/trace.log` user-facing lines
117+
118+
**Why**: this plugin's archive (commits, PR bodies, root CHANGELOG, code,
119+
schemas) is English-only — see `CONTRIBUTING.md` "Language" section.
120+
A bilingual user surface defeats searchability for non-Korean reviewers
121+
and contradicts the documented policy. Korean prompts from the user are
122+
**not** a switch signal — agents reply in English by default.
123+
124+
**Single-turn override**: only when the user issues an explicit per-turn
125+
directive such as *"reply in Korean for this answer"*. Once the turn
126+
ends, the next response returns to English.
127+
128+
**Markdown of the agent files themselves**: the prose **inside**
129+
`agents/**/*.md` and `commands/*.md` may stay in Korean for maintenance
130+
(many existing agent prompts are in Korean). What's enforced is the
131+
*output the agent emits to the user*, not the language of the prompt
132+
the agent was authored in.
133+
134+
**Enforcement**: this rule is Layer-0; `factory-policy.py` does not
135+
parse natural-language output, so enforcement is by agent compliance.
136+
A future hook may scan `AskUserQuestion` modal payloads for Hangul code
137+
points and warn — tracked separately.
138+
102139
---
103140

104141
## 모델 · effort 강제 정책
@@ -153,4 +190,4 @@ Per-call payload cap: 1-4 questions per AskUserQuestion call (Claude Code tool s
153190

154191
## 불변 원칙
155192

156-
이 문서는 plugin v1.0.0 기준 7 rules를 정의합니다. v2.0.0 이전까지 **추가만 가능, 수정·삭제 불가**. v2.0.0에서 breaking change가 있을 경우에도 각 규칙의 의도는 유지되어야 합니다.
193+
이 문서는 plugin v1.0.0 기준 7 rules로 출발하여 점진적으로 확장되었습니다 (현재 Rule 10까지). v2.0.0 이전까지 **추가만 가능, 수정·삭제 불가**. v2.0.0에서 breaking change가 있을 경우에도 각 규칙의 의도는 유지되어야 합니다.

0 commit comments

Comments
 (0)