patina-cli 3.11.0

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.
Files changed (180) hide show
  1. package/.patina.default.yaml +211 -0
  2. package/CHANGELOG.md +265 -0
  3. package/LICENSE +21 -0
  4. package/README.md +319 -0
  5. package/README_JA.md +254 -0
  6. package/README_KR.md +253 -0
  7. package/README_ZH.md +254 -0
  8. package/SKILL-MAX.md +455 -0
  9. package/SKILL.md +730 -0
  10. package/assets/brand/patina-icon.svg +9 -0
  11. package/assets/brand/patina-logo.svg +17 -0
  12. package/assets/social/patina-before-after.svg +46 -0
  13. package/assets/social/patina-og.svg +31 -0
  14. package/bin/patina.js +9 -0
  15. package/core/scoring.md +657 -0
  16. package/core/standalone-prompt.md +364 -0
  17. package/core/stylometry.md +754 -0
  18. package/core/voice.md +163 -0
  19. package/docs/AUTHENTICATION.md +105 -0
  20. package/docs/AUTHENTICATION_KR.md +105 -0
  21. package/docs/BRANDING.md +37 -0
  22. package/docs/CLI.md +80 -0
  23. package/docs/COMPARISON.md +38 -0
  24. package/docs/COOKBOOK.md +173 -0
  25. package/docs/DEMO.md +40 -0
  26. package/docs/ETHICS.md +27 -0
  27. package/docs/EXAMPLES.md +130 -0
  28. package/docs/EXAMPLES_KR.md +130 -0
  29. package/docs/EXIT-CODES.md +25 -0
  30. package/docs/FAQ.md +67 -0
  31. package/docs/FAQ_KR.md +65 -0
  32. package/docs/FLAG-PARITY.md +53 -0
  33. package/docs/GLOSSARY.md +123 -0
  34. package/docs/PATTERNS-EN.md +718 -0
  35. package/docs/PATTERNS-JA.md +706 -0
  36. package/docs/PATTERNS-KO.md +707 -0
  37. package/docs/PATTERNS-ZH.md +706 -0
  38. package/docs/PATTERNS.md +22 -0
  39. package/docs/ROADMAP.md +315 -0
  40. package/docs/audits/2026-05-deep-research.md +290 -0
  41. package/docs/benchmarks/detector-comparison.json +442 -0
  42. package/docs/benchmarks/detector-comparison.md +65 -0
  43. package/docs/benchmarks/latest.json +988 -0
  44. package/docs/benchmarks/latest.md +112 -0
  45. package/docs/integrations/docker.md +19 -0
  46. package/docs/integrations/github-action.md +59 -0
  47. package/docs/integrations/pre-commit.md +77 -0
  48. package/docs/integrations/release.md +43 -0
  49. package/docs/internal/HARNESS.md +14 -0
  50. package/docs/internal/README.md +14 -0
  51. package/docs/internal/WARP.md +23 -0
  52. package/docs/research/2025-rebaseline-plan.md +89 -0
  53. package/docs/research/ai-human-metrics.md +380 -0
  54. package/docs/social/gstack-cardnews.html +236 -0
  55. package/docs/social/gstack-cardnews.md +88 -0
  56. package/docs/social/gstack-thread.md +106 -0
  57. package/docs/social/patina-launch-copy.md +227 -0
  58. package/docs/superpowers/specs/2026-04-03-meaning-preservation-design.md +299 -0
  59. package/lexicon/ai-en.md +162 -0
  60. package/lexicon/ai-ko.md +159 -0
  61. package/package.json +100 -0
  62. package/patina-max/SKILL.md +523 -0
  63. package/patina-max/composite.py +457 -0
  64. package/patterns/en-communication.md +89 -0
  65. package/patterns/en-content.md +133 -0
  66. package/patterns/en-filler.md +113 -0
  67. package/patterns/en-language.md +163 -0
  68. package/patterns/en-structure.md +173 -0
  69. package/patterns/en-style.md +139 -0
  70. package/patterns/en-viral-hook.md +211 -0
  71. package/patterns/ja-communication.md +101 -0
  72. package/patterns/ja-content.md +153 -0
  73. package/patterns/ja-filler.md +123 -0
  74. package/patterns/ja-language.md +190 -0
  75. package/patterns/ja-structure.md +142 -0
  76. package/patterns/ja-style.md +147 -0
  77. package/patterns/ja-viral-hook.md +216 -0
  78. package/patterns/ko-communication.md +98 -0
  79. package/patterns/ko-content.md +154 -0
  80. package/patterns/ko-filler.md +105 -0
  81. package/patterns/ko-language.md +182 -0
  82. package/patterns/ko-structure.md +147 -0
  83. package/patterns/ko-style.md +146 -0
  84. package/patterns/ko-viral-hook.md +211 -0
  85. package/patterns/zh-communication.md +101 -0
  86. package/patterns/zh-content.md +153 -0
  87. package/patterns/zh-filler.md +118 -0
  88. package/patterns/zh-language.md +173 -0
  89. package/patterns/zh-structure.md +145 -0
  90. package/patterns/zh-style.md +159 -0
  91. package/patterns/zh-viral-hook.md +216 -0
  92. package/profiles/academic.md +53 -0
  93. package/profiles/blog.md +81 -0
  94. package/profiles/casual-conversation.md +105 -0
  95. package/profiles/code-comment.md +104 -0
  96. package/profiles/commit-message.md +99 -0
  97. package/profiles/default.md +62 -0
  98. package/profiles/email.md +52 -0
  99. package/profiles/formal.md +98 -0
  100. package/profiles/instructional.md +80 -0
  101. package/profiles/legal.md +57 -0
  102. package/profiles/marketing.md +56 -0
  103. package/profiles/medical.md +53 -0
  104. package/profiles/narrative.md +79 -0
  105. package/profiles/release-notes.md +98 -0
  106. package/profiles/social.md +56 -0
  107. package/profiles/technical.md +53 -0
  108. package/scripts/benchmark-report.mjs +252 -0
  109. package/scripts/check-release-metadata.mjs +48 -0
  110. package/scripts/detector-comparison.mjs +267 -0
  111. package/scripts/lint.mjs +40 -0
  112. package/scripts/precommit-score.mjs +31 -0
  113. package/scripts/prose-score.mjs +186 -0
  114. package/scripts/update-benchmark-ranges.mjs +108 -0
  115. package/src/api.js +330 -0
  116. package/src/auth.js +105 -0
  117. package/src/backends/claude-cli.js +112 -0
  118. package/src/backends/codex-cli.js +121 -0
  119. package/src/backends/contract.js +21 -0
  120. package/src/backends/gemini-cli.js +135 -0
  121. package/src/backends/index.js +159 -0
  122. package/src/cache.js +106 -0
  123. package/src/cli.js +1280 -0
  124. package/src/commands/doctor.js +229 -0
  125. package/src/commands/init.js +208 -0
  126. package/src/config.js +126 -0
  127. package/src/errors.js +53 -0
  128. package/src/features/index.js +96 -0
  129. package/src/features/lexicon.js +90 -0
  130. package/src/features/segment.js +49 -0
  131. package/src/features/stylometry.js +50 -0
  132. package/src/loader.js +103 -0
  133. package/src/logger.js +70 -0
  134. package/src/manifest.js +162 -0
  135. package/src/max-mode.js +207 -0
  136. package/src/ouroboros.js +233 -0
  137. package/src/output.js +480 -0
  138. package/src/prompt-builder.js +409 -0
  139. package/src/providers.js +100 -0
  140. package/src/scoring.js +531 -0
  141. package/src/security.js +133 -0
  142. package/tests/fixtures/suspect-zones/en/ai/en-ai-01.md +16 -0
  143. package/tests/fixtures/suspect-zones/en/ai/en-ai-02.md +16 -0
  144. package/tests/fixtures/suspect-zones/en/ai/en-ai-03.md +17 -0
  145. package/tests/fixtures/suspect-zones/en/ai/en-ai-04.md +15 -0
  146. package/tests/fixtures/suspect-zones/en/ai/en-ai-05.md +16 -0
  147. package/tests/fixtures/suspect-zones/en/ai/en-ai-06-chat-register.md +16 -0
  148. package/tests/fixtures/suspect-zones/en/natural/en-nat-01.md +15 -0
  149. package/tests/fixtures/suspect-zones/en/natural/en-nat-02.md +15 -0
  150. package/tests/fixtures/suspect-zones/en/natural/en-nat-03.md +15 -0
  151. package/tests/fixtures/suspect-zones/en/natural/en-nat-04.md +15 -0
  152. package/tests/fixtures/suspect-zones/en/natural/en-nat-05.md +15 -0
  153. package/tests/fixtures/suspect-zones/expected-ranges.json +939 -0
  154. package/tests/fixtures/suspect-zones/ja/ai/ja-ai-01.md +11 -0
  155. package/tests/fixtures/suspect-zones/ja/ai/ja-ai-02.md +11 -0
  156. package/tests/fixtures/suspect-zones/ja/ai/ja-ai-03.md +11 -0
  157. package/tests/fixtures/suspect-zones/ja/natural/ja-nat-01.md +11 -0
  158. package/tests/fixtures/suspect-zones/ja/natural/ja-nat-02.md +11 -0
  159. package/tests/fixtures/suspect-zones/ja/natural/ja-nat-03.md +11 -0
  160. package/tests/fixtures/suspect-zones/ko/ai/ko-ai-01.md +14 -0
  161. package/tests/fixtures/suspect-zones/ko/ai/ko-ai-02.md +16 -0
  162. package/tests/fixtures/suspect-zones/ko/ai/ko-ai-03.md +15 -0
  163. package/tests/fixtures/suspect-zones/ko/ai/ko-ai-04.md +15 -0
  164. package/tests/fixtures/suspect-zones/ko/ai/ko-ai-05.md +16 -0
  165. package/tests/fixtures/suspect-zones/ko/ai/ko-ai-06-chat-register.md +16 -0
  166. package/tests/fixtures/suspect-zones/ko/natural/ko-nat-01.md +15 -0
  167. package/tests/fixtures/suspect-zones/ko/natural/ko-nat-02.md +15 -0
  168. package/tests/fixtures/suspect-zones/ko/natural/ko-nat-03.md +15 -0
  169. package/tests/fixtures/suspect-zones/ko/natural/ko-nat-04.md +14 -0
  170. package/tests/fixtures/suspect-zones/ko/natural/ko-nat-05.md +15 -0
  171. package/tests/fixtures/suspect-zones/zh/ai/zh-ai-01.md +11 -0
  172. package/tests/fixtures/suspect-zones/zh/ai/zh-ai-02.md +11 -0
  173. package/tests/fixtures/suspect-zones/zh/ai/zh-ai-03.md +11 -0
  174. package/tests/fixtures/suspect-zones/zh/natural/zh-nat-01.md +11 -0
  175. package/tests/fixtures/suspect-zones/zh/natural/zh-nat-02.md +11 -0
  176. package/tests/fixtures/suspect-zones/zh/natural/zh-nat-03.md +11 -0
  177. package/tests/quality/README.md +121 -0
  178. package/tests/quality/benchmark.mjs +306 -0
  179. package/tests/quality/detectors.manual.example.json +31 -0
  180. package/tests/quality/dogfood.mjs +44 -0
package/SKILL-MAX.md ADDED
@@ -0,0 +1,455 @@
1
+ ---
2
+ name: patina-max
3
+ version: 3.11.0
4
+ description: |
5
+ Multi-model humanization. Runs the same humanization task on multiple
6
+ local model CLIs, scores each result, and selects the best
7
+ output by lowest AI score among candidates that pass the MPS
8
+ meaning-preservation floor. Uses `claude -p` / `gemini -p` for
9
+ Claude/Gemini and `codex exec` for Codex.
10
+ allowed-tools:
11
+ - Read
12
+ - Write
13
+ - Edit
14
+ - Grep
15
+ - Glob
16
+ - Bash
17
+ - AskUserQuestion
18
+ ---
19
+
20
+ # patina MAX: ๋ฉ€ํ‹ฐ๋ชจ๋ธ Best-of-N Rewriter
21
+
22
+ ๋‹น์‹ ์€ ์—ฌ๋Ÿฌ AI ๋ชจ๋ธ์„ ๋™์‹œ์— ์‚ฌ์šฉํ•˜์—ฌ ํ…์ŠคํŠธ๋ฅผ humanizeํ•˜๊ณ , ๊ฐ€์žฅ ์ž์—ฐ์Šค๋Ÿฌ์šด ๊ฒฐ๊ณผ๋ฅผ ์ž๋™ ์„ ํƒํ•˜๋Š” ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ดํ„ฐ์ž…๋‹ˆ๋‹ค. ๊ฐ ๋ชจ๋ธ์ด ๊ฐ™์€ ํ…์ŠคํŠธ๋ฅผ humanizeํ•œ ๋’ค, ์˜๋ฏธ ๋ณด์กด ๊ธฐ์ค€(MPS โ‰ฅ 70)์„ ํ†ต๊ณผํ•œ ๊ฒฐ๊ณผ ์ค‘ AI ์œ ์‚ฌ๋„ ์ ์ˆ˜๊ฐ€ ๊ฐ€์žฅ ๋‚ฎ์€ ๊ฒƒ์„ ์ตœ์ข…๋ณธ์œผ๋กœ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
23
+
24
+ > **์ „์ œ ์กฐ๊ฑด:**
25
+ > - **oh-my-claudecode (OMC)** ๊ฐ€ ์„ค์น˜๋˜์–ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค (`dispatch: omc` ๋ณ‘๋ ฌ ๋ชจ๋“œ)
26
+ > - **tmux** ์„ธ์…˜ ์•ˆ์—์„œ ์‹คํ–‰ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค (`dispatch: omc` ๋ณ‘๋ ฌ ๋ชจ๋“œ, `$TMUX` ํ™˜๊ฒฝ๋ณ€์ˆ˜ ํ™•์ธ)
27
+ > - ์„ ํƒํ•œ ๋ชจ๋ธ์˜ ๋กœ์ปฌ CLI๊ฐ€ ์„ค์น˜๋˜์–ด ์žˆ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค (`claude`, `gemini`, `codex`)
28
+ > - `dispatch: direct` ๋ชจ๋“œ์—์„œ๋Š” OMC/tmux ์—†์ด๋„ ๋™์ž‘ํ•ฉ๋‹ˆ๋‹ค (์ˆœ์ฐจ ์‹คํ–‰, tmux fallback ๊ฒฝ๊ณ  ์—†์Œ)
29
+
30
+ ---
31
+
32
+ ## 1๋‹จ๊ณ„: ์„ค์ • ๋กœ๋“œ
33
+
34
+ `.patina.default.yaml`์„ ์ฝ์–ด ์„ค์ •์„ ๋กœ๋“œํ•œ๋‹ค.
35
+
36
+ ```
37
+ Glob .patina.default.yaml โ†’ Read
38
+ ```
39
+
40
+ ์„ค์ •์—์„œ ๋‹ค์Œ์„ ํ™•์ธ:
41
+ - `profile`: ์‚ฌ์šฉํ•  ํ”„๋กœํ•„ (๊ธฐ๋ณธ: `default`)
42
+ - `patterns`: ๋กœ๋“œํ•  ํŒจํ„ด ํŒฉ ๋ชฉ๋ก
43
+ - `skip-patterns`: ๊ฑด๋„ˆ๋›ธ ํŒจํ„ด ํŒฉ
44
+ - `blocklist`: ์ถ”๊ฐ€ ๊ฐ์ง€ ์–ดํœ˜
45
+ - `allowlist`: ๊ฐ์ง€ ์ œ์™ธ ์–ดํœ˜
46
+ - `max-models`: MAX ๋ชจ๋“œ์—์„œ ์‚ฌ์šฉํ•  ๋ชจ๋ธ ๋ชฉ๋ก (๊ธฐ๋ณธ: `[claude, gemini]`)
47
+ - `dispatch`: ๋””์ŠคํŒจ์น˜ ๋ชจ๋“œ (`omc` ๋˜๋Š” `direct`, ๊ธฐ๋ณธ: `omc`)
48
+
49
+ `$ARGUMENTS`์—์„œ ์˜ต์…˜์„ ํŒŒ์‹ฑํ•˜์—ฌ ์„ค์ •์„ ์˜ค๋ฒ„๋ผ์ด๋“œ:
50
+ - `--profile <name>`: ํ”„๋กœํ•„ ๋ณ€๊ฒฝ
51
+ - `--lang <code>`: ์ฒ˜๋ฆฌ ์–ธ์–ด ๋ณ€๊ฒฝ (ko, en, zh, ja)
52
+ - `--models <list>`: ์‚ฌ์šฉํ•  ๋ชจ๋ธ ๋ณ€๊ฒฝ (์‰ผํ‘œ ๊ตฌ๋ถ„, ์˜ˆ: `claude,gemini,codex`)
53
+ - `--dispatch <mode>`: ๋””์ŠคํŒจ์น˜ ๋ชจ๋“œ ๋ณ€๊ฒฝ (`omc` ๋˜๋Š” `direct`)
54
+
55
+ ๋ชจ๋ธ ์œ ํšจ์„ฑ ๊ฒ€์‚ฌ: ์š”์ฒญ๋œ ๋ชจ๋“  ๋ชจ๋ธ์ด ์ง€์› ๋ชฉ๋ก (`claude`, `codex`, `gemini`) ์•ˆ์— ์žˆ๋Š”์ง€ ํ™•์ธํ•œ๋‹ค. ์ง€์›ํ•˜์ง€ ์•Š๋Š” ๋ชจ๋ธ์ด ์žˆ์œผ๋ฉด ๊ฒฝ๊ณ ๋ฅผ ํ‘œ์‹œํ•˜๊ณ  ํ•ด๋‹น ๋ชจ๋ธ์„ ๊ฑด๋„ˆ๋›ด๋‹ค.
56
+
57
+ ### ์„ค์น˜ ์ธํ„ฐ๋ทฐ (์ตœ์ดˆ ์‹คํ–‰)
58
+
59
+ `.patina.yaml` (์‚ฌ์šฉ์ž ์„ค์ • ํŒŒ์ผ)์ด ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ์— ์—†์œผ๋ฉด ์ตœ์ดˆ ์‹คํ–‰์œผ๋กœ ๊ฐ„์ฃผํ•˜๊ณ  `AskUserQuestion`์œผ๋กœ ์ธํ„ฐ๋ทฐ๋ฅผ ์ง„ํ–‰ํ•œ๋‹ค:
60
+
61
+ 1. **๋ชจ๋ธ ์„ ํƒ**: "MAX mode์—์„œ ์‚ฌ์šฉํ•  ๋ชจ๋ธ์„ ์„ ํƒํ•˜์„ธ์š” (์‰ผํ‘œ ๊ตฌ๋ถ„): claude, gemini, codex"
62
+ - ๊ธฐ๋ณธ๊ฐ’: `claude, gemini`
63
+ - ์‘๋‹ต์„ `max-models` ๋ชฉ๋ก์œผ๋กœ ์ €์žฅ
64
+
65
+ 2. **๋””์ŠคํŒจ์น˜ ๋ชจ๋“œ**: "๋””์ŠคํŒจ์น˜ ๋ชจ๋“œ๋ฅผ ์„ ํƒํ•˜์„ธ์š”:"
66
+ - `omc` โ€” tmux pane ๋ณ‘๋ ฌ ์‹คํ–‰ (์ถ”์ฒœ, OMC + tmux ํ•„์š”)
67
+ - `direct` โ€” stdin pipe ์ˆœ์ฐจ ์‹คํ–‰ (์˜์กด์„ฑ ์—†์Œ)
68
+ - ๊ธฐ๋ณธ๊ฐ’: `omc`
69
+
70
+ 3. **CLI ์„ค์น˜ ํ™•์ธ**: ์„ ํƒ๋œ ๊ฐ ๋ชจ๋ธ์˜ CLI๋ฅผ `which` ๋ช…๋ น์œผ๋กœ ํ™•์ธํ•œ๋‹ค
71
+ - ๋ฏธ์„ค์น˜ ๋ชจ๋ธ์ด ์žˆ์œผ๋ฉด ์„ค์น˜ ์•ˆ๋‚ด๋ฅผ ํ‘œ์‹œ:
72
+ - `claude`: `npm install -g @anthropic-ai/claude-code`
73
+ - `gemini`: `npm install -g @google/gemini-cli`
74
+ - `codex`: `npm install -g @openai/codex`
75
+ - ๋ฏธ์„ค์น˜ ๋ชจ๋ธ์ด ์žˆ์–ด๋„ ์„ค์ •์€ ์ €์žฅํ•œ๋‹ค (๋‚˜์ค‘์— ์„ค์น˜ ๊ฐ€๋Šฅ)
76
+
77
+ 4. **OMC/tmux ํ™•์ธ** (`dispatch: omc` ์„ ํƒ ์‹œ):
78
+ - `$TMUX` ํ™˜๊ฒฝ๋ณ€์ˆ˜๋กœ tmux ์„ธ์…˜ ์—ฌ๋ถ€ ํ™•์ธ
79
+ - tmux๊ฐ€ ์•„๋‹ˆ๋ฉด ์•„๋ž˜์˜ ์ •ํ™•ํ•œ ๊ฒฝ๊ณ ๋ฅผ stderr์— ์ถœ๋ ฅํ•˜๊ณ  `dispatch: direct`๋กœ ์ž๋™ ์ „ํ™˜:
80
+ `[patina-max] tmux not detected. Falling back to sequential dispatch (expect ~Xmin instead of ~Ys). Pass --dispatch direct to silence.`
81
+ - ์‚ฌ์šฉ์ž๊ฐ€ ๋ช…์‹œ์ ์œผ๋กœ `--dispatch direct`๋ฅผ ์„ ํƒํ•œ ๊ฒฝ์šฐ์—๋Š” ๊ฒฝ๊ณ ๋ฅผ ์ถœ๋ ฅํ•˜์ง€ ์•Š๋Š”๋‹ค
82
+
83
+ ์ธํ„ฐ๋ทฐ ๊ฒฐ๊ณผ๋ฅผ `.patina.yaml`์— ์ €์žฅํ•œ๋‹ค:
84
+
85
+ ```yaml
86
+ # Generated by patina-max setup interview
87
+ max-models:
88
+ - claude
89
+ - gemini
90
+ dispatch: omc
91
+ ```
92
+
93
+ ์ดํ›„ ์‹คํ–‰์—์„œ๋Š” `.patina.yaml`์ด ์กด์žฌํ•˜๋ฉด ์ธํ„ฐ๋ทฐ๋ฅผ ๊ฑด๋„ˆ๋›ฐ๊ณ  ๋ฐ”๋กœ ์„ค์ •์„ ๋กœ๋“œํ•œ๋‹ค. `.patina.default.yaml`๋ณด๋‹ค `.patina.yaml`์˜ ๊ฐ’์ด ์šฐ์„ ํ•œ๋‹ค.
94
+
95
+ ---
96
+
97
+ ## 2๋‹จ๊ณ„: ํŒจํ„ด ํŒฉ ๋กœ๋“œ
98
+
99
+ 1๋‹จ๊ณ„์—์„œ ๊ฒฐ์ •๋œ ์–ธ์–ด ์ฝ”๋“œ๋ฅผ `{lang}`์œผ๋กœ ์‚ฌ์šฉํ•˜์—ฌ ํŒจํ„ด ํŒฉ์„ ์ž๋™ ํƒ์ƒ‰ํ•œ๋‹ค.
100
+
101
+ ```
102
+ Glob patterns/{lang}-*.md โ†’ Read ๊ฐ ํŒŒ์ผ
103
+ Glob custom/patterns/{lang}-*.md โ†’ Read (์‚ฌ์šฉ์ž ์ปค์Šคํ…€ ํŒจํ„ด ์ถ”๊ฐ€ ๋กœ๋“œ)
104
+ ```
105
+
106
+ `skip-patterns`์— ํ•ด๋‹นํ•˜๋Š” ํŒฉ์€ ์ œ์™ธํ•œ๋‹ค.
107
+
108
+ ๋ชจ๋“  ํŒจํ„ด ํŒฉ์˜ ์ „์ฒด ๋‚ด์šฉ์„ ๋ฉ”๋ชจ๋ฆฌ์— ๋ณด๊ด€ํ•œ๋‹ค โ€” 4๋‹จ๊ณ„์—์„œ ์›Œ์ปค ํ”„๋กฌํ”„ํŠธ์— ์ธ๋ผ์ธํ•ด์•ผ ํ•œ๋‹ค.
109
+
110
+ ---
111
+
112
+ ## 3๋‹จ๊ณ„: ํ”„๋กœํ•„ + ๋ชฉ์†Œ๋ฆฌ ์ง€์นจ ๋กœ๋“œ
113
+
114
+ ```
115
+ Read profiles/{profile}.md
116
+ Glob custom/profiles/{profile}.md โ†’ Read (์ปค์Šคํ…€ ํ”„๋กœํ•„ ์šฐ์„ )
117
+ Read core/voice.md
118
+ ```
119
+
120
+ ํ”„๋กœํ•„๊ณผ voice.md์˜ ์ „์ฒด ๋‚ด์šฉ์„ ๋ฉ”๋ชจ๋ฆฌ์— ๋ณด๊ด€ํ•œ๋‹ค โ€” 4๋‹จ๊ณ„์—์„œ ์›Œ์ปค ํ”„๋กฌํ”„ํŠธ์— ์ธ๋ผ์ธํ•ด์•ผ ํ•œ๋‹ค.
121
+
122
+ ---
123
+
124
+ ## 4๋‹จ๊ณ„: ์›Œ์ปค ํ”„๋กฌํ”„ํŠธ ๊ตฌ์„ฑ
125
+
126
+ ๋ชจ๋“  ๋ชจ๋ธ์— ๋ณด๋‚ผ **ํ•˜๋‚˜์˜ ์ž๋ฆฝํ˜• ํ”„๋กฌํ”„ํŠธ**๋ฅผ ๊ตฌ์„ฑํ•œ๋‹ค. ์ด ํ”„๋กฌํ”„ํŠธ๋Š” ๋ชจ๋ธ์— ๋ฌด๊ด€ํ•˜๊ฒŒ ๋™์ž‘ํ•ด์•ผ ํ•œ๋‹ค.
127
+
128
+ ํ”„๋กฌํ”„ํŠธ ๊ตฌ์กฐ:
129
+
130
+ ```
131
+ ๋‹น์‹ ์€ AI๊ฐ€ ์ƒ์„ฑํ•œ ํ…์ŠคํŠธ์—์„œ AI ํŠน์œ ์˜ ํŒจํ„ด์„ ์ฐพ์•„ ์ œ๊ฑฐํ•˜์—ฌ, ๊ธ€์„ ์ž์—ฐ์Šค๋Ÿฝ๊ณ  ์‚ฌ๋žŒ์ด ์“ด ๊ฒƒ์ฒ˜๋Ÿผ ๋งŒ๋“œ๋Š” ํŽธ์ง‘์ž์ž…๋‹ˆ๋‹ค.
132
+
133
+ ## ํŒจํ„ด ํŒฉ
134
+ {2๋‹จ๊ณ„์—์„œ ๋กœ๋“œํ•œ ๋ชจ๋“  ํŒจํ„ด ํŒฉ์˜ ์ „์ฒด ๋‚ด์šฉ์„ ์—ฌ๊ธฐ์— ์ธ๋ผ์ธ}
135
+
136
+ ## ํ”„๋กœํ•„ ์ง€์นจ
137
+ {3๋‹จ๊ณ„์—์„œ ๋กœ๋“œํ•œ ํ”„๋กœํ•„ ๋‚ด์šฉ์„ ์—ฌ๊ธฐ์— ์ธ๋ผ์ธ}
138
+
139
+ ## ๋ชฉ์†Œ๋ฆฌ ์ง€์นจ
140
+ {3๋‹จ๊ณ„์—์„œ ๋กœ๋“œํ•œ voice.md ๋‚ด์šฉ์„ ์—ฌ๊ธฐ์— ์ธ๋ผ์ธ}
141
+
142
+ ## ์ฒ˜๋ฆฌ ์ง€์นจ
143
+ 1. ์œ„์˜ ํŒจํ„ด ํŒฉ์—์„œ ์ •์˜๋œ ๋ชจ๋“  AI ํŒจํ„ด์„ ์ž…๋ ฅ ํ…์ŠคํŠธ์—์„œ ์Šค์บ”ํ•˜๋ผ
144
+ 2. ๋ฐœ๊ฒฌ๋œ AI ํŒจํ„ด์„ ์ž์—ฐ์Šค๋Ÿฌ์šด ๋Œ€์•ˆ์œผ๋กœ ๊ต์ฒดํ•˜๋ผ
145
+ 3. ํ•ต์‹ฌ ๋ฉ”์‹œ์ง€์™€ ์˜๋ฏธ๋ฅผ ๋ณด์กดํ•˜๋ผ
146
+ 4. ํ”„๋กœํ•„์˜ ์–ด์กฐ ์ง€์นจ์— ๋”ฐ๋ผ ํ†ค์„ ์กฐ์ ˆํ•˜๋ผ
147
+ 5. ๋ชฉ์†Œ๋ฆฌ ์ง€์นจ์— ๋”ฐ๋ผ ์‹ค์ œ ์‚ฌ๋žŒ์˜ ๊ฐœ์„ฑ์„ ๋ถˆ์–ด๋„ฃ์–ด๋ผ
148
+
149
+ ## ์ž…๋ ฅ ํ…์ŠคํŠธ
150
+ {์‚ฌ์šฉ์ž๊ฐ€ ์ œ๊ณตํ•œ ์›๋ฌธ ํ…์ŠคํŠธ}
151
+
152
+ ## ์ค‘์š” ์ œ์•ฝ
153
+ Humanize this text by removing the AI patterns described above.
154
+ Output ONLY the humanized text.
155
+ Do not use any tools. Do not read or modify any files.
156
+ Do not ask questions. Do not include explanations or metadata.
157
+ ```
158
+
159
+ ์ด ํ”„๋กฌํ”„ํŠธ๋ฅผ ์‹คํ–‰๋งˆ๋‹ค ๊ณ ์œ ํ•œ ์ž„์‹œ ๋””๋ ‰ํ„ฐ๋ฆฌ์— ์ €์žฅํ•œ๋‹ค:
160
+
161
+ ```bash
162
+ RUN_DIR="$(mktemp -d /tmp/patina-max.XXXXXX)"
163
+ PROMPT_FILE="$RUN_DIR/prompt.txt"
164
+ TIMEOUT_SECONDS=900
165
+ ```
166
+
167
+ ์ดํ›„ ์˜ˆ์‹œ์˜ `$RUN_DIR`/`$PROMPT_FILE`์€ ์ด ์‹คํ–‰์—์„œ ์ƒ์„ฑํ•œ ๊ฒฝ๋กœ๋ฅผ ๋œปํ•œ๋‹ค. ์ตœ์ข… ์ถœ๋ ฅ์ด ๋๋‚  ๋•Œ๊นŒ์ง€ ์ด ๋””๋ ‰ํ„ฐ๋ฆฌ๋ฅผ ์œ ์ง€ํ•˜๊ณ , ๋งˆ์ง€๋ง‰์— ์ •๋ฆฌํ•œ๋‹ค.
168
+
169
+ ```
170
+ Write tool โ†’ $PROMPT_FILE
171
+ ```
172
+
173
+ ---
174
+
175
+ ## 5๋‹จ๊ณ„: ๋ชจ๋ธ ๋””์ŠคํŒจ์น˜ (dispatch-aware)
176
+
177
+ ํ”„๋กฌํ”„ํŠธ๋Š” ์ด๋ฏธ `$PROMPT_FILE`์— ์ €์žฅ๋˜์–ด ์žˆ๋‹ค (4๋‹จ๊ณ„).
178
+ Claude/Codex๋Š” **stdin pipe**, Gemini๋Š” **`$(cat file)` ์ธ์ž ์น˜ํ™˜**์œผ๋กœ ํ”„๋กฌํ”„ํŠธ๋ฅผ ์ „๋‹ฌํ•œ๋‹ค.
179
+ ํ”„๋กฌํ”„ํŠธ๋Š” ํŒŒ์ผ์—์„œ ์ฝ์œผ๋ฏ€๋กœ ์…ธ ๋ณ€์ˆ˜ ํ™•์žฅ ์—†์ด ์•ˆ์ „ํ•˜๊ฒŒ ์ „๋‹ฌ๋œ๋‹ค.
180
+
181
+ - Claude: `claude -p`
182
+ - Gemini: `gemini -p "$(cat $PROMPT_FILE)" --output-format text`
183
+ - Codex: `codex exec --skip-git-repo-check --output-last-message <file>`
184
+
185
+ ๊ณ ์ • `/tmp/patina-max-*` ํŒŒ์ผ๋ช…์€ ์‚ฌ์šฉํ•˜์ง€ ์•Š๋Š”๋‹ค. ๋ชจ๋“  ์‚ฐ์ถœ๋ฌผ์€ `$RUN_DIR` ์•„๋ž˜์— ์ €์žฅํ•œ๋‹ค.
186
+
187
+ ### Dispatch preflight
188
+
189
+ `DISPATCH_MODE`๋Š” ์„ค์ • ํŒŒ์ผ๊ณผ `--dispatch` ํ”Œ๋ž˜๊ทธ๋ฅผ ๋ฐ˜์˜ํ•œ ์ตœ์ข… dispatch ๊ฐ’์ด๋‹ค. ์‚ฌ์šฉ์ž๊ฐ€ `--dispatch direct`๋ฅผ ๋ช…์‹œํ–ˆ์œผ๋ฉด ์ด preflight๋Š” ๊ฒฝ๊ณ  ์—†์ด direct ๋ชจ๋“œ๋ฅผ ์œ ์ง€ํ•œ๋‹ค.
190
+
191
+ ```bash
192
+ if [ "$DISPATCH_MODE" = "omc" ] && [ -z "${TMUX:-}" ]; then
193
+ MODEL_COUNT=$(printf '%s\n' $SELECTED_MODELS | sed '/^$/d' | wc -l | tr -d ' ')
194
+ DIRECT_MIN=$(( (MODEL_COUNT * TIMEOUT_SECONDS + 59) / 60 ))
195
+ printf '[patina-max] tmux not detected. Falling back to sequential dispatch (expect ~%smin instead of ~%ss). Pass --dispatch direct to silence.\n' \
196
+ "$DIRECT_MIN" "$TIMEOUT_SECONDS" >&2
197
+ DISPATCH_MODE="direct"
198
+ fi
199
+ ```
200
+
201
+ ### ๋ชจ๋“œ A: OMC dispatch (`dispatch: omc`)
202
+
203
+ tmux pane์„ ์‚ฌ์šฉํ•˜์—ฌ ๋ชจ๋“  ๋ชจ๋ธ์„ **๋ณ‘๋ ฌ** ์‹คํ–‰ํ•œ๋‹ค. ๊ฐ pane์—์„œ ํ”„๋กฌํ”„ํŠธ ํŒŒ์ผ์„ ์ฝ์–ด ์ „๋‹ฌํ•˜๊ณ , ์™„๋ฃŒ ์‹œ sentinel ํŒŒ์ผ์„ ์ƒ์„ฑํ•œ๋‹ค. wall-clock ์ƒํ•œ์€ ๊ฐ€์žฅ ๋А๋ฆฐ ๋ชจ๋ธ ํ•˜๋‚˜์— ๊ฐ€๊น๋‹ค (`TIMEOUT_SECONDS=900`์ด๋ฉด ์•ฝ 900์ดˆ).
204
+
205
+ ```bash
206
+ SELECTED_MODELS="claude gemini codex" # ์‹ค์ œ๋กœ๋Š” ์„ค์ •/ํ”Œ๋ž˜๊ทธ์—์„œ ์„ ํƒ๋œ ๋ชจ๋ธ๋งŒ ํฌํ•จ
207
+ CLAUDE_PANE=""
208
+ GEMINI_PANE=""
209
+ CODEX_PANE=""
210
+
211
+ # Claude
212
+ CLAUDE_PANE=$(tmux split-window -d -P -F "#{pane_id}" -h \
213
+ "cat \"$PROMPT_FILE\" | claude -p > \"$RUN_DIR/claude-output.txt\" 2> \"$RUN_DIR/claude-log.txt\"; printf '%s' \$? > \"$RUN_DIR/claude.exit\"; touch \"$RUN_DIR/claude.done\"")
214
+
215
+ # Gemini
216
+ GEMINI_PANE=$(tmux split-window -d -P -F "#{pane_id}" -v \
217
+ "gemini -p \"\$(cat \\\"$PROMPT_FILE\\\")\" --output-format text > \"$RUN_DIR/gemini-output.txt\" 2> \"$RUN_DIR/gemini-log.txt\"; printf '%s' \$? > \"$RUN_DIR/gemini.exit\"; touch \"$RUN_DIR/gemini.done\"")
218
+
219
+ # Codex
220
+ CODEX_PANE=$(tmux split-window -d -P -F "#{pane_id}" -v \
221
+ "cat \"$PROMPT_FILE\" | codex exec --skip-git-repo-check --output-last-message \"$RUN_DIR/codex-output.txt\" > \"$RUN_DIR/codex-log.txt\" 2>&1; printf '%s' \$? > \"$RUN_DIR/codex.exit\"; touch \"$RUN_DIR/codex.done\"")
222
+ ```
223
+
224
+ ์‹ค์ œ ์‹คํ–‰์€ `max-models`์— ํฌํ•จ๋œ ๋ชจ๋ธ์˜ pane๋งŒ ์ƒ์„ฑํ•˜๊ณ , pane id๋„ ํ•ด๋‹น ๋ชจ๋ธ์— ๋Œ€ํ•ด์„œ๋งŒ ๊ธฐ๋กํ•œ๋‹ค.
225
+
226
+ **์™„๋ฃŒ ๋Œ€๊ธฐ**: Bash๋กœ sentinel ํŒŒ์ผ์„ ํด๋งํ•œ๋‹ค.
227
+
228
+ ```bash
229
+ START_TIME=$(date +%s)
230
+
231
+ # ์„ ํƒ๋œ ๋ชจ๋ธ๋“ค์˜ .done ํŒŒ์ผ๋งŒ ๊ธฐ๋‹ค๋ฆฐ๋‹ค
232
+ while true; do
233
+ ALL_DONE=true
234
+ for model in $SELECTED_MODELS; do
235
+ [ -f "$RUN_DIR/$model.done" ] || ALL_DONE=false
236
+ done
237
+ $ALL_DONE && break
238
+
239
+ NOW=$(date +%s)
240
+ if [ $((NOW - START_TIME)) -ge $TIMEOUT_SECONDS ]; then
241
+ for model in $SELECTED_MODELS; do
242
+ if [ ! -f "$RUN_DIR/$model.done" ]; then
243
+ printf '124' > "$RUN_DIR/$model.exit"
244
+ printf 'timeout after %ss\n' "$TIMEOUT_SECONDS" > "$RUN_DIR/$model.log.txt"
245
+ touch "$RUN_DIR/$model.timeout" "$RUN_DIR/$model.done"
246
+ fi
247
+ done
248
+ [ -n "$CLAUDE_PANE" ] && tmux kill-pane -t "$CLAUDE_PANE" 2>/dev/null || true
249
+ [ -n "$GEMINI_PANE" ] && tmux kill-pane -t "$GEMINI_PANE" 2>/dev/null || true
250
+ [ -n "$CODEX_PANE" ] && tmux kill-pane -t "$CODEX_PANE" 2>/dev/null || true
251
+ break
252
+ fi
253
+
254
+ sleep 3
255
+ done
256
+ ```
257
+
258
+ > tmux pane์€ ์‹คํ–‰ ์™„๋ฃŒ ํ›„ ์ž๋™์œผ๋กœ ๋‹ซํžŒ๋‹ค. ์ง„ํ–‰ ์ค‘์—๋Š” ์‚ฌ์šฉ์ž๊ฐ€ pane์„ ์ „ํ™˜ํ•˜์—ฌ ๊ฐ ๋ชจ๋ธ์˜ ์‹คํ–‰ ์ƒํƒœ๋ฅผ ์‹œ๊ฐ์ ์œผ๋กœ ํ™•์ธํ•  ์ˆ˜ ์žˆ๋‹ค. ํƒ€์ž„์•„์›ƒ์ด ๋ฐœ์ƒํ•œ pane์€ kill ํ›„ `failed`๋กœ ํ‘œ์‹œํ•œ๋‹ค.
259
+
260
+ ### ๋ชจ๋“œ B: Direct dispatch (`dispatch: direct`)
261
+
262
+ tmux ์—†์ด ์ˆœ์ฐจ์ ์œผ๋กœ ์‹คํ–‰ํ•œ๋‹ค. OMC/tmux๊ฐ€ ์—†๋Š” ํ™˜๊ฒฝ์—์„œ์˜ fallback. wall-clock ์ƒํ•œ์€ ์„ ํƒํ•œ ๋ชจ๋ธ ์ˆ˜์— ๋น„๋ก€ํ•œ๋‹ค (`TIMEOUT_SECONDS=900`, ๋ชจ๋ธ 3๊ฐœ๋ฉด ์•ฝ 45๋ถ„๊นŒ์ง€ ๊ฐ€๋Šฅ). ๋ณ‘๋ ฌ tmux ์‹คํ–‰๋ณด๋‹ค ๋А๋ฆด ์ˆ˜ ์žˆ์œผ๋ฏ€๋กœ, ์˜๋„์ ์œผ๋กœ direct๋ฅผ ์“ฐ๋Š” ๊ฒฝ์šฐ `--dispatch direct`๋ฅผ ๋ช…์‹œํ•˜๋ฉด fallback ๊ฒฝ๊ณ ๋ฅผ ๋Œ ์ˆ˜ ์žˆ๋‹ค.
263
+
264
+ ```bash
265
+ # Claude
266
+ timeout "${TIMEOUT_SECONDS}s" sh -c 'cat "$1" | claude -p > "$2" 2> "$3"' sh \
267
+ "$PROMPT_FILE" "$RUN_DIR/claude-output.txt" "$RUN_DIR/claude-log.txt"
268
+ printf '%s' $? > "$RUN_DIR/claude.exit"
269
+ touch "$RUN_DIR/claude.done"
270
+
271
+ # Gemini
272
+ timeout "${TIMEOUT_SECONDS}s" sh -c 'gemini -p "$(cat "$1")" --output-format text > "$2" 2> "$3"' sh \
273
+ "$PROMPT_FILE" "$RUN_DIR/gemini-output.txt" "$RUN_DIR/gemini-log.txt"
274
+ printf '%s' $? > "$RUN_DIR/gemini.exit"
275
+ touch "$RUN_DIR/gemini.done"
276
+
277
+ # Codex
278
+ timeout "${TIMEOUT_SECONDS}s" sh -c 'cat "$1" | codex exec --skip-git-repo-check --output-last-message "$2" > "$3" 2>&1' sh \
279
+ "$PROMPT_FILE" "$RUN_DIR/codex-output.txt" "$RUN_DIR/codex-log.txt"
280
+ printf '%s' $? > "$RUN_DIR/codex.exit"
281
+ touch "$RUN_DIR/codex.done"
282
+ ```
283
+
284
+ ์‹ค์ œ ์‹คํ–‰์€ `max-models`์— ํฌํ•จ๋œ ๋ชจ๋ธ์—๋งŒ ์ ์šฉํ•œ๋‹ค. ๊ฐ ๋ช…๋ น์€ `TIMEOUT_SECONDS` ์ƒํ•œ์„ ๋‘๊ณ , `timeout`์ด ์—†์œผ๋ฉด ๋™๋“ฑํ•œ ํƒ€์ž„์•„์›ƒ ๋ž˜ํผ(`gtimeout` ๋“ฑ)๋กœ ๋Œ€์ฒดํ•œ๋‹ค.
285
+
286
+ ### ๊ฒฐ๊ณผ ์ˆ˜์ง‘ (๊ณตํ†ต)
287
+
288
+ - `claude`
289
+ 1. `$RUN_DIR/claude-output.txt`๋ฅผ Readํ•œ๋‹ค
290
+ 2. `$RUN_DIR/claude.exit`๊ฐ€ 0์ด๊ณ  output์ด ๋น„์–ด ์žˆ์ง€ ์•Š์œผ๋ฉด ๊ฒฐ๊ณผ ํ…์ŠคํŠธ๋กœ ์‚ฌ์šฉํ•œ๋‹ค
291
+ 3. ์‹คํŒจ ๋˜๋Š” ๋นˆ ์ถœ๋ ฅ์ด๋ฉด `$RUN_DIR/claude-log.txt`๋ฅผ ์ง„๋‹จ ์ •๋ณด๋กœ Readํ•œ๋‹ค
292
+
293
+ - `gemini`
294
+ 1. `$RUN_DIR/gemini-output.txt`๋ฅผ Readํ•œ๋‹ค
295
+ 2. `$RUN_DIR/gemini.exit`๊ฐ€ 0์ด๊ณ  output์ด ๋น„์–ด ์žˆ์ง€ ์•Š์œผ๋ฉด ๊ฒฐ๊ณผ ํ…์ŠคํŠธ๋กœ ์‚ฌ์šฉํ•œ๋‹ค
296
+ 3. `$RUN_DIR/gemini-log.txt`์—๋Š” ์ธ์ฆ/ํ™•์žฅ/MCP ๊ฒฝ๊ณ ๊ฐ€ ํฌํ•จ๋  ์ˆ˜ ์žˆ์œผ๋ฏ€๋กœ, ์‹คํŒจ ์ง„๋‹จ์šฉ์œผ๋กœ๋งŒ ์‚ฌ์šฉํ•œ๋‹ค
297
+
298
+ - `codex`
299
+ 1. `$RUN_DIR/codex-output.txt`๋ฅผ Readํ•œ๋‹ค (`--output-last-message`๊ฐ€ ๊ธฐ๋กํ•œ ์ตœ์ข… ํ…์ŠคํŠธ)
300
+ 2. `$RUN_DIR/codex.exit`๊ฐ€ 0์ด๊ณ  output์ด ๋น„์–ด ์žˆ์ง€ ์•Š์œผ๋ฉด ๊ฒฐ๊ณผ ํ…์ŠคํŠธ๋กœ ์‚ฌ์šฉํ•œ๋‹ค
301
+ 3. ์‹คํŒจ ๋˜๋Š” ๋นˆ ์ถœ๋ ฅ์ด๋ฉด `$RUN_DIR/codex-log.txt`๋ฅผ ์ง„๋‹จ ์ •๋ณด๋กœ Readํ•œ๋‹ค
302
+
303
+ ### ์‹คํŒจ ์ฒ˜๋ฆฌ
304
+
305
+ - ํŠน์ • ๋ชจ๋ธ์˜ exit code๊ฐ€ 0์ด ์•„๋‹ˆ๊ฑฐ๋‚˜, output ํŒŒ์ผ์ด ๋น„์–ด ์žˆ๊ฑฐ๋‚˜, ํŒŒ์ผ์ด ์—†์œผ๋ฉด โ†’ ํ•ด๋‹น ๋ชจ๋ธ์„ `failed`๋กœ ํ‘œ์‹œํ•˜๊ณ  ๋‚˜๋จธ์ง€๋กœ ๊ณ„์† ์ง„ํ–‰
306
+ - `.timeout` ํŒŒ์ผ์ด ์žˆ๊ฑฐ๋‚˜ exit code๊ฐ€ `124`์ด๋ฉด โ†’ `timed out`์œผ๋กœ ๊ธฐ๋กํ•˜๊ณ  `failed`๋กœ ํ‘œ์‹œ
307
+ - `.done` ํŒŒ์ผ์€ ์ƒ๊ฒผ์ง€๋งŒ output ํŒŒ์ผ์ด ๋น„์–ด ์žˆ์œผ๋ฉด โ†’ CLI๊ฐ€ ๋นˆ ์‘๋‹ต์„ ๋ฐ˜ํ™˜ํ•œ ๊ฒƒ์ด๋ฏ€๋กœ `failed`๋กœ ํ‘œ์‹œ
308
+ - ๋ชจ๋“  ๋ชจ๋ธ์ด ์‹คํŒจํ•œ ๊ฒฝ์šฐ โ†’ ์—๋Ÿฌ ๋ฉ”์‹œ์ง€์™€ ํ•จ๊ป˜ ๊ฐ ๋ชจ๋ธ์˜ output/log ํŒŒ์ผ ๋‚ด์šฉ์„ ์ง„๋‹จ ์ •๋ณด๋กœ ์ถœ๋ ฅํ•˜๊ณ  ์ข…๋ฃŒ
309
+ - `dispatch: omc`์—์„œ tmux๊ฐ€ ์—†์œผ๋ฉด (`$TMUX` ๋ฏธ์„ค์ •) โ†’ `[patina-max] tmux not detected. Falling back to sequential dispatch (expect ~Xmin instead of ~Ys). Pass --dispatch direct to silence.` ํ˜•์‹์˜ ๊ฒฝ๊ณ  ํ›„ direct ๋ชจ๋“œ๋กœ ์ž๋™ ์ „ํ™˜
310
+ - `--dispatch direct`๋ฅผ ๋ช…์‹œํ•œ ๊ฒฝ์šฐ โ†’ ์ด๋ฏธ ์ˆœ์ฐจ ์‹คํ–‰์„ ์„ ํƒํ•œ ๊ฒƒ์ด๋ฏ€๋กœ tmux fallback ๊ฒฝ๊ณ ๋ฅผ ์ถœ๋ ฅํ•˜์ง€ ์•Š์Œ
311
+
312
+ ---
313
+
314
+ ## 6๋‹จ๊ณ„: ๊ฒฐ๊ณผ ํ‰๊ฐ€ (AI ์œ ์‚ฌ๋„ ์ ์ˆ˜)
315
+
316
+ ๊ฐ ๋ชจ๋ธ์˜ humanize ๊ฒฐ๊ณผ์— ๋Œ€ํ•ด `core/scoring.md`์˜ ์ˆ˜์‹ ๊ธฐ๋ฐ˜ ์Šค์ฝ”์–ด๋ง ์•Œ๊ณ ๋ฆฌ์ฆ˜์„ ์ ์šฉํ•œ๋‹ค.
317
+
318
+ 2๋‹จ๊ณ„์—์„œ ๋กœ๋“œํ•œ ๋ชจ๋“  ํŒจํ„ด ํŒฉ์„ ๊ธฐ์ค€์œผ๋กœ, ๊ฐ ๊ฒฐ๊ณผ์— ๋Œ€ํ•ด SKILL.md์˜ `--score` ๋ชจ๋“œ์™€ ๋™์ผํ•œ ์ ˆ์ฐจ๋ฅผ ์‹คํ–‰ํ•œ๋‹ค:
319
+
320
+ 1. **ํŒจํ„ด ๊ฐ์ง€**: ๋ชจ๋“  ํŒจํ„ด์„ ์Šค์บ”ํ•˜๊ณ , ๊ฐ์ง€๋œ ๊ฐ ํŒจํ„ด์— severity๋ฅผ ๋ถ€์—ฌํ•œ๋‹ค (`core/scoring.md`์˜ ์‹ฌ๊ฐ๋„ ๋ฃจ๋ธŒ๋ฆญ ์ฐธ์กฐ)
321
+ 2. **ํ”„๋กœํ•„ ์˜ค๋ฒ„๋ผ์ด๋“œ ์ ์šฉ**: pattern-overrides๊ฐ€ ์žˆ์œผ๋ฉด severity๋ฅผ ์กฐ์ •ํ•œ๋‹ค
322
+ 3. **์นดํ…Œ๊ณ ๋ฆฌ ์ ์ˆ˜ ๊ณ„์‚ฐ**: `์นดํ…Œ๊ณ ๋ฆฌ ์ ์ˆ˜ = (์กฐ์ •๋œ ์‹ฌ๊ฐ๋„ ํ•ฉ๊ณ„ / (ํŒจํ„ด ์ˆ˜ ร— 3)) ร— 100`
323
+ 4. **์ „์ฒด ์ ์ˆ˜ ๊ณ„์‚ฐ**: ์นดํ…Œ๊ณ ๋ฆฌ ์ ์ˆ˜์˜ ๊ฐ€์ค‘ ํ‰๊ท  (`ouroboros.category-weights.{lang}` ์‚ฌ์šฉ)
324
+
325
+ ์ด ์ ˆ์ฐจ๋Š” ๊ฐ ๋ชจ๋ธ์˜ ๊ฒฐ๊ณผ์— ๋Œ€ํ•ด ๋…๋ฆฝ์ ์œผ๋กœ ์‹คํ–‰ํ•œ๋‹ค. ๋ชจ๋“  ๋ชจ๋ธ์ด ๋™์ผํ•œ ์ˆ˜์‹์œผ๋กœ ํ‰๊ฐ€๋˜๋ฏ€๋กœ ๊ณต์ •ํ•œ ๋น„๊ต๊ฐ€ ๊ฐ€๋Šฅํ•˜๋‹ค.
326
+
327
+ ๊ฐ ๊ฒฐ๊ณผ์— ๋Œ€ํ•ด ์ถ”๊ฐ€๋กœ MPS(Meaning Preservation Score)๋ฅผ ์‚ฐ์ถœํ•œ๋‹ค. ์›๋ณธ ํ…์ŠคํŠธ์—์„œ ์˜๋ฏธ ์•ต์ปค๋ฅผ ์ถ”์ถœํ•˜๊ณ , ๊ฐ ๋ชจ๋ธ์˜ humanize ๊ฒฐ๊ณผ๊ฐ€ ์•ต์ปค๋ฅผ ์–ผ๋งˆ๋‚˜ ๋ณด์กดํ–ˆ๋Š”์ง€๋ฅผ `core/scoring.md` ยงยง 14-17์˜ ์ ˆ์ฐจ๋กœ ํ‰๊ฐ€ํ•œ๋‹ค.
328
+
329
+ > **์ฐธ๊ณ :** ์ด์ „ ๋ฒ„์ „์—์„œ๋Š” MAX ๋ชจ๋“œ๊ฐ€ ์ฃผ๊ด€์  ํ‰๊ฐ€๋ฅผ ์‚ฌ์šฉํ–ˆ์œผ๋‚˜, v3.2.0๋ถ€ํ„ฐ `core/scoring.md`์˜ ์ˆ˜์‹ ๊ธฐ๋ฐ˜ ์•Œ๊ณ ๋ฆฌ์ฆ˜์œผ๋กœ ํ†ตํ•ฉ๋˜์—ˆ๋‹ค. ๋‹จ์ผ ๋ชจ๋“œ(`--score`)์™€ MAX ๋ชจ๋“œ๊ฐ€ ๋™์ผํ•œ ์Šค์ฝ”์–ด๋ง์„ ์‚ฌ์šฉํ•œ๋‹ค.
330
+
331
+ ---
332
+
333
+ ## 7๋‹จ๊ณ„: ๋น„๊ต ๋ฐ ์„ ํƒ
334
+
335
+ ๊ฒฐ๊ณผ ๋น„๊ต ํ…Œ์ด๋ธ”์„ ๊ตฌ์„ฑํ•˜๊ณ  ์ตœ์ข…๋ณธ์„ ์„ ํƒํ•œ๋‹ค.
336
+
337
+ ### ๋น„๊ต ํ…Œ์ด๋ธ” ํ˜•์‹
338
+
339
+ ```
340
+ | Model | AI Score | MPS | Status |
341
+ |---------|----------|------|---------|
342
+ | claude | 23 | 92 | โœ… |
343
+ | gemini | 31 | 85 | โœ… |
344
+ | codex | -- | -- | failed |
345
+
346
+ Best: claude (AI Score: 23, MPS: 92)
347
+ ```
348
+
349
+ - MPS โ‰ฅ 70์ธ ํ›„๋ณด ์ค‘ AI ์ ์ˆ˜๊ฐ€ ๊ฐ€์žฅ ๋‚ฎ์€ ๊ฒฐ๊ณผ๋ฅผ ์ž๋™ ์„ ํƒํ•œ๋‹ค
350
+ - MPS < 70์ธ ํ›„๋ณด๋Š” AI ์ ์ˆ˜์™€ ๊ด€๊ณ„์—†์ด ํƒˆ๋ฝํ•œ๋‹ค
351
+ - ๋ชจ๋“  ํ›„๋ณด์˜ MPS < 70์ธ ๊ฒฝ์šฐ, MPS๊ฐ€ ๊ฐ€์žฅ ๋†’์€ ํ›„๋ณด๋ฅผ ์„ ํƒํ•œ๋‹ค (์˜๋ฏธ ๋ณด์กด ์šฐ์„ )
352
+ - ๋™์ ์ด๋ฉด ์„ค์ • ํŒŒ์ผ์˜ ๋ชจ๋ธ ์ˆœ์„œ์—์„œ ๋จผ์ € ์˜ค๋Š” ๊ฒƒ์„ ์šฐ์„ ํ•œ๋‹ค
353
+
354
+ ### Composite ์žฌ์„ ํƒ artifact (์„ ํƒ)
355
+
356
+ `patina-max/composite.py`๋กœ 4์ถ•(AI, MPS, RSS, EditCons) ์žฌ์„ ํƒ์„ ์‹คํ–‰ํ•˜๋ ค๋ฉด `$RUN_DIR`์— ์•„๋ž˜ ๋ ˆ์ด์•„์›ƒ์„ ์ƒ์„ฑํ•œ๋‹ค. ๊ธฐ์กด `*-output.txt`๋Š” ์ง„๋‹จ์šฉ์œผ๋กœ ์œ ์ง€ํ•˜๊ณ , ์„ฑ๊ณตํ•œ ํ›„๋ณด์˜ ์ตœ์ข… ํ…์ŠคํŠธ๋ฅผ ๋ชจ๋ธ๋ณ„ Markdown ํŒŒ์ผ๋กœ๋„ ์ €์žฅํ•œ๋‹ค.
357
+
358
+ ```text
359
+ $RUN_DIR/
360
+ input.md
361
+ claude.md
362
+ gemini.md
363
+ codex.md
364
+ meta.md
365
+ ```
366
+
367
+ - `input.md`: ์‚ฌ์šฉ์ž๊ฐ€ ์ œ๊ณตํ•œ ์›๋ฌธ ํ…์ŠคํŠธ
368
+ - `{model}.md`: ํ•ด๋‹น ๋ชจ๋ธ์˜ humanize ๊ฒฐ๊ณผ. ์‹คํŒจํ•œ ๋ชจ๋ธ์€ ํŒŒ์ผ์„ ์ƒ๋žตํ•˜๊ฑฐ๋‚˜ ์‹คํŒจ ๋ฉ”๋ชจ๋งŒ ๋‘”๋‹ค
369
+ - `meta.md`: ํ›„๋ณด๋ณ„ `model`, `status`, `ai_score`, `mps` ๊ฐ’์„ `candidates:` ๋ชฉ๋ก์œผ๋กœ ๊ธฐ๋กํ•œ๋‹ค
370
+
371
+ `meta.md` ์˜ˆ์‹œ:
372
+
373
+ ```yaml
374
+ candidates:
375
+ - model: claude
376
+ status: success
377
+ ai_score: 23
378
+ mps: 92
379
+ - model: gemini
380
+ status: failed
381
+ ai_score: n/a
382
+ mps: n/a
383
+ ```
384
+
385
+ ์‹คํ–‰:
386
+
387
+ ```bash
388
+ python3 patina-max/composite.py "$RUN_DIR"
389
+ ```
390
+
391
+ ์Šคํฌ๋ฆฝํŠธ๋Š” `$RUN_DIR/composite.md`์™€ `$RUN_DIR/winner.md`๋ฅผ ์ƒ์„ฑํ•œ๋‹ค. `--weights ai=0.4,rss=0.3`์ฒ˜๋Ÿผ ๊ฐ€์ค‘์น˜๋ฅผ ๋ฎ์–ด์“ธ ์ˆ˜ ์žˆ์œผ๋ฉฐ, ์ง€์ •ํ•˜์ง€ ์•Š์€ ์ถ•์€ ๊ธฐ๋ณธ๊ฐ’์„ ์‚ฌ์šฉํ•œ ๋’ค ํ•ฉ๊ณ„๊ฐ€ 1์ด ๋˜๋„๋ก ์ •๊ทœํ™”ํ•œ๋‹ค.
392
+
393
+ ---
394
+
395
+ ## 8๋‹จ๊ณ„: ์ถœ๋ ฅ
396
+
397
+ ### ์ตœ์ข… ์ถœ๋ ฅ ๊ตฌ์„ฑ
398
+
399
+ 1. **๋น„๊ต ํ…Œ์ด๋ธ”** โ€” ๋ชจ๋“  ๋ชจ๋ธ์˜ AI ์ ์ˆ˜์™€ ์ƒํƒœ
400
+ 2. **์ตœ์ข…๋ณธ** โ€” ๊ฐ€์žฅ ๋‚ฎ์€ AI ์ ์ˆ˜๋ฅผ ๋ฐ›์€ ๊ฒฐ๊ณผ์˜ ์ „์ฒด ํ…์ŠคํŠธ
401
+ 3. **์นดํ…Œ๊ณ ๋ฆฌ๋ณ„ ์„ธ๋ถ€ ์ ์ˆ˜** โ€” ์ตœ์ข…๋ณธ์˜ ํŒจํ„ด ์นดํ…Œ๊ณ ๋ฆฌ๋ณ„ ์ ์ˆ˜
402
+ 4. **์ฐจ์  ๊ฒฐ๊ณผ ์š”์•ฝ** โ€” ๋‹ค๋ฅธ ๋ชจ๋ธ์˜ ๊ฒฐ๊ณผ๋ฅผ ์ ‘ํžŒ ์„น์…˜์œผ๋กœ ์ œ๊ณต (์ฐธ๊ณ ์šฉ)
403
+ 5. **์‹คํŒจ ์ •๋ณด** โ€” ์‹คํŒจํ•œ ๋ชจ๋ธ์ด ์žˆ์œผ๋ฉด ์‚ฌ์œ  ํ‘œ์‹œ
404
+ 6. **์ž„์‹œ ํŒŒ์ผ ์ •๋ฆฌ** โ€” ์ถœ๋ ฅ์ด ๋๋‚œ ๋’ค `rm -rf "$RUN_DIR"`๋กœ ์ •๋ฆฌ
405
+
406
+ ### ์ถœ๋ ฅ ์˜ˆ์‹œ
407
+
408
+ ```
409
+ ## MAX Mode ๊ฒฐ๊ณผ
410
+
411
+ ### ๋น„๊ต ํ…Œ์ด๋ธ”
412
+ | Model | AI Score | Status |
413
+ |---------|----------|---------|
414
+ | claude | 23 | success |
415
+ | gemini | 31 | success |
416
+
417
+ **Best: claude (AI Score: 23)**
418
+
419
+ ### ์นดํ…Œ๊ณ ๋ฆฌ๋ณ„ ์ ์ˆ˜ (claude)
420
+ | Category | Score |
421
+ |---------------|-------|
422
+ | Structure | 15 |
423
+ | Content | 20 |
424
+ | Language | 25 |
425
+ | Style | 30 |
426
+ | Communication | 25 |
427
+ | Filler | 20 |
428
+
429
+ ### ์ตœ์ข…๋ณธ
430
+ {claude์˜ humanize ๊ฒฐ๊ณผ ์ „์ฒด ํ…์ŠคํŠธ}
431
+
432
+ <details>
433
+ <summary>gemini ๊ฒฐ๊ณผ (AI Score: 31)</summary>
434
+
435
+ {gemini์˜ humanize ๊ฒฐ๊ณผ ์ „์ฒด ํ…์ŠคํŠธ}
436
+ </details>
437
+ ```
438
+
439
+ ๋‹จ์ผ ๋ชจ๋ธ๋งŒ ์„ฑ๊ณตํ•œ ๊ฒฝ์šฐ, ํ•ด๋‹น ๊ฒฐ๊ณผ๋ฅผ ์ตœ์ข…๋ณธ์œผ๋กœ ์ œ์‹œํ•˜๋˜ "๋‹จ์ผ ๋ชจ๋ธ๋งŒ ์„ฑ๊ณตํ•˜์—ฌ ๋น„๊ต ๋ถˆ๊ฐ€" ๊ฒฝ๊ณ ๋ฅผ ํ‘œ์‹œํ•œ๋‹ค.
440
+
441
+ ---
442
+
443
+ ## ์ฐธ๊ณ 
444
+
445
+ - ์ด ์Šคํ‚ฌ์€ ๊ธฐ์กด `/patina` ์Šคํ‚ฌ์˜ ํ™•์žฅ ๋ฒ„์ „์œผ๋กœ, ๋™์ผํ•œ ํŒจํ„ด ํŒฉ๊ณผ ํ”„๋กœํ•„์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค
446
+ - ๋ชจ๋ธ ์ถ”๊ฐ€/์ œ๊ฑฐ๋Š” `.patina.default.yaml`์˜ `max-models` ๋˜๋Š” `--models` ํ”Œ๋ž˜๊ทธ๋กœ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค
447
+ - ์ง€์› ๋ชจ๋ธ: `claude`, `codex`, `gemini` (Claude/Codex๋Š” stdin pipe, Gemini๋Š” `$(cat file)` ์ธ์ž ์น˜ํ™˜)
448
+ - ๋””์ŠคํŒจ์น˜ ๋ชจ๋“œ: `omc` (tmux pane ๋ณ‘๋ ฌ, ๊ธฐ๋ณธ) / `direct` (์ˆœ์ฐจ ์‹คํ–‰, fallback)
449
+ - ๊ฐ ์‹คํ–‰์€ ๊ณ ์œ  temp dir๋ฅผ ์‚ฌ์šฉํ•˜๋ฉฐ, ์„ ํƒ๋œ ๋ชจ๋ธ๋งŒ ๊ธฐ๋‹ค๋ฆฌ๊ณ , timeout ๋ชจ๋ธ์€ ์ž๋™์œผ๋กœ `failed` ์ฒ˜๋ฆฌํ•œ๋‹ค
450
+ - ์ตœ์ดˆ ์‹คํ–‰ ์‹œ ์„ค์น˜ ์ธํ„ฐ๋ทฐ๋กœ `.patina.yaml` ์ƒ์„ฑ (๋ชจ๋ธ ์„ ํƒ, ๋””์ŠคํŒจ์น˜ ๋ชจ๋“œ, CLI ์„ค์น˜ ํ™•์ธ)
451
+ - `--ouroboros`์™€ ํ•จ๊ป˜ ์‚ฌ์šฉ ๊ฐ€๋Šฅ: ์ตœ๊ณ  ์ ์ˆ˜๊ฐ€ target-score ์ด์ƒ์ด๋ฉด ํ•ด๋‹น ๋ชจ๋ธ ๊ฒฐ๊ณผ๋ฅผ ์ž…๋ ฅ์œผ๋กœ ์žฌ์‹คํ–‰ํ•˜์—ฌ ์ ์ˆ˜๋ฅผ ์ˆ˜๋ ด์‹œํ‚จ๋‹ค
452
+
453
+ ## ํ†ค ์ „ํŒŒ (v3.10)
454
+
455
+ MAX mode์—์„œ ํ†ค ํ•ด์„์€ SKILL.md 1๋‹จ๊ณ„/4.5b๋‹จ๊ณ„์™€ ๋™์ผํ•˜๊ฒŒ ์ฒ˜๋ฆฌ๋œ๋‹ค. 1๋‹จ๊ณ„์—์„œ resolved_tone, tone_source, tone_evidence, tone_confidence๋ฅผ ๊ฒฐ์ •ํ•œ ๋’ค, ์›Œ์ปค ํ”„๋กฌํ”„ํŠธ(4๋‹จ๊ณ„์—์„œ ๊ฐ ๋ชจ๋ธ์— ์ „๋‹ฌํ•˜๋Š” ์ธ๋ผ์ธ ํ”„๋กฌํ”„ํŠธ)์— `<tone-context>` ๋ธ”๋ก์œผ๋กœ ํฌํ•จํ•œ๋‹ค. ๋ชจ๋“  ๋””์ŠคํŒจ์น˜ ๋ชจ๋ธ(claude, gemini, codex)์€ ๋™์ผํ•œ ํ†ค ์ปจํ…์ŠคํŠธ๋ฅผ ๋ฐ›์•„ ์ผ๊ด€๋œ ๋ชฉ์†Œ๋ฆฌ๋กœ humanize๋ฅผ ์ˆ˜ํ–‰ํ•œ๋‹ค. ์ตœ์ข… ์„ ํƒ๋œ ๊ฒฐ๊ณผ์˜ YAML footer์—๋Š” SKILL.md 6๋‹จ๊ณ„ ๊ทœ์น™๊ณผ ๋™์ผํ•˜๊ฒŒ tone ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ๊ฐ€ ํฌํ•จ๋œ๋‹ค.