oh-my-customcode 1.1.74 → 1.1.75

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -109,6 +109,8 @@ Agent(qa-engineer):sonnet │
109
109
  Agent(arch-documenter):haiku ┘
110
110
  ```
111
111
 
112
+ Soft default is 4 concurrent agents, hard cap 5. Agent Teams (shared task list, peer messaging) is used instead of plain parallel agents when it's available — but it requires Claude Code to expose a `TeamCreate` tool, which is not present on a stock install today. Until then, oh-my-customcode's standard Agent-tool parallel model above is what actually runs.
113
+
112
114
  ---
113
115
 
114
116
  ### Agents (50)
@@ -170,6 +172,9 @@ All commands are invoked inside the Claude Code conversation.
170
172
  | `/adversarial-review` | Attacker-mindset security code review |
171
173
  | `/pipeline` | Execute YAML-defined pipelines |
172
174
  | `/pipeline resume` | Resume a halted pipeline from last failure point |
175
+ | `/omcustom:fsd` | Full Self Driving — autonomous release loop: repeats `/pipeline auto-dev` (issue → implement → verify → release) then `/homework` (retrospective audit) until no eligible issues remain |
176
+ | `/homework` | Retrospective audit of the current session, surfacing process gaps as feedback/issues |
177
+ | `/agora` | Anonymized multi-round, multi-vendor consensus review (independent CLI reviewers + rotating judge) for decisions that need adversarial scrutiny |
173
178
 
174
179
  ### Agent Management
175
180
 
@@ -217,7 +222,9 @@ All commands are invoked inside the Claude Code conversation.
217
222
  | **SHOULD** | 8 | Interaction, error handling, memory, HUD, ecomode, ontology routing, wiki sync, verification ladder |
218
223
  | **MAY** | 1 | Optimization |
219
224
 
220
- Key rules: R010 (orchestrator never writes files), R009 (parallel execution mandatory), R017 (sauron verification before push), R020 (completion verification before declaring done), R021 (advisory-first enforcement model).
225
+ Key rules: R010 (orchestrator never writes files), R009 (parallel execution mandatory), R017 (sauron verification before push), R020 (completion verification before declaring done), R021 (advisory-first enforcement — most rules are prompt-based, not hard-blocked), R016 (continuous improvement — violations update the rule, and stale clauses are retired into HTML comments rather than accumulating forever), R023 (verification ladder — cheapest check first: deterministic hooks/linters, then cheap-model review, then expensive-model review, then human).
226
+
227
+ R018 (Agent Teams) is conditional: it only takes effect when both `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` is set AND the `TeamCreate` tool is present in the tool list. On a stock Claude Code install today, `TeamCreate` is not registered, so R018 is dormant and R009/R010 (the standard Agent-tool parallel-execution model) govern instead.
221
228
 
222
229
  ---
223
230
 
@@ -229,16 +236,20 @@ Reference documentation covering best practices, architecture decisions, and int
229
236
 
230
237
  ## Safety
231
238
 
232
- oh-my-customcode includes security and lifecycle hooks:
239
+ oh-my-customcode ships 42 lifecycle hook scripts covering security, drift detection, and rule reinforcement. A few examples:
233
240
 
234
241
  | Hook | Trigger | Action |
235
242
  |------|---------|--------|
236
243
  | secret-filter | Bash, Read output | Detects AWS keys, API tokens, private keys, bearer tokens |
237
244
  | audit-log | Edit, Write, Bash, Agent | Append-only JSONL at `~/.claude/audit.jsonl` |
238
245
  | schema-validator | Write, Edit, Bash input | Validates tool inputs, flags dangerous patterns |
239
- | PostCompact | Context compaction | Reinjects enforced rules (R007–R018, R021) — prevents rule amnesia |
246
+ | claude-md-reinject | SessionStart (fresh session, resume, or compact) | Reinjects CLAUDE.md and the enforced rule set — prevents rule amnesia after context compaction |
247
+ | stuck-detector | PostToolUse, repeated edits | Flags an agent looping on the same file/edit without progress |
248
+ | r007-r008-drift-advisor | UserPromptSubmit, SubagentStop, PostToolUse | Advisory check that the last turn carried the required agent/tool identification headers |
240
249
 
241
- Security hooks are advisory (exit 0). They warn but never block.
250
+ Most hooks are advisory (exit 0) — they warn but never block. A small number of hard-block hooks (e.g. `stage-blocker`, `rule-deletion-guard`) reject the tool call outright (exit 2). oh-my-customcode's own governance rules (`.claude/rules/`) follow an **advisory-first enforcement model**: prompt-based guidance is the default, and a rule is only promoted to a blocking hook after repeated, observed violations. Rules also retire — clauses tied to since-fixed platform bugs or that go unused for two minor releases are wrapped in HTML comments (still readable via the source file, invisible to the agent's context) rather than left to accumulate indefinitely.
251
+
252
+ The hook source of truth is `.claude/hooks/hooks.json`; `omcustom init` compiles it into the `hooks` block of `.claude/settings.json` (via `src/core/hooks-settings.ts`), which is the file Claude Code actually loads.
242
253
 
243
254
  ---
244
255
 
@@ -273,7 +284,7 @@ your-project/
273
284
  │ ├── agents/ # 50 agent definitions
274
285
  │ ├── skills/ # 115 skill modules
275
286
  │ ├── rules/ # 23 governance rules (R000-R023)
276
- │ ├── hooks/ # 15 lifecycle hook scripts
287
+ │ ├── hooks/ # 42 lifecycle hook scripts (hooks.json source; compiled into settings.json)
277
288
  │ ├── schemas/ # Tool input validation schemas
278
289
  │ ├── specs/ # Extracted canonical specs
279
290
  │ ├── contexts/ # 4 shared context files
@@ -306,7 +317,9 @@ bun test # Run tests
306
317
  bun run build # Production build
307
318
  ```
308
319
 
309
- Requirements: Node.js >= 18.0.0, Claude Code CLI.
320
+ Requirements: Node.js >= 18.0.0, Claude Code CLI (developed and tested against Claude Code v2.1.277).
321
+
322
+ Releases are two-stage automation: a merged `release/vX.Y.Z` PR triggers `auto-tag.yml`, which creates the git tag; the tag push then triggers `release.yml`, which builds, verifies, and publishes to npm. The project's own contributor knowledge base — the in-repo wiki at `wiki/` (278 pages covering agents, skills, rules, and workflows) — is CI-verified on every PR against a source-hash manifest, so wiki pages cannot silently drift from the code they document.
310
323
 
311
324
  ---
312
325
 
package/dist/cli/index.js CHANGED
@@ -217,7 +217,7 @@ var init_package = __esm(() => {
217
217
  workspaces: [
218
218
  "packages/*"
219
219
  ],
220
- version: "1.1.74",
220
+ version: "1.1.75",
221
221
  description: "Batteries-included agent harness for Claude Code",
222
222
  type: "module",
223
223
  bin: {
package/dist/index.js CHANGED
@@ -2326,7 +2326,7 @@ var package_default = {
2326
2326
  workspaces: [
2327
2327
  "packages/*"
2328
2328
  ],
2329
- version: "1.1.74",
2329
+ version: "1.1.75",
2330
2330
  description: "Batteries-included agent harness for Claude Code",
2331
2331
  type: "module",
2332
2332
  bin: {
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "workspaces": [
4
4
  "packages/*"
5
5
  ],
6
- "version": "1.1.74",
6
+ "version": "1.1.75",
7
7
  "description": "Batteries-included agent harness for Claude Code",
8
8
  "type": "module",
9
9
  "bin": {
@@ -32,7 +32,7 @@ Update the relevant rule rather than just acknowledging the violation.
32
32
  |--------------|----------|
33
33
  | 규칙 조항만 추가하고 커밋 → 자동화 경로에 발동 지점이 없어 동일 결함 재발 | 발동 실행 경로 명시 + 반영 확인; 대상 없으면 "배선 불요" 명시 |
34
34
 
35
- **신설 조항의 동일 반복 self-check (Origin: #1691 #4·#5·#7 — v1.1.71)**: 위임서 규율을 신설·보강한 반복에서는, 그 조항을 **같은 반복에서 오케스트레이터가 작성하는 이후 위임서에 즉시 적용**한 뒤 다음 단계로 넘어갑니다. v1.1.69에서 R010 「출처 인용과 인접 문구 점검도 같은 규율」을 신설한 바로 그 반복의 위임서가 이슈 문장을 인용하지 않고 같은 파일 grep을 요구하지 않아 자기 위반 3건(High 1건 포함)이 적대적 리뷰에서 적발되었습니다 — 텍스트가 룰에 실렸다는 사실은 오케스트레이터 자신의 행동이 바뀌었다는 증거가 아닙니다.
35
+ **신설 조항의 동일 반복 self-check (Origin: #1691 #4·#5·#7 — v1.1.71)**: 위임서 규율을 신설·보강한 반복에서는, 그 조항을 **같은 반복에서 오케스트레이터가 작성하는 이후 위임서에 즉시 적용**한 뒤 다음 단계로 넘어갑니다. v1.1.69에서 R010 「출처 인용과 인접 문구 점검도 같은 규율」을 신설한 바로 그 반복의 위임서가 이슈 문장을 인용하지 않고 같은 파일 grep을 요구하지 않아 자기 위반 3건(High 1건 포함)이 적대적 리뷰에서 적발되었습니다 — 텍스트가 룰에 실렸다는 사실은 오케스트레이터 자신의 행동이 바뀌었다는 증거가 아닙니다(배선: auto-dev.yaml implement 스텝 bullet — 신설·보강 조항의 Anti-pattern 표를 위임서와 1:1 대조, 4사본 — v1.1.75).
36
36
 
37
37
  | Anti-pattern | Required |
38
38
  |--------------|----------|
@@ -42,7 +42,7 @@ Origin: #1533 (v1.1.35에서 R017 (b) 조항 추가했으나 auto-dev.yaml versi
42
42
 
43
43
  Cross-reference: R021(Enforcement Policy — advisory 규칙의 발동 지점), R017(구조 검증).
44
44
 
45
- **적용 범위 확장 (Origin: #1698 #1 — v1.1.72)**: 이 self-check는 서브에이전트에 **요구하는** 규율뿐 아니라 오케스트레이터가 **스스로 작성하는 산문(룰 문안·요약·수치)**에도 대칭 적용됩니다. 상세·인용은 R010 「출처 인용과 인접 문구 점검도 같은 규율」 보강 2항목 참조.
45
+ **적용 범위 확장 (Origin: #1698 #1 — v1.1.72)**: 이 self-check는 서브에이전트에 **요구하는** 규율뿐 아니라 오케스트레이터가 **스스로 작성하는 산문(룰 문안·요약·수치)**에도 대칭 적용됩니다. 상세·인용은 R010 「출처 인용과 인접 문구 점검도 같은 규율」 보강 항목 참조.
46
46
 
47
47
  ## Integration
48
48
 
@@ -375,7 +375,7 @@ Origin: #1646 (v1.1.58 세션 — 커밋 위임서 `12e74a76` vs 실제 `e101a0b
375
375
  | 인용 대상 코드를 보지 않고 제안 문안을 룰로 승격 | 인용문이 가리키는 코드·파일과 대조 후 기재 |
376
376
  | 오케스트레이터의 함의를 확정형으로 위임서에 기재 | `[가설 — 실측이 반대면 반대로 기재]` 표기 + 판정 기준 동봉 |
377
377
 
378
- **보강 2항목 (Origin: #1698 #1·#2 — #3은 #1로 흡수 — v1.1.72)**: [#1698 #1] 오케스트레이터는 룰·문서에 커밋될 **최종 문안**을 완성문으로 위임서에 붙여 넣지 않습니다 — 서브에이전트가 이슈 본문에서 사실·수치를 직접 뽑아 작성하고, 오케스트레이터는 제안 포인터·삽입 위치·제약을 지정합니다. 단 인용 원문, 실측 사실(HEAD/브랜치/카운트), 승인·금지 작업 목록, 표준 금지 문구, `[가설]` 표기 함의, 검증 재실행 금지 목록은 계속 오케스트레이터가 기재합니다 — 이들은 "최종 문안"이 아니라 위임 전제입니다(배선: `auto-dev.yaml` implement 스텝 description, 4사본). 원인은 "오케스트레이터가 위임서에 룰 문안 전체를 직접 작성하면서 수치를 기억으로 옮김 — 서브에이전트에는 `gh issue view` 인용을 요구했으나 오케스트레이터 자신의 산문은 같은 규율을 받지 않음"이며, "인용 정확성이 주제인 반복에서 같은 계열 3회째(v1.1.69 세션번호 → v1.1.70 "and marketplace" → v1.1.71 "High 2건")"가 재발 근거입니다. "리뷰에서 오류가 난 문장은 전부 오케스트레이터 작성분이었음"이며, "인용 대조 14건 중 오케스트레이터 작성 수치 1건 외 전부 원문 일치"가 실증됩니다. [#1698 #2] 인접 점검은 "같은 주제 키워드 grep"에만 의존하지 않고, 삽입 지점 앞뒤 섹션(±1 heading)의 Anti-pattern 표를 전수 대조하는 이원화를 적용합니다 — "인접성 점검을 키워드 grep에만 의존"했다가 12줄 아래 조항과의 모순을 놓친 사례가 원인입니다. [#1701 #1] 위임서에 적는 오케스트레이터 자신의 **요구사항 요약**(예: "…만 지정"과 같은 범위 문구)도 최종 문안과 동일하게 취급합니다 — 단 위 예외 목록(승인·금지 작업 목록·표준 금지 문구·실측 사실 등)은 이 취급에서 제외합니다. 원인은 "위임서가 이슈 원문 대신 오케스트레이터가 요약한 요구 문구("…만")를 전달 — 룰 문안은 서브에이전트가 썼지만 범위 규정은 오케스트레이터 산문이었음"이며, 이슈 제안 문장을 `gh issue view` 출력에서 복사해 전달하고 오케스트레이터의 범위 요약에는 `[요약 — 원문 우선]`을 표기합니다(배선: auto-dev.yaml implement 스텝 bullet 확장, 4사본 — R016 Rule Wiring Check). [#1704 #1] 위임서에 적는 오케스트레이터 자신의 **배선 판정**(예: "기존 implement 스텝 bullet이 커버" 류)도 같은 취급을 받습니다 — 위임서는 배선 대상 후보 파일·앵커만 제시하고, 커버 여부는 서브에이전트가 해당 문장을 인용해 판정합니다. 원인은 "배선 대상을 grep 실측 없이 오케스트레이터가 요약해 확정형으로 기재 — Iteration 1 찐빠 #1("…만 지정" 요약)과 같은 클래스의 재발(요약이 룰 문안 대신 배선 판정으로 자리만 옮김)"입니다(배선: auto-dev.yaml implement 스텝 bullet 확장, 4사본 — 기존 bullet은 `constraints`를 오케스트레이터 제공 항목으로 **허용**하므로 이 조항을 커버하지 않습니다).
378
+ **보강 항목 (Origin: #1698 #1·#2(#3은 #1로 흡수), #1701 #1, #1704 #1, #1707 #2 — v1.1.72~75)**: [#1698 #1] 오케스트레이터는 룰·문서에 커밋될 **최종 문안**을 완성문으로 위임서에 붙여 넣지 않습니다 — 서브에이전트가 이슈 본문에서 사실·수치를 직접 뽑아 작성하고, 오케스트레이터는 제안 포인터·삽입 위치·제약을 지정합니다. 단 인용 원문, 실측 사실(HEAD/브랜치/카운트), 승인·금지 작업 목록, 표준 금지 문구, `[가설]` 표기 함의, 검증 재실행 금지 목록은 계속 오케스트레이터가 기재합니다 — 이들은 "최종 문안"이 아니라 위임 전제입니다(배선: `auto-dev.yaml` implement 스텝 description, 4사본). 원인은 "오케스트레이터가 위임서에 룰 문안 전체를 직접 작성하면서 수치를 기억으로 옮김 — 서브에이전트에는 `gh issue view` 인용을 요구했으나 오케스트레이터 자신의 산문은 같은 규율을 받지 않음"이며, "인용 정확성이 주제인 반복에서 같은 계열 3회째(v1.1.69 세션번호 → v1.1.70 "and marketplace" → v1.1.71 "High 2건")"가 재발 근거입니다. "리뷰에서 오류가 난 문장은 전부 오케스트레이터 작성분이었음"이며, "인용 대조 14건 중 오케스트레이터 작성 수치 1건 외 전부 원문 일치"가 실증됩니다. [#1698 #2] 인접 점검은 "같은 주제 키워드 grep"에만 의존하지 않고, 삽입 지점 앞뒤 섹션(±1 heading)의 Anti-pattern 표를 전수 대조하는 이원화를 적용합니다 — "인접성 점검을 키워드 grep에만 의존"했다가 12줄 아래 조항과의 모순을 놓친 사례가 원인입니다. [#1707 #2] 이 ±1 heading 대조는 인접 섹션과의 모순 여부뿐 아니라, 그 섹션 안의 상대 위치 참조(위 표·아래 표·직전 조항 등)가 삽입 후에도 원래 의도한 대상에 여전히 재바인딩되는지도 함께 확인합니다 — 원인은 "서브에이전트의 ±1 heading 점검이 "모순 여부"에만 초점, 상대 참조("위/아래 표")의 재바인딩은 점검 항목에 없음"입니다(배선: auto-dev.yaml implement 스텝 표준 제약 블록, 형제 위임이 같은 릴리즈에서 추가). [#1701 #1] 위임서에 적는 오케스트레이터 자신의 **요구사항 요약**(예: "…만 지정"과 같은 범위 문구)도 최종 문안과 동일하게 취급합니다 — 단 위 예외 목록(승인·금지 작업 목록·표준 금지 문구·실측 사실 등)은 이 취급에서 제외합니다. 원인은 "위임서가 이슈 원문 대신 오케스트레이터가 요약한 요구 문구("…만")를 전달 — 룰 문안은 서브에이전트가 썼지만 범위 규정은 오케스트레이터 산문이었음"이며, 이슈 제안 문장을 `gh issue view` 출력에서 복사해 전달하고 오케스트레이터의 범위 요약에는 `[요약 — 원문 우선]`을 표기합니다(배선: auto-dev.yaml implement 스텝 bullet 확장, 4사본 — R016 Rule Wiring Check). [#1704 #1] 위임서에 적는 오케스트레이터 자신의 **배선 판정**(예: "기존 implement 스텝 bullet이 커버" 류)도 같은 취급을 받습니다 — 위임서는 배선 대상 후보 파일·앵커만 제시하고, 커버 여부는 서브에이전트가 해당 문장을 인용해 판정합니다. 원인은 "배선 대상을 grep 실측 없이 오케스트레이터가 요약해 확정형으로 기재 — Iteration 1 찐빠 #1("…만 지정" 요약)과 같은 클래스의 재발(요약이 룰 문안 대신 배선 판정으로 자리만 옮김)"입니다(배선: auto-dev.yaml implement 스텝 bullet 확장, 4사본 — 기존 bullet은 `constraints`를 오케스트레이터 제공 항목으로 **허용**하므로 이 조항을 커버하지 않습니다).
379
379
 
380
380
  > **#1700 판정 (v1.1.72)**: 이 인용의 "v1.1.69 세션번호"는 발생 시점이 아니라 조항 작성 시점으로 보입니다 — 오류 발생·적발은 Iteration 4/v1.1.67(#1688 찐빠 #1), 조항 초안은 커밋 448143c7(PR #1690 = release/v1.1.69) 실측입니다.
381
381
 
@@ -384,6 +384,7 @@ Origin: #1646 (v1.1.58 세션 — 커밋 위임서 `12e74a76` vs 실제 `e101a0b
384
384
  | 룰 문안 **최종 문안**을 오케스트레이터가 직접 작성해 위임서에 기재 | 서브에이전트가 이슈 본문에서 사실·수치를 직접 뽑아 작성; 오케스트레이터는 포인터·삽입 위치·제약만 지정 — 인용 원문·실측 사실·승인/금지 목록·표준 금지 문구·`[가설]` 표기·재실행 금지 목록은 오케스트레이터가 계속 기재 |
385
385
  | 위임서의 "요구사항 요약"을 오케스트레이터가 산문으로 재구성해 확정형으로 기재 (예: "…만 지정") | 이슈 제안 문장을 `gh issue view` 출력에서 복사해 전달; 오케스트레이터의 범위 요약에는 `[요약 — 원문 우선]` 표기 |
386
386
  | 같은 주제 키워드 grep만으로 인접성 점검 완료 판정 | 키워드 grep + 삽입 지점 ±1 heading의 Anti-pattern 표 전수 대조를 병행 |
387
+ | ±1 heading 대조를 모순 여부에만 국한 → 인접 문구의 "위 표"·"아래 표"·"직전 조항" 참조가 삽입 후 다른 대상으로 재바인딩된 것을 놓침 | ±1 heading 대조에 상대 위치 참조 재바인딩 확인을 포함 |
387
388
  | 위임서에 오케스트레이터의 배선 판정("기존 bullet이 커버")을 확정형으로 기재 | 배선 대상 후보 파일·앵커만 제시하고 커버 여부는 서브에이전트가 해당 문장을 인용해 판정 |
388
389
 
389
390
  #### 참인 전제 ≠ 참인 함의 — 브랜치 전환 위임 (Origin: #1595 #2)
@@ -134,7 +134,9 @@ Origin: #1595 #5 (v1.1.48 세션 — R008 위반 3건이 단일 턴에 집중. t
134
134
  | 도구 호출 턴을 짧은 요약 산문만으로 시작(narration 채널로 흐름) | 헤더(`┌─ Agent:` 또는 단축 헤더)와 Core Rule 접두사를 **text 블록**으로 명시 — 산문 요약은 그 뒤에 |
135
135
  | "announce를 썼다"는 기억으로 advisory를 오탐으로 가정 | 트랜스크립트의 `text` 블록에서 마커를 실측(R020 Self-Violation Counting) |
136
136
 
137
- Iteration 1(Agent 스폰 15메시지 전부 narration)과 Iteration 2(7메시지 text)의 대비는 계수 도구 결함이 아니라 출력 채널 선택의 차이였다. 채널 선택 요인은 미귀속이다.
137
+ Iteration 1(Agent 스폰 15메시지 전부 narration)과 Iteration 2(7메시지 text)의 대비는 계수 도구 결함이 아니라 출력 채널 선택의 차이로 서술했으나, 이 귀속은 아래 v1.1.75 보강으로 대체되었다.
138
+
139
+ **원인 귀속 보강 (Origin: #1703·#1706 — v1.1.75)**: 실 세션 6건·tool_use 응답 1008건(아티팩트 Part B 표 5건 860건 + 각주 인용 2.1.251 세션 148건, 재계산)을 재측정한 결과, text 블록이 없는 tool_use 응답의 비율이 CC 2.1.233에서 0%(0/256)였다가 2.1.251에서 39.2%(58/148)로 급증하고 2.1.258~2.1.275 구간에서 53.6~61.8%로 유지되는 것을 확인했습니다. 이 경계는 CHANGELOG v2.1.251의 "Fixed conversations getting stuck on \"text content blocks must be non-empty\" errors after a turn where the model produced only thinking" 항목과 일치합니다. narration 채널 옵션은 thinking 본문 354건 전수에서 마커가 0건 매칭되어 은퇴했으므로(#1703), R008 누락 턴은 마커가 narration으로 옮겨간 것이 아니라 thinking과 tool_use만 있고 text 블록이 없는 형태로 기록된 것입니다. `[가설]` 2.1.251 이전의 thinking-only 턴이 클라이언트 측 text 강제 주입으로 감춰졌는지 API 재시도로 트랜스크립트에서 탈락했는지, 그리고 thinking 내용이 announce 정규식과 왜 불일치하는지는 API 원본 스트리밍 로그 대조 없이는 미확정입니다.
138
140
 
139
141
  ## Tier-3 Interaction Tool Prefix (MANDATORY)
140
142
 
@@ -111,6 +111,14 @@ staleness/audit 검증은 model ID·placeholder·TBD뿐 아니라 **폐기된
111
111
 
112
112
  Origin: #1455 #1 (Session 127 회고 찐빠 #1) — cc-release-monitor PR #1449 머지 후 workflow_dispatch 실검증에서 issue_body의 `<details>`·릴리즈 요약에 12칸 리터럴 들여쓰기 발견 → PR #1451 재작업. 첫 위임이 문법 검증만 지시하고 샘플 값 출력 조립 검증을 누락. `textwrap.dedent` + 멀티라인 변수 함정이 문법 검증만으로는 미노출. R020(문법 통과 ≠ 출력 정상)과 정합.
113
113
 
114
+ **리서치 위임의 결론 수치는 표에서 재계산해 병기 (Origin: #1707 #4 — v1.1.75)**: 리서치·계측 위임의 완료 조건에는 결론 문장에 등장하는 모든 수치를 산출물 자체의 표에서 jq/awk 등으로 재계산하고, 그 값을 결론 옆에 병기하도록 명시합니다. 원인은 "리서치 에이전트가 표를 먼저 쓰고 결론을 별도 산술로 작성(표에서 재계산하지 않음)"이며, 결론 문장의 합계(697)가 표(354)와 불일치한 산술 모순 사례가 실증입니다.
115
+
116
+ | Anti-pattern | Required |
117
+ |--------------|----------|
118
+ | 결론 문장의 수치를 표와 별도로 산술해 기재 | 결론 수치를 표에서 jq/awk로 재계산하고 결론 옆에 병기하도록 완료 조건에 명시 |
119
+
120
+ 배선: auto-dev.yaml deep-plan 스텝 description (4사본) — 「Delegated Verification Floor」 상한선 조항과 같은 방식입니다.
121
+
114
122
  ## Delegated Verification Floor — CI 잡 목록에서 도출 (Origin: #1574)
115
123
 
116
124
  위임 프롬프트의 검증 항목은 "변경 파일의 영향 범위"만으로 정하면 부족하다. **하한선은 CI가 실제로 돌리는 잡 전체**다 — 워크플로 YAML의 잡 목록을 읽어 대응하는 로컬 명령(`lint` / `test` / `validate-docs` / sync 검사)을 열거하고, 그중 로컬 실행 가능한 것을 위임 완료 조건에 포함한다. 로컬에서 통과시키지 않은 CI 잡은 병합 시점에 halt로 돌아와 수정 에이전트 추가 발주를 강제한다.
@@ -348,7 +348,7 @@ steps:
348
348
 
349
349
  - name: deep-plan
350
350
  skill: deep-plan
351
- description: "Research-validated implementation plan (research → plan → verify) — skipped if docs-only, integrated-analysis allowed if lite. MULTI-PHASE: 스킬을 그대로 spawn하지 말고 R020 「위임 경계를 Phase 개수로 설계」에 따라 단일 목표 위임으로 분할해 순차 발주한다 (#1595 #4)."
351
+ description: "Research-validated implementation plan (research → plan → verify) — skipped if docs-only, integrated-analysis allowed if lite. MULTI-PHASE: 스킬을 그대로 spawn하지 말고 R020 「위임 경계를 Phase 개수로 설계」에 따라 단일 목표 위임으로 분할해 순차 발주한다 (#1595 #4). 리서치·계측 위임의 완료 조건에는 결론 수치를 산출물 표에서 jq/awk로 재계산해 병기하도록 명시한다(#1707 #4)."
352
352
  depends_on: plan
353
353
 
354
354
  - name: implement
@@ -389,6 +389,15 @@ steps:
389
389
  (#1701 #1). The orchestrator's own wiring judgement (which file/anchor already covers a
390
390
  new clause) counts as final wording too — the prompt supplies candidate files/anchors
391
391
  only, and the subagent decides coverage by quoting the covering sentence (R010 [#1704 #1]).
392
+ - Before dispatching any delegation prompt in an iteration that created or reinforced a rule
393
+ clause, the orchestrator MUST compare that clause's Anti-pattern table rows 1:1 against the
394
+ delegation prompt's sentences and rewrite any match (cause: the R016 「신설 조항의 동일
395
+ 반복 self-check」 was known as text but not executed as a procedure, #1707 #1).
396
+ - Every rule/skill/guide TEXT-editing delegation prompt MUST include this fixed constraint
397
+ block: (a) Korean 합쇼체 for new sentences, do not imitate adjacent 반말; (b) locate by anchor
398
+ strings, never line numbers; (c) copy quotations from `gh issue view --json body` output and
399
+ verify with `grep -F`; (d) ±1 heading check including re-binding of relative references (위
400
+ 표/아래 표/직전 조항); (e) copy to `templates/` mirror and confirm `md5 -q` equality (#1707 #3).
392
401
 
393
402
 
394
403
  ## Sensitive Path Handling (CC v2.1.121+)
@@ -47,7 +47,7 @@ NO EXCEPTIONS. NO EXCUSES.
47
47
  |------|------|-------------|
48
48
  | R007 Agent ID | Every response starts with `┌─ Agent:` header | Add header immediately |
49
49
  | R008 Tool ID | Every tool call prefixed with `[agent][model] → Tool:` | Add prefix immediately |
50
- | R009 Parallel | 2+ independent tasks → parallel agents (max 4) | Stop sequential, switch to parallel |
50
+ | R009 Parallel | 2+ independent tasks → parallel agents (soft default 4, max 5) | Stop sequential, switch to parallel |
51
51
  | R010 Orchestrator | Orchestrator never modifies files → delegate to subagents | Stop direct modification, delegate |
52
52
 
53
53
  ---
@@ -174,6 +174,7 @@ This is the core oh-my-customcode philosophy: **"No expert? CREATE one, connect
174
174
  | QA Team | 3 | qa-planner, qa-writer, qa-engineer |
175
175
  | Manager | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible |
176
176
  | System | 4 | sys-memory-keeper, sys-naggy, tracker-checkpoint, wiki-curator |
177
+ | Agora | 1 | agora-runner |
177
178
  | **Total** | **50** | |
178
179
 
179
180
  ## Agent Teams (MUST when enabled)
@@ -47,7 +47,7 @@ oh-my-customcode로 구동됩니다.
47
47
  |------|------|--------|
48
48
  | R007 에이전트 식별 | 모든 응답은 `┌─ Agent:` 헤더로 시작 | 즉시 헤더 추가 |
49
49
  | R008 도구 식별 | 모든 도구 호출에 `[에이전트명][모델] → Tool:` 접두사 | 즉시 접두사 추가 |
50
- | R009 병렬 실행 | 독립 작업 2개 이상 → 병렬 에이전트 (최대 4개) | 순차 실행 중단, 병렬로 전환 |
50
+ | R009 병렬 실행 | 독립 작업 2개 이상 → 병렬 에이전트 (권장 4, 최대 5) | 순차 실행 중단, 병렬로 전환 |
51
51
  | R010 오케스트레이터 | 오케스트레이터는 파일 수정 금지 → 서브에이전트에 위임 | 직접 수정 중단, 위임 |
52
52
 
53
53
  ---
@@ -174,6 +174,7 @@ project/
174
174
  | QA Team | 3 | qa-planner, qa-writer, qa-engineer |
175
175
  | Manager | 6 | mgr-creator, mgr-updater, mgr-supplier, mgr-gitnerd, mgr-sauron, mgr-claude-code-bible |
176
176
  | System | 4 | sys-memory-keeper, sys-naggy, tracker-checkpoint, wiki-curator |
177
+ | Agora | 1 | agora-runner |
177
178
  | **총계** | **50** | |
178
179
 
179
180
  ## Agent Teams (MUST when enabled)
@@ -80,11 +80,12 @@ CI의 `verify-template-sync.sh`가 소스와 templates/ 간 일치를 검증합
80
80
  | DE Engineer | 6 |
81
81
  | SW Engineer / Database | 4 |
82
82
  | Security | 1 |
83
- | SW Architect | 3 |
83
+ | SW Architect | 2 |
84
84
  | Infra Engineer | 2 |
85
85
  | QA Team | 3 |
86
86
  | Manager | 6 |
87
87
  | System | 4 |
88
+ | Agora | 1 |
88
89
 
89
90
  ### Skills (115)
90
91
 
@@ -115,7 +116,7 @@ CI의 `verify-template-sync.sh`가 소스와 templates/ 간 일치를 검증합
115
116
 
116
117
  각 디렉토리는 단일 토픽에 대한 best practices, 튜토리얼, 또는 설계 가이드를 담습니다. 에이전트가 작업 중 참조합니다 (R006 관심사 분리).
117
118
 
118
- ### Hooks (35)
119
+ ### Hooks (42)
119
120
 
120
121
  `.claude/hooks/scripts/*.sh` — 라이프사이클 훅 스크립트.
121
122
 
@@ -1,5 +1,5 @@
1
1
  {
2
- "version": "1.1.74",
2
+ "version": "1.1.75",
3
3
  "lastUpdated": "2026-09-03",
4
4
  "omcustomMinClaudeCode": "2.1.121",
5
5
  "omcustomMinClaudeCodeReason": "Sensitive-path direct Write/Edit on .claude/** under bypassPermissions (R010 deprecation, #1101)",
@@ -348,7 +348,7 @@ steps:
348
348
 
349
349
  - name: deep-plan
350
350
  skill: deep-plan
351
- description: "Research-validated implementation plan (research → plan → verify) — skipped if docs-only, integrated-analysis allowed if lite. MULTI-PHASE: 스킬을 그대로 spawn하지 말고 R020 「위임 경계를 Phase 개수로 설계」에 따라 단일 목표 위임으로 분할해 순차 발주한다 (#1595 #4)."
351
+ description: "Research-validated implementation plan (research → plan → verify) — skipped if docs-only, integrated-analysis allowed if lite. MULTI-PHASE: 스킬을 그대로 spawn하지 말고 R020 「위임 경계를 Phase 개수로 설계」에 따라 단일 목표 위임으로 분할해 순차 발주한다 (#1595 #4). 리서치·계측 위임의 완료 조건에는 결론 수치를 산출물 표에서 jq/awk로 재계산해 병기하도록 명시한다(#1707 #4)."
352
352
  depends_on: plan
353
353
 
354
354
  - name: implement
@@ -389,6 +389,15 @@ steps:
389
389
  (#1701 #1). The orchestrator's own wiring judgement (which file/anchor already covers a
390
390
  new clause) counts as final wording too — the prompt supplies candidate files/anchors
391
391
  only, and the subagent decides coverage by quoting the covering sentence (R010 [#1704 #1]).
392
+ - Before dispatching any delegation prompt in an iteration that created or reinforced a rule
393
+ clause, the orchestrator MUST compare that clause's Anti-pattern table rows 1:1 against the
394
+ delegation prompt's sentences and rewrite any match (cause: the R016 「신설 조항의 동일
395
+ 반복 self-check」 was known as text but not executed as a procedure, #1707 #1).
396
+ - Every rule/skill/guide TEXT-editing delegation prompt MUST include this fixed constraint
397
+ block: (a) Korean 합쇼체 for new sentences, do not imitate adjacent 반말; (b) locate by anchor
398
+ strings, never line numbers; (c) copy quotations from `gh issue view --json body` output and
399
+ verify with `grep -F`; (d) ±1 heading check including re-binding of relative references (위
400
+ 표/아래 표/직전 조항); (e) copy to `templates/` mirror and confirm `md5 -q` equality (#1707 #3).
392
401
 
393
402
 
394
403
  ## Sensitive Path Handling (CC v2.1.121+)