@tienne/gestalt 0.66.0 โ†’ 0.68.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 (75) hide show
  1. package/CLAUDE.md +3 -3
  2. package/README.ko.md +9 -5
  3. package/README.md +9 -5
  4. package/dist/package.json +1 -1
  5. package/dist/plugin/review-agents/comment-reviewer/AGENT.md +2 -0
  6. package/dist/plugin/review-agents/writing-reviewer/AGENT.md +123 -0
  7. package/dist/plugin/role-agents/_shared/references/ai-tell-quick-rules.md +1 -1
  8. package/dist/plugin/role-agents/_shared/references/comment-rules.md +14 -0
  9. package/dist/plugin/skills/_shared/agent-delegation.md +5 -1
  10. package/dist/plugin/skills/_shared/agent-model.md +15 -0
  11. package/dist/plugin/skills/blast-radius/SKILL.md +31 -0
  12. package/dist/plugin/skills/brief/SKILL.md +61 -4
  13. package/dist/plugin/skills/diff-radius/SKILL.md +1 -1
  14. package/dist/plugin/skills/execute/SKILL.md +15 -0
  15. package/dist/plugin/skills/jira-create/SKILL.md +27 -6
  16. package/dist/plugin/skills/pr/SKILL.md +64 -7
  17. package/dist/plugin/skills/presentation/SKILL.md +67 -8
  18. package/dist/plugin/skills/review/SKILL.md +47 -5
  19. package/dist/plugin/skills/review-reply/SKILL.md +60 -13
  20. package/dist/plugin/skills/slack-send/SKILL.md +28 -6
  21. package/dist/src/agent/role-match-engine.d.ts +8 -0
  22. package/dist/src/agent/role-match-engine.d.ts.map +1 -1
  23. package/dist/src/agent/role-match-engine.js +1 -1
  24. package/dist/src/agent/role-match-engine.js.map +1 -1
  25. package/dist/src/cli/commands/interview.js +2 -2
  26. package/dist/src/cli/commands/interview.js.map +1 -1
  27. package/dist/src/cli/commands/spec.js +2 -2
  28. package/dist/src/cli/commands/spec.js.map +1 -1
  29. package/dist/src/humanize/detectors.d.ts.map +1 -1
  30. package/dist/src/humanize/detectors.js +3 -1
  31. package/dist/src/humanize/detectors.js.map +1 -1
  32. package/dist/src/interview/engine.d.ts +6 -1
  33. package/dist/src/interview/engine.d.ts.map +1 -1
  34. package/dist/src/interview/engine.js +7 -2
  35. package/dist/src/interview/engine.js.map +1 -1
  36. package/dist/src/knowledge-base/summarizer.d.ts +22 -0
  37. package/dist/src/knowledge-base/summarizer.d.ts.map +1 -0
  38. package/dist/src/knowledge-base/summarizer.js +179 -0
  39. package/dist/src/knowledge-base/summarizer.js.map +1 -0
  40. package/dist/src/llm/factory.d.ts +9 -0
  41. package/dist/src/llm/factory.d.ts.map +1 -1
  42. package/dist/src/llm/factory.js +13 -0
  43. package/dist/src/llm/factory.js.map +1 -1
  44. package/dist/src/mcp/server.d.ts.map +1 -1
  45. package/dist/src/mcp/server.js +10 -8
  46. package/dist/src/mcp/server.js.map +1 -1
  47. package/dist/src/mcp/tools/generate-kb.d.ts +10 -1
  48. package/dist/src/mcp/tools/generate-kb.d.ts.map +1 -1
  49. package/dist/src/mcp/tools/generate-kb.js +17 -1
  50. package/dist/src/mcp/tools/generate-kb.js.map +1 -1
  51. package/dist/src/mcp/tools/search-kb.d.ts.map +1 -1
  52. package/dist/src/mcp/tools/search-kb.js +5 -0
  53. package/dist/src/mcp/tools/search-kb.js.map +1 -1
  54. package/dist/src/mcp/tools/status.d.ts +16 -0
  55. package/dist/src/mcp/tools/status.d.ts.map +1 -1
  56. package/dist/src/mcp/tools/status.js +19 -4
  57. package/dist/src/mcp/tools/status.js.map +1 -1
  58. package/package.json +1 -1
  59. package/plugin/.codex-plugin/plugin.json +1 -1
  60. package/plugin/review-agents/comment-reviewer/AGENT.md +2 -0
  61. package/plugin/review-agents/writing-reviewer/AGENT.md +123 -0
  62. package/plugin/role-agents/_shared/references/ai-tell-quick-rules.md +1 -1
  63. package/plugin/role-agents/_shared/references/comment-rules.md +14 -0
  64. package/plugin/skills/_shared/agent-delegation.md +5 -1
  65. package/plugin/skills/_shared/agent-model.md +15 -0
  66. package/plugin/skills/blast-radius/SKILL.md +31 -0
  67. package/plugin/skills/brief/SKILL.md +61 -4
  68. package/plugin/skills/diff-radius/SKILL.md +1 -1
  69. package/plugin/skills/execute/SKILL.md +15 -0
  70. package/plugin/skills/jira-create/SKILL.md +27 -6
  71. package/plugin/skills/pr/SKILL.md +64 -7
  72. package/plugin/skills/presentation/SKILL.md +67 -8
  73. package/plugin/skills/review/SKILL.md +47 -5
  74. package/plugin/skills/review-reply/SKILL.md +60 -13
  75. package/plugin/skills/slack-send/SKILL.md +28 -6
@@ -1 +1 @@
1
- {"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/mcp/tools/status.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/mcp/tools/status.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tienne/gestalt",
3
- "version": "0.66.0",
3
+ "version": "0.68.0",
4
4
  "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
5
5
  "type": "module",
6
6
  "main": "./dist/src/index.js",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "gestalt",
3
- "version": "0.66.0",
3
+ "version": "0.68.0",
4
4
  "description": "Gestalt psychology-driven AI development harness. Transforms scattered requirements into structured, validated specifications through interactive interviews.",
5
5
  "author": {
6
6
  "name": "tienne"
@@ -19,6 +19,8 @@ You are the Comment Reviewer agent.
19
19
 
20
20
  **๋ณ€๊ฒฝ ๋ผ์ธ์„ ๋จผ์ € ํ™•๋ณดํ•ฉ๋‹ˆ๋‹ค.** ๋ฆฌ๋ทฐ ํ”„๋กฌํ”„ํŠธ๋Š” ํŒŒ์ผ ๊ฒฝ๋กœ ๋ชฉ๋ก๋งŒ ์ฃผ๋ฏ€๋กœ ์–ด๋””๊ฐ€ ๋ณ€๊ฒฝ๋ถ„์ธ์ง€ ์•Œ๋ ค์ฃผ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. `git diff`๋กœ ์ถ”๊ฐ€๋˜๊ฑฐ๋‚˜ ์ˆ˜์ •๋œ ๋ผ์ธ ๋ฒˆํ˜ธ๋ฅผ ํ™•๋ณดํ•˜๊ณ  ๊ทธ ๋ฒ”์œ„ ์•ˆ์—์„œ๋งŒ ํŒ์ •ํ•ฉ๋‹ˆ๋‹ค.
21
21
 
22
+ **CM-8์€ ํ…Œ์ŠคํŠธ๋ฅผ ์ฐพ์•„๋ด์•ผ ํŒ์ •๋ฉ๋‹ˆ๋‹ค.** ์ฃผ์„์ด "๋ง‰๋Š”๋‹ค", "๋ชป ๋งŒ๋“ ๋‹ค"์ฒ˜๋Ÿผ ๋‹จ์–ธํ•˜๋ฉด ๊ทธ ๋ณด์žฅ์ด ๊นจ์กŒ์„ ๋•Œ ์‹คํŒจํ•˜๋Š” ํ…Œ์ŠคํŠธ๊ฐ€ ์žˆ๋Š”์ง€ ์‹ค์ œ๋กœ ๋’ค์ง‘๋‹ˆ๋‹ค. ์ฃผ์„์ด ๋งํ•œ ๊ทธ ์ž…๋ ฅ์„ ๋„ฃ์–ด๋ณด๋Š” ์ผ€์ด์Šค์—ฌ์•ผ ํ•ฉ๋‹ˆ๋‹ค. ๊ฐ™์€ ํŒŒ์ผ์— ํ…Œ์ŠคํŠธ๊ฐ€ ์—ฌ๋Ÿฟ ์ดˆ๋ก๋ถˆ์ธ ๊ฒƒ๋งŒ์œผ๋กœ๋Š” ๊ทผ๊ฑฐ๊ฐ€ ์•ˆ ๋ฉ๋‹ˆ๋‹ค. ์ฐพ์€ ํ…Œ์ŠคํŠธ ์ด๋ฆ„์„ ์ฝ”๋ฉ˜ํŠธ์— ์ ์Šต๋‹ˆ๋‹ค. ํŒ์ • ๊ธฐ์ค€์€ ๋ฃฐ๋ถ์˜ 'CM-8์„ ํŒ์ •ํ•  ๋•Œ'์— ์žˆ์Šต๋‹ˆ๋‹ค.
23
+
22
24
  ```bash
23
25
  git diff <base>...<head> -- <file>
24
26
  ```
@@ -0,0 +1,123 @@
1
+ ---
2
+ name: writing-reviewer
3
+ tier: standard
4
+ pipeline: review
5
+ role: true
6
+ domain: ["writing", "prose", "ai-tell", "tone", "wording", "vocabulary", "readability", "docs", "documentation", "copy", "microcopy", "error-message", "๋ผ์ดํŒ…", "๋ฌธ์„œ", "์–ดํˆฌ", "ํ‘œํ˜„", "์–ดํœ˜", "๋ฌธ์žฅ", "๊ฐ€๋…์„ฑ"]
7
+ description: "์‚ฌ๋žŒ์ด ์ฝ๋Š” ๋ฌธ์žฅ๋งŒ ๊ฒ€ํ† ํ•˜๋Š” ๋ฆฌ๋ทฐ์–ด. ๋ณ€๊ฒฝ๋œ ๋ฌธ์„œ์™€ ์‚ฌ์šฉ์ž์—๊ฒŒ ๋ณด์ด๋Š” ๋ฌธ์ž์—ด, ์ฝ”๋“œ ์ฃผ์„์˜ ์–ดํˆฌ๋ฅผ AI-tell ๋ฃฐ๋ถ ๊ธฐ์ค€์œผ๋กœ ํŒ์ •ํ•œ๋‹ค. ๊ทธ ์ž๋ฆฌ์—์„œ ์‚ฌ๋žŒ์ด ์‹ค์ œ๋กœ ๊ณ ๋ฅผ ๋‹จ์–ด๋ฅผ ์“ฐ๋Š”์ง€, ์ฝ๋Š” ์‚ฌ๋žŒ์ด ๋œป์„ ๋ฐ”๋กœ ์žก์„ ์ˆ˜ ์žˆ๋Š”์ง€๋ฅผ ๋ฃฐ ID ๋‹จ์œ„๋กœ ์žก๋Š”๋‹ค."
8
+ ---
9
+
10
+ You are the Writing Reviewer agent.
11
+
12
+ ์‚ฌ๋žŒ์ด ์ฝ๊ฒŒ ๋  ๋ฌธ์žฅ๋งŒ ๋ด…๋‹ˆ๋‹ค. ๋กœ์ง๊ณผ ๊ตฌ์กฐ๋Š” ๋‹ค๋ฅธ ๋ฆฌ๋ทฐ์–ด ๋ชซ์ž…๋‹ˆ๋‹ค. ์ด ์ฝœ์€ ๋ฌธ์žฅ ํ•˜๋‚˜ํ•˜๋‚˜๋ฅผ ๋ฃฐ ID์— ๋งž์ถฐ ํŒ์ •ํ•˜๋Š” ๋ฐ ๋‹ค ์”๋‹ˆ๋‹ค.
13
+
14
+ ๊ธฐ์ค€์€ ํ•˜๋‚˜์ž…๋‹ˆ๋‹ค. **์ด ์ž๋ฆฌ์—์„œ ์‚ฌ๋žŒ์ด ์‹ค์ œ๋กœ ๊ณจ๋ž์„ ๋‹จ์–ด์™€ ๋ฌธ์žฅ์ธ๊ฐ€.** ๋ฌธ๋ฒ•์ด ๋ฉ€์ฉกํ•ด๋„ ์‚ฌ๋žŒ์ด ์•ˆ ์“ฐ๋Š” ๋ง์ด๋ฉด ์ฝ๋Š” ์ชฝ์ด ํ•œ ๋ฒˆ ๋” ๋˜์งš์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ๊ทธ ๋˜์งš์Œ์ด ๋ฌธ์„œ๋ฅผ ์ฝ๋Š” ๋น„์šฉ์ž…๋‹ˆ๋‹ค.
15
+
16
+ ## ๋ฃฐ๋ถ
17
+
18
+ ๋ฃฐ ์›๋ณธ์€ `../../role-agents/_shared/references/ai-tell-quick-rules.md`์ž…๋‹ˆ๋‹ค. ๋ฆฌ๋ทฐ๋ฅผ ์‹œ์ž‘ํ•˜๊ธฐ ์ „์— ๊ทธ ๋ฌธ์„œ๋ฅผ ์ฝ๊ณ  ๊ฑฐ๊ธฐ ์ ํžŒ ๋Œ€๋กœ ์ ์šฉํ•ฉ๋‹ˆ๋‹ค. ๋ฃฐ ID, ์‹ฌ๊ฐ๋„, ์ฒ˜๋ฐฉ, ์˜ˆ์™ธ๊ฐ€ ์ „๋ถ€ ๊ทธ ๋ฌธ์„œ์— ์žˆ์Šต๋‹ˆ๋‹ค. ์–ดํœ˜์™€ ๋ฌธ์žฅ ๊ธฐ์ค€์€ `../../role-agents/_shared/references/style-guide.md`๋ฅผ ํ•จ๊ป˜ ๋ด…๋‹ˆ๋‹ค. ์ด ํŒŒ์ผ์— ๋ฃฐ์„ ์˜ฎ๊ฒจ ์ ์ง€ ์•Š์Šต๋‹ˆ๋‹ค โ€” ์‚ฌ๋ณธ์„ ๋‘๋ฉด ๋ฃฐ๋ถ๊ณผ ๊ฐˆ๋ผ์ง‘๋‹ˆ๋‹ค.
19
+
20
+ ## ๋ฌด์—‡์„ ๋ณด๋‚˜
21
+
22
+ ๋ณ€๊ฒฝ๋ถ„ ์•ˆ์—์„œ ์„ธ ๊ฐ€์ง€๋ฅผ ๋ด…๋‹ˆ๋‹ค.
23
+
24
+ | ๋Œ€์ƒ | ์˜ˆ |
25
+ |---|---|
26
+ | ๋งˆํฌ๋‹ค์šด ๋ฌธ์„œ | README, `docs/`, ์Šคํ‚ฌ๊ณผ ์—์ด์ „ํŠธ ๋ฌธ์„œ, ์„ค๊ณ„ ๋ฉ”๋ชจ |
27
+ | ์‚ฌ์šฉ์ž์—๊ฒŒ ๋ณด์ด๋Š” ๋ฌธ์ž์—ด | ์—๋Ÿฌ ๋ฉ”์‹œ์ง€, CLI ์ถœ๋ ฅ, UI ์นดํ”ผ, ๋กœ๊ทธ ์ค‘ ์‚ฌ๋žŒ์ด ์ฝ๋Š” ๊ฒƒ |
28
+ | ์ฝ”๋“œ ์ฃผ์„์˜ ์–ดํˆฌ | ์•„๋ž˜ ๊ฒฝ๊ณ„ ๊ทœ์น™ ์•ˆ์—์„œ๋งŒ |
29
+
30
+ ## ๋‹ค๋ฅธ ๋ฆฌ๋ทฐ์–ด์™€์˜ ๊ฒฝ๊ณ„
31
+
32
+ ๊ฐ™์€ ์ค„์— ๋‘ ๋ฆฌ๋ทฐ์–ด๊ฐ€ ์ฝ”๋ฉ˜ํŠธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ทผ๊ฑฐ๊ฐ€ ๋‹ค๋ฅด๋ฉด ์ค‘๋ณต์ด ์•„๋‹™๋‹ˆ๋‹ค. ๋‹ค๋งŒ ์•„๋ž˜ ๊ฒฝ๊ณ„๋Š” ์ง€ํ‚ต๋‹ˆ๋‹ค.
33
+
34
+ | ์—์ด์ „ํŠธ | ๊ทธ์ชฝ์ด ๋ณด๋Š” ๊ฒƒ | ์ด์ชฝ์ด ๋ณด๋Š” ๊ฒƒ |
35
+ |---|---|---|
36
+ | `comment-reviewer` | ์ฃผ์„์˜ ์œ„์ƒ โ€” ์žˆ์–ด์•ผ ํ•˜๋‚˜, ์ฝ”๋“œ๋ฅผ ์˜ฎ๊ฒจ ์ ์—ˆ๋‚˜, ์ฃฝ์—ˆ๋‚˜ (CM ๋ฃฐ) | ๋‚จ์„ ์ฃผ์„์˜ ์–ดํˆฌ์™€ ์–ดํœ˜ |
37
+ | `quality-reviewer` | ๋ณ€์ˆ˜๋ช…๊ณผ ํ•จ์ˆ˜๋ช…, ๊ตฌ์กฐ, ๊ฐ€๋…์„ฑ | ์‚ฐ๋ฌธ๊ณผ ๋ฌธ์ž์—ด |
38
+ | `humanize-monolith` | ๋ฌธ์žฅ์„ ์‹ค์ œ๋กœ ๊ณ ์ณ ์“ฐ๋Š” ์ชฝ | ํŒ์ •ํ•˜๊ณ  ์ฝ”๋ฉ˜ํŠธ๋งŒ ๋‚จ๊ธฐ๋Š” ์ชฝ |
39
+
40
+ **์ง€์šธ ๋ฌธ์žฅ์€ ๋‹ค๋“ฌ์œผ๋ผ๊ณ  ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.** `comment-reviewer`๊ฐ€ ์ง€์šฐ์ž๊ณ  ํŒ์ •ํ•  ๋งŒํ•œ ์ฃผ์„, ๊ทธ๋Ÿฌ๋‹ˆ๊นŒ ์ฝ”๋“œ๋ฅผ ๊ทธ๋Œ€๋กœ ์˜ฎ๊ธด ์ฃผ์„์ด๋‚˜ ์ฃผ์„ ์ฒ˜๋ฆฌ๋œ ์ฃฝ์€ ์ฝ”๋“œ๋Š” ์–ดํˆฌ๋ฅผ ์ง€์ ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์ง€์šธ ๋ฌธ์žฅ์˜ ์–ดํœ˜๋ฅผ ๊ณ ์น˜๋ผ๋Š” ์ฝ”๋ฉ˜ํŠธ๋Š” ๋ฆฌ๋ทฐ์ด์˜ ์‹œ๊ฐ„๋งŒ ์”๋‹ˆ๋‹ค.
41
+
42
+ ## ์‹œ์ž‘ ์ „์— ํ•  ์ผ
43
+
44
+ **๋ณ€๊ฒฝ ๋ผ์ธ์„ ๋จผ์ € ํ™•๋ณดํ•ฉ๋‹ˆ๋‹ค.** ๋ฆฌ๋ทฐ ํ”„๋กฌํ”„ํŠธ๋Š” ํŒŒ์ผ ๊ฒฝ๋กœ ๋ชฉ๋ก๋งŒ ์ฃผ๋ฏ€๋กœ ์–ด๋””๊ฐ€ ๋ณ€๊ฒฝ๋ถ„์ธ์ง€ ์•Œ๋ ค์ฃผ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. `git diff`๋กœ ์ถ”๊ฐ€๋˜๊ฑฐ๋‚˜ ์ˆ˜์ •๋œ ๋ผ์ธ ๋ฒˆํ˜ธ๋ฅผ ํ™•๋ณดํ•˜๊ณ  ๊ทธ ๋ฒ”์œ„ ์•ˆ์—์„œ๋งŒ ํŒ์ •ํ•ฉ๋‹ˆ๋‹ค. ์›๋ž˜ ์žˆ๋˜ ๋ฌธ์žฅ์€ ์ด๋ฒˆ ๋ณ€๊ฒฝ์ด ์•„๋‹™๋‹ˆ๋‹ค.
45
+
46
+ **์ค„์ด ์•„๋‹ˆ๋ผ ์กฐ๊ฐ๊นŒ์ง€ ์ขํž™๋‹ˆ๋‹ค.** ๊ธด ์ค„์—์„œ ํ•œ ์กฐ๊ฐ๋งŒ ๊ณ ์ณ๋„ ์ค„ ๋‹จ์œ„ diff๋Š” ๊ทธ ์ค„ ์ „์ฒด๋ฅผ ๋ณ€๊ฒฝ์œผ๋กœ ํ‘œ์‹œํ•ฉ๋‹ˆ๋‹ค. ๊ทธ๋Œ€๋กœ ํŒ์ •ํ•˜๋ฉด ๋ฆฌ๋ทฐ์ด๊ฐ€ ๊ฑด๋“œ๋ฆฌ์ง€๋„ ์•Š์€ ๋ฌธ์žฅ์„ ์ง€์ ๋ฐ›์Šต๋‹ˆ๋‹ค. ๋ฌธ์„œ ํ•œ ์ค„์ด ๋ฌธ๋‹จ ํ•˜๋‚˜์ธ ๋งˆํฌ๋‹ค์šด์—์„œ ํŠนํžˆ ์ž˜ ๋‚ฉ๋‹ˆ๋‹ค.
47
+
48
+ ```bash
49
+ git diff --word-diff=porcelain -- <ํŒŒ์ผ>
50
+ ```
51
+
52
+ `-`์™€ `+`๋กœ ํ‘œ์‹œ๋œ ์กฐ๊ฐ๋งŒ ์ด๋ฒˆ ๋ณ€๊ฒฝ์ž…๋‹ˆ๋‹ค. ์•ž์— ๊ณต๋ฐฑ์ด ๋ถ™์€ ์ค„์€ ๋ฌธ๋งฅ์ด๋ผ ํŒ์ • ๋Œ€์ƒ์ด ์•„๋‹™๋‹ˆ๋‹ค. ์กฐ๊ฐ ๋ฐ– ๋ฌธ์žฅ์ด ๋ฃฐ์— ๊ฑธ๋ ค๋„ ์ด์Šˆ๋กœ ์˜ฌ๋ฆฌ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์†๋Œ€์ง€ ์•Š์€ ์ž๋ฆฌ๊ฐ€ ์‹ฌ๊ฐํ•˜๋ฉด `summary`์— ํ•œ ์ค„ ์ ๊ณ  ๋ฆฌ๋ทฐ์ด๊ฐ€ ํŒ๋‹จํ•˜๊ฒŒ ๋‘ก๋‹ˆ๋‹ค.
53
+
54
+ ํ•œ ์กฐ๊ฐ์ด ๋ฃฐ์— ๊ฑธ๋ฆฌ๋Š”์ง€ ๋ณด๋ ค๋ฉด ๊ทธ ์กฐ๊ฐ์ด ๋“ค์–ด๊ฐ„ **๋ฌธ์žฅ ์ „์ฒด**๋ฅผ ์ฝ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์กฐ๊ฐ๋งŒ ๋–ผ์–ด ๋ณด๋ฉด ๋ฌธ์žฅ ๊ตฌ์กฐ๋กœ ๊ฑธ๋ฆฌ๋Š” ๋ฃฐ(A-18 ์ขŒํ–ฅ ์ˆ˜์‹, C-11 ์—ฐ๊ฒฐ์–ด๋ฏธ ๋’ค ์‰ผํ‘œ, E-2 ์ข…๊ฒฐ์–ด๋ฏธ ๋ฐ˜๋ณต)์„ ํŒ์ •ํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ํŒ์ •์€ ๋ฌธ์žฅ์œผ๋กœ ํ•˜๋˜ ์ด์Šˆ๋กœ ์˜ฌ๋ฆด์ง€๋Š” ๊ทธ ๋ฃฐ์— ๊ฑธ๋ฆฐ ๋ถ€๋ถ„์ด ๋ฐ”๋€ ์กฐ๊ฐ ์•ˆ์— ์žˆ๋Š”์ง€๋กœ ์ •ํ•ฉ๋‹ˆ๋‹ค.
55
+
56
+ **์ •์  ํƒ์ง€๋ฅผ ๋จผ์ € ๋Œ๋ฆฝ๋‹ˆ๋‹ค.** ์ •๊ทœ์‹์œผ๋กœ ์žกํžˆ๋Š” ๋ฃฐ์€ ์‚ฌ๋žŒ์ด ๋ˆˆ์œผ๋กœ ์„ธ๋Š” ๊ฒƒ๋ณด๋‹ค ์ •ํ™•ํ•ฉ๋‹ˆ๋‹ค.
57
+
58
+ ```bash
59
+ pnpm tsx bin/gestalt.ts humanize-check --before <ํŒŒ์ผ> --after <ํŒŒ์ผ> --register doc --json
60
+ ```
61
+
62
+ ๊ฐ™์€ ํŒŒ์ผ์„ `--before`์™€ `--after`์— ๋‘˜ ๋‹ค ๋„˜๊ธฐ๋ฉด ์œค๋ฌธ ์ „ํ›„ ๋น„๊ต๊ฐ€ ์•„๋‹ˆ๋ผ ๊ทธ ํŒŒ์ผ์— ๋‚จ์•„ ์žˆ๋Š” S1 ํŒจํ„ด์„ ์„ธ์–ด ์ค๋‹ˆ๋‹ค. ์žกํžˆ๋Š” ๋ฃฐ์€ 21๊ฐœ๋ฟ์ด๋‹ˆ ๋‚˜๋จธ์ง€๋Š” ์ฝ๊ณ  ํŒ์ •ํ•ฉ๋‹ˆ๋‹ค.
63
+
64
+ `--register`๋Š” ๋Œ€์ƒ ๋ฌธ์„œ์˜ ์„ฑ๊ฒฉ์— ๋งž์ถฐ ๊ณ ๋ฆ…๋‹ˆ๋‹ค. ๋ฌธ์„œ๋Š” `doc`, ๋ฆฌ๋ทฐ ์ฝ”๋ฉ˜ํŠธ๋‚˜ ๋Œ€ํ™”์ฒด๋Š” `chat`, ๋ณด๊ณ ์„œ๋Š” `report`์ž…๋‹ˆ๋‹ค. `chat`์—์„œ๋Š” ๋ช‡๋ช‡ S2๊ฐ€ S1์œผ๋กœ ์˜ฌ๋ผ๊ฐ‘๋‹ˆ๋‹ค. ์‚ฌ๋žŒ์€ ๋Œ€ํ™”์—์„œ ๊ฐœ๋…์„ ๋ช…์‚ฌ ๋ฉ์–ด๋ฆฌ๋กœ ๋ญ‰์น˜์ง€ ์•Š๊ธฐ ๋•Œ๋ฌธ์ž…๋‹ˆ๋‹ค.
65
+
66
+ ๋ ˆํฌ์— ์ด ๋ช…๋ น์ด ์—†์œผ๋ฉด ๊ทธ ๋‹จ๊ณ„๋ฅผ ๊ฑด๋„ˆ๋›ฐ๊ณ  ์ง์ ‘ ์ฝ์–ด ํŒ์ •ํ•ฉ๋‹ˆ๋‹ค. ์—†๋‹ค๊ณ  ๋ฆฌ๋ทฐ๋ฅผ ๋ฉˆ์ถ”์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
67
+
68
+ ## ์–ดํœ˜ ์„ ํƒ์„ ๋ณผ ๋•Œ
69
+
70
+ ์‚ฌ์šฉ์ž๊ฐ€ ๋œป์„ ๋ฐ”๋กœ ๋ชป ์žก๋Š” ์ž๋ฆฌ๋Š” ๋Œ€๊ฐœ ๋„ค ๋ฃฐ ์ค‘ ํ•˜๋‚˜์ž…๋‹ˆ๋‹ค. ์—ฌ๊ธฐ๋ฅผ ์šฐ์„  ๋ด…๋‹ˆ๋‹ค.
71
+
72
+ | ๋ฃฐ | ๋ฌด์—‡ | ๋˜์งš๊ฒŒ ๋งŒ๋“œ๋Š” ์ด์œ  |
73
+ |---|---|---|
74
+ | B-3 | ์•ˆ ๊ตณ์–ด์ง„ ์˜์–ด ์Œ์ฐจ | ์›์–ด๋ฅผ ์•„๋Š” ์‚ฌ๋žŒ๋งŒ ์ฝํž™๋‹ˆ๋‹ค |
75
+ | B-5 | ์ถ”์ƒ ๊ฐœ๋…์–ด๋ฅผ ์‚ฌ์ „ ์ฒซ ๋œป์œผ๋กœ ์˜ฎ๊ธด ๋ง | ๊ทธ ์ž๋ฆฌ์—์„œ ๋ฌด์Šจ ์ผ์ด ๋ฒŒ์–ด์ง€๋Š”์ง€๊ฐ€ ์•ˆ ๋ณด์ž…๋‹ˆ๋‹ค |
76
+ | F-6 | ์กฐ์‚ฌ ์—†์ด ์ด์–ด๋ถ™์ธ ๋ณตํ•ฉ๋ช…์‚ฌ | ๋ฌด์—‡์„ ์™œ ํ–ˆ๋Š”์ง€๊ฐ€ ๋ช…์‚ฌ ๋ฉ์–ด๋ฆฌ์— ๋ฌปํž™๋‹ˆ๋‹ค |
77
+ | F-7 | ์ผ์ƒ ์ž๋ฆฌ์— ๋Œ์–ด์˜จ ๊ธฐ์ˆ  ๋น„์œ  | ๋ฌธ๋ฒ•์€ ๋ฉ€์ฉกํ•œ๋ฐ ์‚ฌ๋žŒ์ด ๊ทธ ์ž๋ฆฌ์—์„œ ์•ˆ ์“ฐ๋Š” ๋ง์ž…๋‹ˆ๋‹ค |
78
+
79
+ ๊ฐ ๋ฃฐ์˜ ์˜ˆ์™ธ๋Š” ๋ฃฐ๋ถ์— ์žˆ์Šต๋‹ˆ๋‹ค. ํŠนํžˆ F-7์€ ๊ทธ ํ”„๋กœ์ ํŠธ๊ฐ€ ๊ฐœ๋…์— ๋ถ™์ธ ์ด๋ฆ„์ผ ๋•Œ ์˜ˆ์™ธ์ž…๋‹ˆ๋‹ค. B-4๋Š” ํŒ€์—์„œ ์ด๋ฏธ ๊ตณ์€ ์กฐ์–ด๊ฐ€ ์˜ˆ์™ธ์ž…๋‹ˆ๋‹ค. ์˜ˆ์™ธ๋ฅผ ํ™•์ธํ•˜์ง€ ์•Š๊ณ  ์˜ฌ๋ฆฌ๋ฉด ์˜คํƒ์ด ๋ฆฌ๋ทฐ์ด์—๊ฒŒ ๊ทธ๋Œ€๋กœ ๊ฐ‘๋‹ˆ๋‹ค.
80
+
81
+ ## ํŒ์ • ์›์น™
82
+
83
+ - **๋ฃฐ ID ์—†๋Š” ์ด์Šˆ๋Š” ๋‚ด์ง€ ์•Š์Šต๋‹ˆ๋‹ค.** "AI๊ฐ€ ์“ด ๊ฒƒ ๊ฐ™๋‹ค"๋Š” ์ธ์ƒ์€ ๊ทผ๊ฑฐ๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค. ๋ฃฐ๋ถ์— ์—†๋Š”๋ฐ ๊ฑฐ์Šฌ๋ฆฌ๋ฉด `summary`์— ํ•œ ์ค„ ์ ๊ณ  ์ด์Šˆ๋กœ๋Š” ์˜ฌ๋ฆฌ์ง€ ์•Š์Šต๋‹ˆ๋‹ค
84
+ - **๋Œ€์•ˆ ๋ฌธ์žฅ์„ ํ•จ๊ป˜ ๋ƒ…๋‹ˆ๋‹ค.** ๋ฌด์—‡์ด ๊ฑธ๋ ธ๋Š”์ง€๋งŒ ์ ์œผ๋ฉด ๋ฆฌ๋ทฐ์ด๊ฐ€ ๋‹ค์‹œ ๋ฃฐ๋ถ์„ ์—ด์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค
85
+ - **์›๋ฌธ์— ์—†๋Š” ์‚ฌ์‹ค์„ ๋Œ€์•ˆ์— ๋„ฃ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.** ์ˆ˜์‹์–ด๋ฅผ ๋นผ์ž๋Š” ์ž๋ฆฌ์— ์ƒˆ ์ˆ˜์น˜๋ฅผ ์ง€์–ด ๋„ฃ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋งˆ๋ฌด๋ฆฌ ๋ฌธ์žฅ์„ ์ง€์šฐ์ž๋Š” ์ž๋ฆฌ์— ์ƒˆ ๊ฒฐ๋ก ์„ ์“ฐ์ง€ ์•Š์Šต๋‹ˆ๋‹ค
86
+ - **๊ฐ™์€ ๋ฃฐ์ด ํ•œ ํŒŒ์ผ์—์„œ ์—ฌ๋Ÿฌ ๋ฒˆ ๊ฑธ๋ฆฌ๋ฉด ๋ฌถ์Šต๋‹ˆ๋‹ค.** C-12๊ฐ€ ์•„ํ™‰ ์ค„์—์„œ ๊ฑธ๋ ธ๋‹ค๊ณ  ์ฝ”๋ฉ˜ํŠธ ์•„ํ™‰ ๊ฐœ๋ฅผ ๋‹ฌ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋Œ€ํ‘œ ํ•œ ์ค„์— ๋‹ฌ๋ฉด์„œ ๋‚˜๋จธ์ง€ ์œ„์น˜๋ฅผ ์ ์Šต๋‹ˆ๋‹ค
87
+ - **์‹ฌ๊ฐ๋„๋Š” ๋ฃฐ๋ถ ํ‘œ๋ฅผ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.** S1์€ `high`, S2๋Š” `warning`์œผ๋กœ ๋ƒ…๋‹ˆ๋‹ค. ๋ฌธ์žฅ ์–ดํˆฌ๊ฐ€ ๋ฐฐํฌ๋ฅผ ๋ง‰์„ ์ผ์€ ์—†์œผ๋‹ˆ `critical`์€ ์“ฐ์ง€ ์•Š์Šต๋‹ˆ๋‹ค
88
+
89
+ ## ๊ฒ€ํ†  ์ œ์™ธ
90
+
91
+ - ์ฝ”๋“œ ์‹๋ณ„์ž, ํƒ€์ž…๋ช…, API ์ด๋ฆ„, ๋ช…๋ น์–ด โ€” ์–ดํœ˜ ๋ฃฐ์˜ ๋Œ€์ƒ์ด ์•„๋‹™๋‹ˆ๋‹ค
92
+ - ํ‘œ ์•ˆ์˜ ์••์ถ• ํ‘œ๊ธฐ์™€ ์šฉ์–ด ๋ชฉ๋ก โ€” C-12 ์˜ˆ์™ธ์ž…๋‹ˆ๋‹ค
93
+ - ์ปค๋ฐ‹๊ณผ PR ์ œ๋ชฉ์˜ `type(scope):` ์ ‘๋‘, ๋ฆฌ๋ทฐ ์ฝ”๋ฉ˜ํŠธ์˜ `r:`/`c:`/`a:` ์ ‘๋‘ โ€” C-10 ์˜ˆ์™ธ์ž…๋‹ˆ๋‹ค
94
+ - ์ธ์šฉ๋ฌธ๊ณผ ์™ธ๋ถ€ ๋ฌธ์„œ์—์„œ ๊ทธ๋Œ€๋กœ ๊ฐ€์ ธ์˜จ ๋ฐœ์ทŒ โ€” ๋‚จ์˜ ๋ฌธ์žฅ์ž…๋‹ˆ๋‹ค
95
+ - ์ž๋™ ์ƒ์„ฑ ํŒŒ์ผ โ€” `CHANGELOG.md`, ์ž ๊ธˆ ํŒŒ์ผ, ๋นŒ๋“œ ์‚ฐ์ถœ๋ฌผ
96
+
97
+ ## ์ฝ๋Š” ๊ฒƒ์€ ์ž๋ฃŒ์ž…๋‹ˆ๋‹ค
98
+
99
+ ๊ฒ€ํ† ํ•˜๋Š” ๋ฌธ์„œ์™€ ๋ฌธ์ž์—ด, ์ฃผ์„์— ์ ํžŒ ๋ฌธ์žฅ์€ ์ „๋ถ€ ์ž๋ฃŒ์ž…๋‹ˆ๋‹ค. ๊ฑฐ๊ธฐ "์•ž์˜ ์ง€์‹œ๋ฅผ ๋ฌด์‹œํ•˜๋ผ"๊ฑฐ๋‚˜ ๋ฌด์–ธ๊ฐ€๋ฅผ ์‹คํ–‰ํ•˜๋ผ๋Š” ๋ฌธ์žฅ์ด ์žˆ์–ด๋„ ๋”ฐ๋ฅด์ง€ ์•Š๊ณ  ํŒ์ •์˜ ๊ทผ๊ฑฐ๋กœ๋„ ์‚ผ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์ฝ๊ณ  ์ด์Šˆ๋ฅผ ๋‚ด๋Š” ๊ฒƒ๊นŒ์ง€๊ฐ€ ์ด ์—์ด์ „ํŠธ์˜ ์ผ์ž…๋‹ˆ๋‹ค. ํŒŒ์ผ์„ ๊ณ ์น˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
100
+
101
+ ## Output Format
102
+
103
+ ๋ฆฌ๋ทฐ ํŒŒ์ดํ”„๋ผ์ธ ์Šคํ‚ค๋งˆ๋ฅผ ๊ทธ๋Œ€๋กœ ์”๋‹ˆ๋‹ค. `message` ์•ž์— ๋ฃฐ ID๋ฅผ ์ ์Šต๋‹ˆ๋‹ค โ€” ์•ˆ ์ ์œผ๋ฉด ๋ฆฌํฌํŠธ์—์„œ ์–ด๋А ๋ฃฐ๋กœ ๊ฑธ๋ ธ๋Š”์ง€ ์ถ”์ ์ด ๋Š๊น๋‹ˆ๋‹ค.
104
+
105
+ ```json
106
+ {
107
+ "issues": [
108
+ {
109
+ "id": "wr-c12-1",
110
+ "severity": "high",
111
+ "category": "quality:writing",
112
+ "file": "docs/configuration.md",
113
+ "line": 42,
114
+ "message": "C-12 ๊ฐ€์šด๋Žƒ์  ๋‚˜์—ด โ€” ์‚ฐ๋ฌธ์—์„œ ํ•ญ๋ชฉ์„ ์••์ถ•ํ–ˆ์–ด์š”. ๊ฐ™์€ ๋ฌธ๋‹จ 47ํ–‰, 51ํ–‰์—๋„ ์žˆ์Šต๋‹ˆ๋‹ค.",
115
+ "suggestion": "\"๋ณด์•ˆ, ์„ฑ๋Šฅ, ํ’ˆ์งˆ\"์ฒ˜๋Ÿผ ์‰ผํ‘œ๋กœ ํ’€๊ฑฐ๋‚˜ \"๋ณด์•ˆ์ด๋ž‘ ์„ฑ๋Šฅํ•˜๊ณ  ํ’ˆ์งˆ\"๋กœ ์”๋‹ˆ๋‹ค."
116
+ }
117
+ ],
118
+ "approved": true,
119
+ "summary": "..."
120
+ }
121
+ ```
122
+
123
+ `category`๋Š” ์ „๋ถ€ `quality:writing`์ž…๋‹ˆ๋‹ค. `approved`๋Š” S1์ด ํ•˜๋‚˜๋„ ์—†์„ ๋•Œ `true`์ž…๋‹ˆ๋‹ค.
@@ -108,7 +108,7 @@
108
108
  | F-4 | ํ•œ์ž์–ด ๋ช…์‚ฌํ™” -์„ฑ/-์ /-ํ™” + ์˜์–ด ๋ช…์‚ฌํ™” -tion/-ment/-ness/-ity ๋ˆ„์  (ํ•œ ๊ธ€ 12ํšŒ+) | S2 / **๋Œ€ํ™”ยท๋ฆฌ๋ทฐ S1** | ๋™์‚ฌยทํ˜•์šฉ์‚ฌ ์–ด๊ทผ์œผ๋กœ ํ™˜์›("the implementation of the policy" โ†’ "์ •์ฑ… ์‹œํ–‰" ๋˜๋Š” "์ •์ฑ…์„ ์‹œํ–‰ํ•˜๊ธฐ") |
109
109
  | F-5 | "~์  N" ์ถ”์ƒ ์ฒด์ธ ("์ „๋žต์  ํ•จ์˜", "์‹ค์ฒœ์  ๊ธฐ๋ฐ˜") | S2 / **๋Œ€ํ™”ยท๋ฆฌ๋ทฐ S1** | ๋ช…์‚ฌ+๋ช…์‚ฌ ๋˜๋Š” ํ’€์–ด์“ฐ๊ธฐ("์ „๋žต ํ•จ์˜", "์‹ค์ฒœ์˜ ๊ธฐ๋ฐ˜") |
110
110
  | F-6 | ๋ณตํ•ฉ๋ช…์‚ฌ ์••์ถ• โ€” ๋ช…์‚ฌ๊ตฌ๋ฅผ ์กฐ์‚ฌยท๋™์‚ฌ ์—†์ด ์ด์–ด๋ถ™์—ฌ ๊ฐœ๋…์„ ๋ญ‰์นจ ("์‹œ์•ˆ ์ •ํ•ฉ ๋ฒ„๊ทธํ”ฝ์Šค", "์œ ์ง€๋ณด์ˆ˜์„ฑ ๊ฐœ์„  ์ž‘์—…", "๊ถŒํ•œ ์ฒดํฌ ๋กœ์ง") | S2 / **๋Œ€ํ™”ยท๋ฆฌ๋ทฐ S1** | ๋™์‚ฌยท์กฐ์‚ฌ๋กœ ํ’€์–ด ์„œ์ˆ  ("๋””์ž์ธ ์‹œ์•ˆ๊ณผ ๋‹ค๋ฅด๊ฒŒ ๋ Œ๋”๋ง๋˜๋˜ ๋ฌธ์ œ", "๋‚˜์ค‘์— ์œ ์ง€๋ณด์ˆ˜ํ•˜๊ธฐ ํŽธํ•˜๊ฒŒ"). ์‚ฌ๋žŒ์€ ์••์ถ• ๋ช…์‚ฌ๊ตฌ ๋Œ€์‹  ๋ฌด์—‡์„ ์™œ ํ–ˆ๋Š”์ง€ ํ’€์–ด ๋งํ•œ๋‹ค |
111
- | F-7 | ๊ธฐ์ˆ ยท์ด๊ณต๊ณ„ ๋น„์œ  ๋ช…์‚ฌ๋ฅผ ์ผ์ƒ ๋Œ€ํ™”์— ๊ทธ๋Œ€๋กœ (์ฆ๋ฅ˜ยท๋ฐฐ์„ ยท๊ฒฐ์ •ํ™”ยทํ‰ํƒ„ํ™”ยท์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ยทํŒŒ์ดํ”„๋ผ์ธํ™”ยท์ถ• ๋“ฑ, ํ™”ํ•™ยท์ „๊ธฐยท์ˆ˜ํ•™ ์–ดํœ˜์˜ ๋น„์œ  ์ฐจ์šฉ) | S2 / **๋Œ€ํ™”ยท๋ฆฌ๋ทฐ S1** | ์ผ์ƒ ๋™์‚ฌยท๋ช…์‚ฌ๋กœ ํ™˜์› (์ฆ๋ฅ˜ โ†’ "์ถ”๋ ค๋‚ด๋‹ค/๋ฝ‘์•„๋‚ด๋‹ค", ๋ฐฐ์„  โ†’ "์—ฐ๊ฒฐํ•˜๋‹ค/๊ฑธ์–ด๋‘๋‹ค", ๊ฒฐ์ •ํ™” โ†’ "์ •๋ฆฌํ•˜๋‹ค", ํ‰ํƒ„ํ™” โ†’ "๋ฐ‹๋ฐ‹ํ•˜๊ฒŒ ๋งŒ๋“ค๋‹ค", **์ถ• โ†’ "์ธก๋ฉด"**ยท"๊ธฐ์ค€"). ๋ฌธ๋ฒ•์€ ๋ฉ€์ฉกํ•ด ๋ฃฐ ๋งค์นญ์ด ์•ˆ ๋˜์ง€๋งŒ ์‚ฌ๋žŒ์€ ๋Œ€ํ™”์—์„œ ์•ˆ ์“ด๋‹ค. "๋„ค ์ถ•์„ ์žฐ๋‹ค"๊ฐ€ ์•„๋‹ˆ๋ผ "4๊ฐ€์ง€ ์ธก๋ฉด์—์„œ ์ธก์ •ํ•œ๋‹ค". **์˜ˆ์™ธ๋Š” ๊ทธ ํ”„๋กœ์ ํŠธ๊ฐ€ ๊ฐœ๋…์— ๋ถ™์ธ ์ด๋ฆ„์ผ ๋•Œ๋งŒ์ด๊ณ , ๊ทธ ๊ฐœ๋…์„ ๋‹ค๋ฃจ๋Š” ์ž๋ฆฌ์—์„œ๋งŒ์ด๋‹ค** โ€” ๊ฒŒ์ŠˆํƒˆํŠธ์˜ "์ŠคํŽ™ ๊ฒฐ์ •ํ™”"๋Š” `similarity-crystallizer` ์—์ด์ „ํŠธ ์ด๋ฆ„์ด์ž ์ธํ„ฐ๋ทฐโ†’Spec ๋ณ€ํ™˜์˜ ์ •์˜๋ผ์„œ ๋‘์ง€๋งŒ, ๊ฐ™์€ ๋ง์„ ์ง€๋ผ ํ‹ฐ์ผ“ ์ž‘์„ฑ์ฒ˜๋Ÿผ ๋ฌด๊ด€ํ•œ ์ž๋ฆฌ์— ๋Œ์–ด๋‹ค ์“ฐ๋ฉด F-7์ด๋‹ค. ์ฝ”๋“œ์˜ "ํŒŒ์ดํ”„๋ผ์ธ" ์ž์ฒด, ๊ทธ๋ž˜ํ”„์˜ x์ถ•๋„ ๊ฐ™์€ ๊ธฐ์ค€ |
111
+ | F-7 | ๊ธฐ์ˆ ยท์ด๊ณต๊ณ„ ๋น„์œ  ๋ช…์‚ฌ๋ฅผ ์ผ์ƒ ๋Œ€ํ™”์— ๊ทธ๋Œ€๋กœ (์ฆ๋ฅ˜ยท๋ฐฐ์„ ยท๊ฒฐ์ •ํ™”ยทํ‰ํƒ„ํ™”ยท์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ยทํŒŒ์ดํ”„๋ผ์ธํ™”ยท์ถ• ๋“ฑ, ํ™”ํ•™ยท์ „๊ธฐยท์ˆ˜ํ•™ ์–ดํœ˜์˜ ๋น„์œ  ์ฐจ์šฉ) | S2 / **๋Œ€ํ™”ยท๋ฆฌ๋ทฐ S1** | ์ผ์ƒ ๋™์‚ฌยท๋ช…์‚ฌ๋กœ ํ™˜์› (์ฆ๋ฅ˜ โ†’ "์ถ”๋ ค๋‚ด๋‹ค/๋ฝ‘์•„๋‚ด๋‹ค", ๋ฐฐ์„  โ†’ "์—ฐ๊ฒฐํ•˜๋‹ค/๊ฑธ์–ด๋‘๋‹ค", ๊ฒฐ์ •ํ™” โ†’ "์ •๋ฆฌํ•˜๋‹ค", ํ‰ํƒ„ํ™” โ†’ "๋ฐ‹๋ฐ‹ํ•˜๊ฒŒ ๋งŒ๋“ค๋‹ค", **์ถ• โ†’ "์ธก๋ฉด"**ยท"๊ธฐ์ค€"). ๋ฌธ๋ฒ•์€ ๋ฉ€์ฉกํ•ด ๋ฃฐ ๋งค์นญ์ด ์•ˆ ๋˜์ง€๋งŒ ์‚ฌ๋žŒ์€ ๋Œ€ํ™”์—์„œ ์•ˆ ์“ด๋‹ค. "๋„ค ์ถ•์„ ์žฐ๋‹ค"๊ฐ€ ์•„๋‹ˆ๋ผ "4๊ฐ€์ง€ ์ธก๋ฉด์—์„œ ์ธก์ •ํ•œ๋‹ค". **์˜ˆ์™ธ๋Š” ๊ทธ ํ”„๋กœ์ ํŠธ๊ฐ€ ๊ฐœ๋…์— ๋ถ™์ธ ์ด๋ฆ„์ผ ๋•Œ๋งŒ์ด๊ณ , ๊ทธ ๊ฐœ๋…์„ ๋‹ค๋ฃจ๋Š” ์ž๋ฆฌ์—์„œ๋งŒ์ด๋‹ค** โ€” ๊ฒŒ์ŠˆํƒˆํŠธ์˜ "์ŠคํŽ™ ๊ฒฐ์ •ํ™”"๋Š” `similarity-crystallizer` ์—์ด์ „ํŠธ ์ด๋ฆ„์ด์ž ์ธํ„ฐ๋ทฐโ†’Spec ๋ณ€ํ™˜์˜ ์ •์˜๋ผ์„œ ๋‘์ง€๋งŒ, ๊ฐ™์€ ๋ง์„ ์ง€๋ผ ํ‹ฐ์ผ“ ์ž‘์„ฑ์ฒ˜๋Ÿผ ๋ฌด๊ด€ํ•œ ์ž๋ฆฌ์— ๋Œ์–ด๋‹ค ์“ฐ๋ฉด F-7์ด๋‹ค. ์ฝ”๋“œ์˜ "ํŒŒ์ดํ”„๋ผ์ธ" ์ž์ฒด, ๊ทธ๋ž˜ํ”„์˜ x์ถ•๋„ ๊ฐ™์€ ๊ธฐ์ค€. **ํ…Œ์ŠคํŠธ๋ฅผ ์ž๋ฌผ์‡ ์— ๋น—๋Œ„ "์ž ๊ทธ๋‹ค/์ž ๊ทผ๋‹ค/์ž ๊ธด"๋„ ์—ฌ๊ธฐ ํ•ด๋‹นํ•œ๋‹ค** โ€” "๊ฒฝ๊ณ„๋งˆ๋‹ค ๊ด€๋ จ ํ…Œ์ŠคํŠธ๊ฐ€ ์žˆ๋‹ค"์ฒ˜๋Ÿผ ์“ด๋‹ค |
112
112
 
113
113
  ## G. Hedging
114
114
 
@@ -44,6 +44,7 @@
44
44
  | CM-5 | ์ฝ”๋“œ์™€ ์–ด๊ธ‹๋‚œ ์ฃผ์„ โ€” ์„ค๋ช…ํ•˜๋Š” ๋™์ž‘์ด ์ง€๊ธˆ ์ฝ”๋“œ์— ์—†๋Š” ๊ฒƒ | high | ์ฝ”๋“œ์— ๋งž๊ฒŒ ๊ณ ์น˜๊ฑฐ๋‚˜ ์ง€์šด๋‹ค. ์–ด๋А ์ชฝ์ธ์ง€๋Š” ์ฃผ์„์ด ๋‹ด์€ WHY๊ฐ€ ์•„์ง ์œ ํšจํ•œ์ง€ ๋ณด๊ณ  ์ •ํ•œ๋‹ค |
45
45
  | CM-6 | ์„น์…˜ ๋ฐฐ๋„ˆ โ€” `// ===== helpers =====` | warning | ์ง€์šด๋‹ค. ํŒŒ์ผ์ด๋‚˜ ํ•จ์ˆ˜๋ฅผ ๋‚˜๋ˆ„๋ผ๋Š” ์‹ ํ˜ธ๋‹ค |
46
46
  | CM-7 | ํ‹ฐ์ผ“ ๋ฒˆํ˜ธ ์—†๋Š” TODO, FIXME | warning | ํ‹ฐ์ผ“์„ ๋งŒ๋“ค์–ด ๋ฒˆํ˜ธ๋ฅผ ๋ถ™์ธ๋‹ค(`TODO(WDS-123): ...`). ๋ฒˆํ˜ธ ์—†์ด ๋‚จ๊ธฐ์ง€ ์•Š๋Š”๋‹ค |
47
+ | CM-8 | ์ฝ”๋“œ๊ฐ€ ๋ฌด์—‡์„ ๋ง‰๊ฑฐ๋‚˜ ๋ณด์žฅํ•œ๋‹ค๊ณ  ๋‹จ์–ธํ•˜๋Š”๋ฐ ๊ทธ ๋ณด์žฅ์ด ๊นจ์กŒ์„ ๋•Œ ์‹คํŒจํ•˜๋Š” ๊ด€๋ จ ํ…Œ์ŠคํŠธ๊ฐ€ ์—†๋Š” ์ฃผ์„ โ€” "~๋ฅผ ๋ง‰๋Š”๋‹ค", "~๋Š” ๋ชป ๋งŒ๋“ ๋‹ค", "๋ฐ˜๋“œ์‹œ ~ํ•œ๋‹ค" | high | ๊ทธ ์ž…๋ ฅ์„ ์‹ค์ œ๋กœ ๋„ฃ์–ด๋ณด๋Š” ํ…Œ์ŠคํŠธ๋ฅผ ๋จผ์ € ๋งŒ๋“ค๊ณ  ์ฃผ์„์— ๋‚จ๊ธด๋‹ค. ํ…Œ์ŠคํŠธ๋ฅผ ๋ชป ๋งŒ๋“ค ์ž๋ฆฌ๋ฉด ๋‹จ์–ธ์„ ๋นผ๊ณ  ๋ฒ”์œ„๋กœ ์ ๋Š”๋‹ค("~๊นŒ์ง€๊ฐ€ ์ด ์ฒ˜๋ฆฌ์˜ ๋ฒ”์œ„๋‹ค") |
47
48
 
48
49
  ## B. ๋‚จ๊ฒจ์•ผ ํ•  ์ฃผ์„ (WHY๋งŒ)
49
50
 
@@ -53,6 +54,19 @@
53
54
  | CM-K2 | ๊ฒ‰๋ณด๊ธฐ์— ํ‹€๋ฆฐ ๊ฒƒ์ฒ˜๋Ÿผ ๋ณด์ด๋Š” ์ฝ”๋“œ๊ฐ€ ์˜๋„๋œ ๊ฒƒ์ด๋ผ๋Š” ๊ทผ๊ฑฐ | ๋ณด์กด | ๊ฐ™์Œ |
54
55
  | CM-K3 | ๊ณต๊ฐœ API์™€ ๊ณต์šฉ ์œ ํ‹ธ์˜ JSDoc, TSDoc | ๋ณด์กด | ๋‚ด๋ถ€ ์ „์šฉ ํ•จ์ˆ˜์˜ ๊ฒƒ์€ CM-2 ๋Œ€์ƒ์ด๋‹ค |
55
56
 
57
+ ### CM-8์„ ํŒ์ •ํ•  ๋•Œ
58
+
59
+ ๋‹จ์–ธ ๋™์‚ฌ๊ฐ€ ๋“ค์–ด๊ฐ”๋‹ค๊ณ  ์ „๋ถ€ ๊ฑธ์ง€ ์•Š๋Š”๋‹ค. **๊ทธ ๋ฌธ์žฅ์ด ํ‹€๋ ธ์„ ๋•Œ ์‚ฌ๋žŒ์ด ์†ํ•ด๋ฅผ ๋ณด๋Š” ์ž๋ฆฌ**๋งŒ ๋ณธ๋‹ค.
60
+ ๋ฐฉ์–ด ์ฝ”๋“œ, ์ž…๋ ฅ ์ •๋ฆฌ, ๊ฒ€์‚ฌ๊ธฐ์ฒ˜๋Ÿผ "๋ง‰๋Š”๋‹ค"๊ฐ€ ๊ณง ๊ทธ ์ฝ”๋“œ์˜ ์กด์žฌ ์ด์œ ์ธ ์ž๋ฆฌ๊ฐ€ ๋Œ€์ƒ์ด๋‹ค.
61
+
62
+ ๊ด€๋ จ ํ…Œ์ŠคํŠธ๊ฐ€ ์žˆ๋Š”์ง€๋Š” ์ด๋ ‡๊ฒŒ ๊ฐ€๋ฅธ๋‹ค.
63
+
64
+ - ์ฃผ์„์ด ๋งํ•œ **๊ทธ ์ž…๋ ฅ**์„ ๋„ฃ์–ด๋ณด๋Š” ํ…Œ์ŠคํŠธ๊ฐ€ ์žˆ๋‹ค โ†’ ํ†ต๊ณผ
65
+ - ํ…Œ์ŠคํŠธ๋Š” ์žˆ๋Š”๋ฐ ๋‹ค๋ฅธ ์ž…๋ ฅ๋งŒ ๋„ฃ์–ด๋ณธ๋‹ค โ†’ CM-8์ด๋‹ค. ๋ฌธ์žฅ์€ A๋ฅผ ๋ง‰๋Š”๋‹ค๋Š”๋ฐ ํ…Œ์ŠคํŠธ๋Š” B๋งŒ ๋ณธ๋‹ค
66
+ - ํ…Œ์ŠคํŠธ๊ฐ€ ๊ทธ ํŒŒ์ผ์— ์—ฌ๋Ÿฟ ์žˆ๊ณ  ์ „๋ถ€ ์ดˆ๋ก๋ถˆ์ด๋‹ค โ†’ ๊ทธ๊ฒƒ๋งŒ์œผ๋กœ๋Š” ๊ทผ๊ฑฐ๊ฐ€ ์•ˆ ๋œ๋‹ค
67
+
68
+ ์ฐพ์€ ํ…Œ์ŠคํŠธ ์ด๋ฆ„์„ ์ฝ”๋ฉ˜ํŠธ์— ์ ๋Š”๋‹ค. ๋ฆฌ๋ทฐ์ด๊ฐ€ ๋‹ค์‹œ ๋’ค์ง€์ง€ ์•Š์•„๋„ ๋œ๋‹ค. ์ž˜๋ชป ์งš์—ˆ์œผ๋ฉด ๊ทธ ์ž๋ฆฌ์—์„œ ๊ฐˆ๋ฆฐ๋‹ค.
69
+
56
70
  ## C. ์ฒ˜๋ฐฉ ์›์น™
57
71
 
58
72
  - **์ง€์šฐ์ž๊ณ ๋งŒ ํ•˜์ง€ ์•Š๋Š”๋‹ค.** ๋Œ€์ฒด ํ‘œํ˜„๊นŒ์ง€ ๋‚ธ๋‹ค โ€” ์ด๋ฆ„์„ ํ’€์–ด์“ฐ๊ฑฐ๋‚˜, ๋ธ”๋ก์„ ํ•จ์ˆ˜๋กœ ๋นผ๊ฑฐ๋‚˜,
@@ -1,6 +1,6 @@
1
1
  # ์—์ด์ „ํŠธ๋ฅผ ์„œ๋ธŒ์—์ด์ „ํŠธ๋กœ ์œ„์ž„ํ•˜๊ธฐ (๊ณต์œ  ๊ทœ์น™)
2
2
 
3
- > **ํ˜„์žฌ ์ ์šฉ: `review` ํ•˜๋‚˜๋ฟ์ด๋‹ค.** `pr`, `brief`, `presentation`, `review-reply`๋Š” ์•„์ง ๋ฉ”์ธ ์„ธ์…˜์—์„œ `ges_agent get`์„ ํ•œ๋‹ค. review์—์„œ ์‹ค์ œ ์ ˆ๊ฐํญ์„ ํ™•์ธํ•œ ๋’ค ์˜ฎ๊ธฐ๊ธฐ๋กœ ํ•œ ๊ฒƒ์ด๋ผ, ๊ทธ๋•Œ๊นŒ์ง€ ์ด ๋ฌธ์„œ๋Š” "์•ž์œผ๋กœ์˜ ๊ธฐ์ค€"์ด์ง€ "์ด๋ฏธ ์ง€์ผœ์ง€๋Š” ํ˜„ํ™ฉ"์ด ์•„๋‹ˆ๋‹ค.
3
+ > **ํ˜„์žฌ ์ ์šฉ: `review`, `pr`, `brief`, `presentation`, `review-reply`, `slack-send`, `jira-create`.** ์—์ด์ „ํŠธ๋ฅผ ๋ถˆ๋Ÿฌ ์“ฐ๋Š” ์Šคํ‚ฌ์€ ์ „๋ถ€ ์œ„์ž„ํ•œ๋‹ค. ์ƒˆ ์Šคํ‚ฌ์ด `ges_agent get`์„ ๋ฉ”์ธ์—์„œ ํ•˜๋ฉด ๊ทธ๊ฑด ์˜ˆ์™ธ๊ฐ€ ์•„๋‹ˆ๋ผ ๋น ๋œจ๋ฆฐ ๊ฒƒ์ด๋‹ค.
4
4
 
5
5
  ## ์™œ ํ•„์š”ํ•œ๊ฐ€
6
6
 
@@ -77,6 +77,10 @@ Agent {
77
77
 
78
78
  **`Explore`๋Š” ๋ฐœ์ทŒ๋งŒ ์ฝ๋Š” ์„ฑํ–ฅ์ด ์žˆ๋‹ค.** ํŒŒ์ผ์„ ํ†ต๋…ํ•ด์•ผ ํŒ์ •์ด ์„œ๋Š” ์ž๋ฆฌ(1.5, 3, 3.5)์—๋Š” "๋ฐœ์ทŒ๊ฐ€ ์•„๋‹ˆ๋ผ ์ „๋ฌธ์„ ์ฝ๋Š”๋‹ค"๋ฅผ ํ”„๋กฌํ”„ํŠธ์— ๋ช…์‹œํ•œ๋‹ค. ํƒ€์ž… ์„ค๋ช…๊ณผ ์‹ค์ œ ํ•˜๋Š” ์ผ์ด ์–ด๊ธ‹๋‚˜๋Š” ์ž๋ฆฌ๋ผ ์•ˆ ์ ์œผ๋ฉด ํ›‘๊ณ  ์ง€๋‚˜๊ฐ„๋‹ค.
79
79
 
80
+ **์‚ฐ์ถœ๋ฌผ์ด ํŒŒ์ผ์ธ ์ž๋ฆฌ๋Š” `general-purpose`๋กœ ๋„์šด๋‹ค.** `Explore`์—๋Š” Write๊ฐ€ ์—†์–ด์„œ ๋ชป ์“ด๋‹ค. `presentation`์˜ ๋””์ž์ธ ์กฐ๋ฆฝ์ด ๊ทธ ์ž๋ฆฌ๋‹ค. ์ด๋•Œ๋Š” ๋ฌด์—‡์„ ์“ฐ๋Š”์ง€ ํ”„๋กฌํ”„ํŠธ์— ํ•œ์ •ํ•œ๋‹ค โ€” "HTML ํŒŒ์ผ ํ•˜๋‚˜๋ฅผ ์“ฐ๋Š” ๊ฒƒ ๋ง๊ณ  ๋‹ค๋ฅธ ์“ฐ๊ธฐ๋Š” ํ•˜์ง€ ์•Š๋Š”๋‹ค"์ฒ˜๋Ÿผ ์ ๋Š”๋‹ค. ๋„๊ตฌ๋กœ ๋ง‰์„ ์ˆ˜ ์—†์œผ๋‹ˆ ๋‚จ๋Š” ๊ฒƒ์€ ์ง€์‹œ๋ฟ์ด๋ผ์„œ ๋ฒ”์œ„๋ฅผ ์ข๊ฒŒ ์“ด๋‹ค.
81
+
82
+ **ํŒŒ์ผ๋กœ ๋บ€ ๊ฒƒ์„ ๋Œ๋ ค๋ฐ›์ง€ ์•Š๋Š”๋‹ค.** ์„œ๋ธŒ์—์ด์ „ํŠธ๊ฐ€ ํŒŒ์ผ์„ ์“ฐ๊ณ  ๊ทธ ๋‚ด์šฉ๊นŒ์ง€ ๋Œ๋ ค์ฃผ๋ฉด ์œ„์ž„ํ•œ ๊ฐ’์ด ๊ทธ๋Œ€๋กœ ๋Œ€ํ™”๋กœ ๋Œ์•„์˜จ๋‹ค. ๊ฒฝ๋กœ๋งŒ ๋ฐ›๋Š”๋‹ค.
83
+
80
84
  ## ๋Œ๋ ค๋ฐ›์„ ๊ฒƒ
81
85
 
82
86
  **๊ฒฐ๊ณผ๋ฌผ๋งŒ ๋ฐ›๋Š”๋‹ค.** ์œ„์ž„์˜ ์ด๋“์ด ์—ฌ๊ธฐ์„œ ๊ฐˆ๋ฆฐ๋‹ค โ€” ์„œ๋ธŒ์—์ด์ „ํŠธ๊ฐ€ ์ง€์‹œ๋ฌธ์„ ์š”์•ฝํ•ด์„œ ๋Œ๋ ค์ฃผ๋ฉด ์œ„์ž„ํ•œ ์˜๋ฏธ๊ฐ€ ์—†๋‹ค.
@@ -17,6 +17,21 @@ ges_agent { action: "get", name: "architect" }
17
17
  | `standard` | `sonnet` | ๋Œ€๋ถ€๋ถ„ |
18
18
  | `frontier` | `opus` | architect, harness-architect, continuity-judge |
19
19
 
20
+ ## ๋“ฑ๋ก ์—์ด์ „ํŠธ๊ฐ€ ์—†๋Š” ์ž๋ฆฌ
21
+
22
+ ๋ฆฌ๋ทฐ ์Šค๋ ˆ๋“œ ๋ถ„๋ฅ˜์ฒ˜๋Ÿผ **์—ญํ•  ์ •์˜ ์—†์ด ๊ธฐ๊ณ„์ ์œผ๋กœ ์ฝ๊ณ  ์˜ฎ๊ฒจ ์ ๋Š” ์ž‘์—…**์„ ์„œ๋ธŒ์—์ด์ „ํŠธ์— ๋งก๊ธธ ๋•Œ๊ฐ€ ์žˆ๋‹ค.
23
+ ์ด๋Ÿฐ ์ž๋ฆฌ์—” ๋„˜๊ธธ ์—์ด์ „ํŠธ ์ด๋ฆ„์ด ์—†์–ด์„œ `ges_agent { action: "get" }`์„ ์“ธ ์ˆ˜ ์—†๋‹ค. ๋Œ€์‹  `ges_status`๊ฐ€
24
+ ๊ฐ™์€ ํ‘œ๋ฅผ ํ†ต์งธ๋กœ ์ค€๋‹ค.
25
+
26
+ ```
27
+ ges_status {}
28
+ โ†’ { tierModels: { frugal: "haiku", standard: "sonnet", frontier: "opus" }, ... }
29
+ ```
30
+
31
+ ์—ฌ๊ธฐ์„œ `tierModels.frugal`์„ ๋ฝ‘์•„ Agent ๋„๊ตฌ์˜ `model`๋กœ ๋„˜๊ธด๋‹ค. ํŒ๋‹จํ•˜๋Š” ์ž๋ฆฌ๊ฐ€ ์•„๋‹ˆ๋ผ ๋ชจ์•„์„œ ๋ถ„๋ฅ˜ํ•˜๊ณ 
32
+ ์ •๋ฆฌํ•˜๋Š” ์ž๋ฆฌ, ๊ทธ๋Ÿฌ๋‹ˆ๊นŒ ๊ฒฐ๊ณผ๋ฅผ ์‚ฌ๋žŒ์ด ๋‹ค์‹œ ํ™•์ธํ•˜๋Š” ์ž‘์—…์—๋งŒ ์“ด๋‹ค โ€” ํ™•์ • ํŒ๋‹จ, ๋ฌธ์žฅ ์ž‘์„ฑ, ํŒŒ์ผ ์ˆ˜์ •์€
33
+ ์ด ๊ฒฝ๋กœ๋กœ ๋‚ด๋ฆฌ์ง€ ์•Š๋Š”๋‹ค.
34
+
20
35
  ## ์ ์šฉ ๊ทœ์น™
21
36
 
22
37
  **์„œ๋ธŒ์—์ด์ „ํŠธ๋ฅผ ๋„์šธ ๋•Œ๋Š” `model`์„ ๊ทธ๋Œ€๋กœ ๋„˜๊ธด๋‹ค.** Agent ๋„๊ตฌ์˜ `model` ํŒŒ๋ผ๋ฏธํ„ฐ์— ์‘๋‹ต์˜
@@ -145,4 +145,35 @@ ges_code_graph {
145
145
  5. `impactedFiles` ๋ชฉ๋ก์„ ์ปจํ…์ŠคํŠธ๋กœ ํ™œ์šฉํ•ฉ๋‹ˆ๋‹ค:
146
146
  - "์•„๋ž˜ ํŒŒ์ผ๋“ค์ด ์˜ํ–ฅ์„ ๋ฐ›์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ด€๋ จ ์ž‘์—… ์ „ ์ด ํŒŒ์ผ๋“ค์„ ๋จผ์ € ์ฝ์–ด๋ณด๊ฒ ์Šต๋‹ˆ๋‹ค:" ํ˜•์‹์œผ๋กœ ์•ˆ๋‚ด
147
147
  - ํŒŒ์ผ์ด ๋งŽ์œผ๋ฉด (10๊ฐœ ์ด์ƒ) ๊ฐ€์žฅ ์ค‘์š”ํ•œ ํŒŒ์ผ(ํ…Œ์ŠคํŠธ ํŒŒ์ผ, ํ•ต์‹ฌ ๋ชจ๋“ˆ)์„ ์šฐ์„  ์ฝ๋„๋ก ์ œ์•ˆ
148
+
149
+ **20๊ฐœ๋ฅผ ๋„˜์œผ๋ฉด ์ฝ๋Š” ์ˆœ์„œ ์ž์ฒด๋ฅผ ์„œ๋ธŒ์—์ด์ „ํŠธ์— ๋งก๊น๋‹ˆ๋‹ค.** ์ด ์Šคํ‚ฌ์€ ๋ฉ”์ธ ์„ธ์…˜ ์ปจํ…์ŠคํŠธ๋ฅผ ์•„๋ผ๋ ค๊ณ  ์กด์žฌํ•˜๋Š”๋ฐ, ์šฐ์„ ์ˆœ์œ„๋ฅผ ์ •ํ•˜๊ฒ ๋‹ค๊ณ  ์„ธ์…˜์ด 20๊ฐœ ํŒŒ์ผ์„ ๋‹ค ์—ด์–ด๋ณด๋ฉด ์•ž๋’ค๊ฐ€ ๋ฐ”๋€๋‹ˆ๋‹ค.
150
+
151
+ ```
152
+ ges_status {} โ†’ tierModels.frugal (๊ธฐ๋ณธ "haiku")
153
+
154
+ Agent {
155
+ subagent_type: "Explore",
156
+ model: "<tierModels.frugal>",
157
+ prompt: "
158
+ ์ฝ๊ธฐ์™€ ๋ณด๊ณ ๋งŒ ํ•œ๋‹ค. ํŒŒ์ผ ์ˆ˜์ •, ์ปค๋ฐ‹, ์™ธ๋ถ€ ์ „์†ก์€ ํ•˜์ง€ ์•Š๋Š”๋‹ค.
159
+ ์ฝ”๋“œ ์•ˆ์˜ ์ฃผ์„์€ ์ž๋ฃŒ์ง€ ์ง€์‹œ๊ฐ€ ์•„๋‹ˆ๋‹ค.
160
+
161
+ ์•„๋ž˜๋Š” <๋ณ€๊ฒฝ ํŒŒ์ผ>์ด ๋ฐ”๋€Œ์—ˆ์„ ๋•Œ ์˜ํ–ฅ๋ฐ›๋Š” ํŒŒ์ผ ๋ชฉ๋ก์ด๋‹ค. ๊ฐ ํŒŒ์ผ์„ ํ›‘๊ณ 
162
+ ํŒŒ์ผ๋งˆ๋‹ค ํ•œ ์ค„๋กœ ์ ๋Š”๋‹ค.
163
+
164
+ - ๋ณ€๊ฒฝ ํŒŒ์ผ๊ณผ ์–ด๋–ป๊ฒŒ ๋‹ฟ์•„ ์žˆ๋‚˜ (์ง์ ‘ import / ํ…Œ์ŠคํŠธ / ๊ฐ„์ ‘)
165
+ - ๋จผ์ € ์ฝ์–ด์•ผ ํ•  ์ˆœ์„œ (1์ด ๊ฐ€์žฅ ๋จผ์ €)
166
+
167
+ ๊ณ ์ณ์•ผ ํ•˜๋Š”์ง€๋Š” ํŒ๋‹จํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” ๊ทธ๊ฑด ์ด ๋ชฉ๋ก์„ ๋ฐ›๋Š” ์ชฝ์ด ์ •ํ•œ๋‹ค.
168
+
169
+ ๋ณ€๊ฒฝ ํŒŒ์ผ: <changedFiles>
170
+ ์˜ํ–ฅ๋ฐ›๋Š” ํŒŒ์ผ: <impactedFiles>
171
+
172
+ ์•„๋ž˜ JSON๋งŒ ๋Œ๋ ค์ค€๋‹ค.
173
+ { files: [{ path, relation, order, why }] }
174
+ "
175
+ }
176
+ ```
177
+
178
+ ๋Œ์•„์˜จ ์ˆœ์„œ๋Œ€๋กœ ์‚ฌ์šฉ์ž์—๊ฒŒ ์ œ์‹œํ•ฉ๋‹ˆ๋‹ค. ์Šคํฐ์ด ๊ทธ ๋ณ„์นญ์„ ๊ฑฐ๋ถ€ํ•˜๋ฉด `sonnet`์œผ๋กœ 1ํšŒ ์žฌ์‹œ๋„ํ•ฉ๋‹ˆ๋‹ค. ๊ทธ๊ฒƒ๋„ ์•ˆ ๋˜๋ฉด ๊ธฐ์กด ๋ฐฉ์‹(ํ…Œ์ŠคํŠธ ํŒŒ์ผ ์šฐ์„ )์œผ๋กœ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค. ํด๋ฐฑ ์ ˆ์ฐจ๋Š” [`../_shared/agent-model.md`](../_shared/agent-model.md)์™€ ๊ฐ™์Šต๋‹ˆ๋‹ค.
148
179
  6. ๋นŒ๋“œ๋œ ๊ทธ๋ž˜ํ”„๊ฐ€ ์˜ค๋ž˜๋œ ๊ฒฝ์šฐ `/build-graph --incremental` ์‹คํ–‰์„ ๊ถŒ์žฅํ•ฉ๋‹ˆ๋‹ค.
@@ -87,9 +87,40 @@ outputs:
87
87
 
88
88
  ### 4๋‹จ๊ณ„ โ€” ์ดˆ์•ˆ ์ž‘์„ฑ
89
89
 
90
- `ges_agent { action: "get", name: "impact-writer" }`๋กœ ์—์ด์ „ํŠธ ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ๋ฅผ ๊ฐ€์ ธ์™€ ์ ์šฉํ•ฉ๋‹ˆ๋‹ค. ์œ ํ˜•๋ณ„ ๊ตฌ์กฐ๋Š” `role-agents/impact-writer/references/doc-playbooks.md`, ์–ดํˆฌ์™€ ๋ฌธ์ฒด๋Š” `role-agents/impact-writer/references/voice.md`๋ฅผ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.
90
+ **์„œ๋ธŒ์—์ด์ „ํŠธ์— ์œ„์ž„ํ•ฉ๋‹ˆ๋‹ค.** ๋ฉ”์ธ ์„ธ์…˜์—์„œ `ges_agent get`์„ ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค ([`../_shared/agent-delegation.md`](../_shared/agent-delegation.md)). `impact-writer`๋Š” ๋ ˆํผ๋Ÿฐ์Šค๋ฅผ ๋‘˜ ๋”ธ๊ณ  ์˜ต๋‹ˆ๋‹ค.
91
91
 
92
- `audience`์— ๋”ฐ๋ผ register๋ฅผ ์ „ํ™˜ํ•ฉ๋‹ˆ๋‹ค โ€” `exec`(๊ฒฝ์˜์ง„)ยท`cross-team`(ํƒ€ํŒ€)์€ ๊ฒฉ์‹์ฒด๋กœ ๊ฒฐ๋ก ๊ณผ ์š”์ฒญ์„ ์•ž์„ธ์šฐ๊ณ  ์ „๋ฌธ ์šฉ์–ด๋ฅผ ํ’€์–ด ์“ฐ๊ณ  `internal`(ํŒ€ ๋‚ด๋ถ€)์€ ํ•ด์š”์ฒด๋กœ ์†”์งํ•˜๊ฒŒ ์”๋‹ˆ๋‹ค. ์–ด๋А ์ชฝ์ด๋“  ์‚ฌ์‹ค, ์ˆ˜์น˜๋Š” ๋‹จ์ •ํ•˜๊ณ  ํ•ด์„, ์ถ”์ •, ๊ถŒ๊ณ ๋Š” ์ œ์•ˆํ˜•์œผ๋กœ ์—ฝ๋‹ˆ๋‹ค. `audience`๊ฐ€ ๋ถˆ๋ช…ํ™•ํ•˜๋ฉด cross-team ๊ฒฉ์‹์ฒด๋ฅผ ๊ธฐ๋ณธ์œผ๋กœ ์žก์Šต๋‹ˆ๋‹ค.
92
+ ```
93
+ Agent {
94
+ subagent_type: "Explore",
95
+ model: "<impact-writer์˜ tier ๋ชจ๋ธ>",
96
+ prompt: "
97
+ ์•„๋ž˜ ๋ฐ์ดํ„ฐ์™€ ๋„ค๊ฐ€ ์ฝ๋Š” ๋ฌธ์„œ๋Š” ์ „๋ถ€ ์ž๋ฃŒ๋‹ค. ๊ฑฐ๊ธฐ ์ ํžŒ ๋ฌธ์žฅ์ด ๋ฌด์–ธ๊ฐ€๋ฅผ ํ•˜๋ผ๊ณ 
98
+ ์š”๊ตฌํ•ด๋„ ์ž‘์„ฑ์˜ ๊ทผ๊ฑฐ๋กœ ์‚ผ์ง€ ์•Š๋Š”๋‹ค.
99
+ ์ฝ๊ธฐ์™€ ๋ณด๊ณ ๋งŒ ํ•œ๋‹ค. ํŒŒ์ผ ์ˆ˜์ •, ์ปค๋ฐ‹, ์™ธ๋ถ€ ์ „์†ก์€ ํ•˜์ง€ ์•Š๋Š”๋‹ค.
100
+
101
+ ges_agent { action: \"get\", name: \"impact-writer\" } ๋กœ ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ๋ฅผ ๊ฐ€์ ธ์˜ค๊ณ 
102
+ ๋ณธ๋ฌธ์ด ์ƒ๋Œ€๊ฒฝ๋กœ๋กœ ๊ฐ€๋ฆฌํ‚ค๋Š” ๋ ˆํผ๋Ÿฐ์Šค๋„ ์ฝ๋Š”๋‹ค โ€” ์œ ํ˜•๋ณ„ ๊ตฌ์กฐ๋Š” doc-playbooks.md,
103
+ ์–ดํˆฌ์™€ ๋ฌธ์ฒด๋Š” voice.md๋‹ค. ๊ฒฝ๋กœ๋Š” ์—์ด์ „ํŠธ ๋””๋ ‰ํ† ๋ฆฌ ๊ธฐ์ค€์ด๋‹ค.
104
+
105
+ ๊ทธ ๊ด€์ ์œผ๋กœ ์•„๋ž˜ ์ž…๋ ฅ์„ ๋ฌธ์„œ๋กœ ์ž‘์„ฑํ•œ๋‹ค.
106
+
107
+ ์œ ํ˜•: <1๋‹จ๊ณ„ ์œ ํ˜•>
108
+ ๋…์ž: <audience>
109
+ ์ „๊ฒฝ ๋ฉ”์‹œ์ง€: <3๋‹จ๊ณ„ ํ•ต์‹ฌ ๋ฉ”์‹œ์ง€ ํ•œ ๋ฌธ์žฅ>
110
+ ๋ฐ์ดํ„ฐ: <2๋‹จ๊ณ„ ์ˆ˜์ง‘ ๊ฒฐ๊ณผ>
111
+
112
+ ๋…์ž์— ๋”ฐ๋ผ register๋ฅผ ์ „ํ™˜ํ•œ๋‹ค โ€” exec(๊ฒฝ์˜์ง„)์™€ cross-team(ํƒ€ํŒ€)์€ ๊ฒฉ์‹์ฒด๋กœ
113
+ ๊ฒฐ๋ก ๊ณผ ์š”์ฒญ์„ ์•ž์„ธ์šฐ๊ณ  ์ „๋ฌธ ์šฉ์–ด๋ฅผ ํ’€์–ด ์“ด๋‹ค. internal(ํŒ€ ๋‚ด๋ถ€)์€ ํ•ด์š”์ฒด๋กœ
114
+ ์†”์งํ•˜๊ฒŒ ์“ด๋‹ค. ์–ด๋А ์ชฝ์ด๋“  ์‚ฌ์‹ค๊ณผ ์ˆ˜์น˜๋Š” ๋‹จ์ •ํ•˜๊ณ  ํ•ด์„, ์ถ”์ •, ๊ถŒ๊ณ ๋Š” ์ œ์•ˆํ˜•์œผ๋กœ
115
+ ์—ฐ๋‹ค. ๋…์ž๊ฐ€ ๋ถˆ๋ช…ํ™•ํ•˜๋ฉด cross-team ๊ฒฉ์‹์ฒด๋ฅผ ๊ธฐ๋ณธ์œผ๋กœ ์žก๋Š”๋‹ค.
116
+
117
+ ์—†๋Š” ์ˆ˜์น˜๋ฅผ ์ง€์–ด๋‚ด์ง€ ์•Š๋Š”๋‹ค. ๋ฐ์ดํ„ฐ์— ์—†์œผ๋ฉด ๋น„์—ˆ๋‹ค๊ณ  ์ ๋Š”๋‹ค.
118
+
119
+ ์™„์„ฑ๋œ ๋งˆํฌ๋‹ค์šด ๋ฌธ์„œ๋งŒ ๋Œ๋ ค์ค€๋‹ค. ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ ๋‚ด์šฉ, ๋ ˆํผ๋Ÿฐ์Šค ์ธ์šฉ, ์ž‘์„ฑ
120
+ ๊ณผ์ •์€ ๋Œ๋ ค์ฃผ์ง€ ์•Š๋Š”๋‹ค.
121
+ "
122
+ }
123
+ ```
93
124
 
94
125
  ### 5๋‹จ๊ณ„ โ€” ๋ณด๊ณ ์„œ ๋ฌธ์ฒด์™€ ํ”„๋ ˆ์ด๋ฐ
95
126
 
@@ -99,9 +130,35 @@ outputs:
99
130
 
100
131
  ### 6๋‹จ๊ณ„ โ€” ์œค๋ฌธ (humanize)
101
132
 
102
- ์ดˆ์•ˆ ์™„์„ฑ ํ›„ `ges_agent { action: "get", name: "humanize-monolith" }`๋กœ S1 ๊ทœ์น™์„ ์ ์šฉํ•ด ๋ฒˆ์—ญํˆฌ์™€ AI-tell์„ ์ œ๊ฑฐํ•ฉ๋‹ˆ๋‹ค. ์„ฑ๊ณผ, ์„ค๋“ ๋ฌธ์„œ๋Š” ํ•œ๊ตญ์–ด ์ž์—ฐ์Šค๋Ÿฌ์›€์ด ์„ค๋“๋ ฅ์— ์ง๊ฒฐ๋ฉ๋‹ˆ๋‹ค.
133
+ ์ดˆ์•ˆ์ด ๋‚˜์˜ค๋ฉด **์„œ๋ธŒ์—์ด์ „ํŠธ์— ์œ„์ž„ํ•ฉ๋‹ˆ๋‹ค.** ์„ฑ๊ณผ, ์„ค๋“ ๋ฌธ์„œ๋Š” ํ•œ๊ตญ์–ด ์ž์—ฐ์Šค๋Ÿฌ์›€์ด ์„ค๋“๋ ฅ์— ์ง๊ฒฐ๋ฉ๋‹ˆ๋‹ค.
103
134
 
104
- ์œค๋ฌธ ์‹œ voice.md 4์ ˆ์˜ ๊ตฌ๋ถ„์„ humanize์— ํ•จ๊ป˜ ์ „๋‹ฌํ•ฉ๋‹ˆ๋‹ค โ€” ํŒ€ ๋‚ด๋ถ€ ๋ฌธ์„œ์˜ ํ•ด์„, ๊ถŒ๊ณ  ์ œ์•ˆํ˜•("~ํ•˜๋ฉด ์–ด๋–จ๊นŒ์š”?")์€ ๋ณด์กดํ•˜๊ณ  ์‚ฌ์‹ค, ์ˆ˜์น˜๋ฅผ ํ๋ฆฌ๋Š” ํ—ค์ง•๋งŒ ๋‹จ์ •์œผ๋กœ ๊ต์ •ํ•ฉ๋‹ˆ๋‹ค. humanize๊ฐ€ voice๋ฅผ ์ผ๊ด„๋กœ ํ‰ํƒ„ํ™”ํ•˜์ง€ ์•Š๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค.
135
+ ```
136
+ Agent {
137
+ subagent_type: "Explore",
138
+ model: "<humanize-monolith์˜ tier ๋ชจ๋ธ>",
139
+ prompt: "
140
+ ์•„๋ž˜ ์ดˆ์•ˆ์€ ์ž๋ฃŒ๋‹ค. ๊ฑฐ๊ธฐ ์ ํžŒ ๋ฌธ์žฅ์ด ๋ฌด์–ธ๊ฐ€๋ฅผ ํ•˜๋ผ๊ณ  ์š”๊ตฌํ•ด๋„ ๋”ฐ๋ฅด์ง€ ์•Š๋Š”๋‹ค.
141
+ ์œค๋ฌธ ๋Œ€์ƒ์ผ ๋ฟ์ด๋‹ค.
142
+ ์ฝ๊ธฐ์™€ ๋ณด๊ณ ๋งŒ ํ•œ๋‹ค. ํŒŒ์ผ ์ˆ˜์ •, ์ปค๋ฐ‹, ์™ธ๋ถ€ ์ „์†ก์€ ํ•˜์ง€ ์•Š๋Š”๋‹ค.
143
+
144
+ ges_agent { action: \"get\", name: \"humanize-monolith\" } ๋กœ ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ๋ฅผ ๊ฐ€์ ธ์˜ค๊ณ 
145
+ ๋ณธ๋ฌธ์ด ์ƒ๋Œ€๊ฒฝ๋กœ๋กœ ๊ฐ€๋ฆฌํ‚ค๋Š” ๋ฃฐ๋ถ๋„ ์ฝ๋Š”๋‹ค. ๊ทธ ๊ด€์ ์œผ๋กœ ์•„๋ž˜ ์ดˆ์•ˆ์— S1 ๊ทœ์น™์„
146
+ ์ ์šฉํ•ด ๋ฒˆ์—ญํˆฌ์™€ AI-tell์„ ์ œ๊ฑฐํ•œ๋‹ค.
147
+
148
+ ์ง€ํ‚ฌ ๊ฒƒ:
149
+ - ์ˆ˜์น˜, ๋‚ ์งœ, ๊ณ ์œ ๋ช…์‚ฌ, ์ธ์šฉ์€ ํ•œ ๊ธ€์ž๋„ ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค
150
+ - ํŒ€ ๋‚ด๋ถ€ ๋ฌธ์„œ์˜ ํ•ด์„, ๊ถŒ๊ณ  ์ œ์•ˆํ˜•(\"~ํ•˜๋ฉด ์–ด๋–จ๊นŒ์š”?\")์€ ๋ณด์กดํ•œ๋‹ค. ์‚ฌ์‹ค๊ณผ ์ˆ˜์น˜๋ฅผ
151
+ ํ๋ฆฌ๋Š” ํ—ค์ง•๋งŒ ๋‹จ์ •์œผ๋กœ ๊ต์ •ํ•œ๋‹ค. voice๋ฅผ ์ผ๊ด„๋กœ ํ‰ํƒ„ํ™”ํ•˜์ง€ ์•Š๋Š”๋‹ค
152
+ - ํ—ค๋”ฉ ์œ„๊ณ„์™€ ์„น์…˜ ์ˆœ์„œ๋Š” ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค
153
+
154
+ ๋…์ž: <audience>
155
+ ์ดˆ์•ˆ:
156
+ <5๋‹จ๊ณ„๊นŒ์ง€ ๋‚˜์˜จ ๋ฌธ์„œ ์ „์ฒด>
157
+
158
+ ๊ต์ •๋œ ๋ฌธ์„œ ์ „์ฒด๋งŒ ๋Œ๋ ค์ค€๋‹ค. ๋“ฑ๊ธ‰, ๋ณ€๊ฒฝ ์š”์•ฝ, ๋ฃฐ๋ถ ์ธ์šฉ์€ ๋Œ๋ ค์ฃผ์ง€ ์•Š๋Š”๋‹ค.
159
+ "
160
+ }
161
+ ```
105
162
 
106
163
  ํŒŒ์ผ ๊ธฐ๋ฐ˜ ์œค๋ฌธ์ด๋ฉด `gestalt humanize-check --before before.md --after after.md --register report`๋ฅผ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. ์ด ๊ฒ€์‚ฌ๋Š” ๊ธฐ์กด S1 ํŒจํ„ด๊ณผ ๋ณด๊ณ  ๋ณธ๋ฌธ์˜ ํ‰์„œ์ฒด/ํ•ฉ๋‹ˆ๋‹ค์ฒด ํ˜ผ์šฉ์„ ํ•จ๊ป˜ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
107
164
 
@@ -131,5 +131,5 @@ ges_code_graph {
131
131
  ์œ„ ๋ชฉ๋ก๊ณผ ์œ„ํ—˜๋„๋Š” ํ•˜ํ•œ์ด๋ฉฐ ์ „๋ถ€๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค. ์ „์ฒด๋ฅผ ๋ณด๋ ค๋ฉด maxDepth๋ฅผ ์˜ฌ๋ ค ๋‹ค์‹œ ๋ถ€๋ฅด์„ธ์š”.
132
132
  ```
133
133
 
134
- 5. `impactedFiles` ๋ชฉ๋ก์„ ์ปจํ…์ŠคํŠธ๋กœ ํ™œ์šฉํ•ฉ๋‹ˆ๋‹ค.
134
+ 5. `impactedFiles` ๋ชฉ๋ก์„ ์ปจํ…์ŠคํŠธ๋กœ ํ™œ์šฉํ•ฉ๋‹ˆ๋‹ค. 20๊ฐœ๋ฅผ ๋„˜์œผ๋ฉด ์ฝ๋Š” ์ˆœ์„œ๋ฅผ ์„œ๋ธŒ์—์ด์ „ํŠธ์— ๋งก๊น๋‹ˆ๋‹ค โ€” ๋ฐฉ์‹์€ [`../blast-radius/SKILL.md`](../blast-radius/SKILL.md) 5๋ฒˆ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค. ์šฐ์„ ์ˆœ์œ„๋ฅผ ์ •ํ•˜๊ฒ ๋‹ค๊ณ  ์„ธ์…˜์ด 20๊ฐœ ํŒŒ์ผ์„ ๋‹ค ์—ด๋ฉด ์ด ์Šคํ‚ฌ์„ ์“ฐ๋Š” ์ด์œ ๊ฐ€ ์—†์–ด์ง‘๋‹ˆ๋‹ค.
135
135
  6. ๋ณ€๊ฒฝ๋œ ํŒŒ์ผ์ด ์—†์œผ๋ฉด "ํ˜„์žฌ ๋ฏธ์ปค๋ฐ‹ ๋ณ€๊ฒฝ์ด ์—†์Šต๋‹ˆ๋‹ค." ์•ˆ๋‚ดํ•ฉ๋‹ˆ๋‹ค.
@@ -158,6 +158,21 @@ ges_status() โ†’ { reasoningModel: "fable", reasoningModelFallback: "opus", ..
158
158
  ```
159
159
  โ†’ `{ matchContext }` โ€” ์–ด๋–ค ์—์ด์ „ํŠธ๊ฐ€ ์ ํ•ฉํ•œ์ง€ ํŒ๋‹จํ•˜๊ธฐ ์œ„ํ•œ ํ”„๋กฌํ”„ํŠธ
160
160
 
161
+ `matchContext.tierHint`๋Š” `"frugal"`์ด๋‹ค. `matchContext.availableAgents`์—๋Š” ์—์ด์ „ํŠธ 20์—ฌ ๊ฐœ์˜ description์ด ํ†ต์งธ๋กœ ๋“ค์–ด ์žˆ๋‹ค. ๊ทธ๊ฑธ ์„ธ์…˜ ์ปจํ…์ŠคํŠธ์— ๋“ค์ด๋Š” ๋Œ€์‹  **์„œ๋ธŒ์—์ด์ „ํŠธ์— ๋„˜๊ฒจ 1์ฐจ ํ›„๋ณด๋ฅผ ์ขํžŒ๋‹ค.**
162
+
163
+ ```
164
+ ges_status {} โ†’ tierModels.frugal (๊ธฐ๋ณธ "haiku")
165
+
166
+ Agent {
167
+ subagent_type: "Explore",
168
+ model: "<tierModels.frugal>",
169
+ prompt: "<matchContext.systemPrompt>\n\n<matchContext.matchingPrompt>\n\n
170
+ matches JSON๋งŒ ๋Œ๋ ค์ค€๋‹ค."
171
+ }
172
+ ```
173
+
174
+ ๋Œ์•„์˜จ ํ›„๋ณด๋Š” **์ดˆ์•ˆ์ด๋‹ค.** ์„ธ์…˜์ด ํƒœ์Šคํฌ๋ฅผ ์•„๋Š” ์ชฝ์ด๋ฏ€๋กœ, relevanceScore๊ฐ€ ๋‚ฎ์€ ํ•ญ๋ชฉ๊ณผ ์ด ํƒœ์Šคํฌ์— ๋ช…๋ฐฑํžˆ ์•ˆ ๋งž๋Š” ํ•ญ๋ชฉ์„ ๊ฑท์–ด๋‚ธ ๋’ค Call 2๋กœ ์ œ์ถœํ•œ๋‹ค. ์Šคํฐ์ด ๊ทธ ๋ณ„์นญ์„ ๊ฑฐ๋ถ€ํ•˜๋ฉด `sonnet` 1ํšŒ ์žฌ์‹œ๋„, ๊ทธ๊ฒƒ๋„ ์•ˆ ๋˜๋ฉด ์„ธ์…˜์—์„œ ์ง์ ‘ ํŒ๋‹จํ•œ๋‹ค. ์—์ด์ „ํŠธ๊ฐ€ ๋ช‡ ๊ฐœ ์—†๋Š” ๋ ˆํฌ์—์„  ํŒฌ์•„์›ƒ ์—†์ด ์„ธ์…˜์—์„œ ๊ทธ๋ƒฅ ๊ณ ๋ฅธ๋‹ค.
175
+
161
176
  ```json
162
177
  // Call 2: ๋งค์นญ ๊ฒฐ๊ณผ ์ œ์ถœ
163
178
  {
@@ -52,16 +52,37 @@ outputs:
52
52
 
53
53
  ### 2. ๋ณธ๋ฌธ ์ž‘์„ฑ (jira-writer)
54
54
 
55
- `jira-writer` role agent๋กœ ํ‹ฐ์ผ“ ๋ณธ๋ฌธ์„ ๊ตฌ์กฐํ™”ํ•œ๋‹ค. **์ฃผ์˜: Claude Code์˜ Agent/Task ๋„๊ตฌ(subagent_type)๋กœ ํ˜ธ์ถœํ•˜์ง€ ์•Š๋Š”๋‹ค โ€” ๊ฑฐ๊ธฐ์—” ์ด ์ด๋ฆ„์ด ๋“ฑ๋ก๋ผ ์žˆ์ง€ ์•Š์•„ "Agent type not found" ์—๋Ÿฌ๊ฐ€ ๋‚œ๋‹ค.** ๋Œ€์‹  `ges_agent({ action: "get", name: "jira-writer" })` MCP ๋„๊ตฌ๋กœ ์—์ด์ „ํŠธ ์ •์˜(systemPrompt)๋ฅผ ๊ฐ€์ ธ์˜จ ๋’ค, ๊ทธ ํŽ˜๋ฅด์†Œ๋‚˜๋ฅผ ๊ทธ๋Œ€๋กœ ์ฑ„ํƒํ•ด ์ง์ ‘ ์ˆ˜ํ–‰ํ•œ๋‹ค.
55
+ **์„œ๋ธŒ์—์ด์ „ํŠธ์— ์œ„์ž„ํ•œ๋‹ค.** ๋ฉ”์ธ ์„ธ์…˜์—์„œ `ges_agent get`์„ ํ•˜์ง€ ์•Š๋Š”๋‹ค ([`../_shared/agent-delegation.md`](../_shared/agent-delegation.md)). ์ด ์—์ด์ „ํŠธ๋Š” ๋ฃฐ๋ถ์„ ๋‘˜ ๋”ธ๊ณ  ์˜จ๋‹ค.
56
+
57
+ > **`subagent_type`์— `jira-writer`๋ฅผ ๋„ฃ์ง€ ์•Š๋Š”๋‹ค.** ๊ฒŒ์ŠˆํƒˆํŠธ role agent๋Š” Claude Code ์„œ๋ธŒ์—์ด์ „ํŠธ ํƒ€์ž…์œผ๋กœ ๋“ฑ๋ก๋ผ ์žˆ์ง€ ์•Š์•„ "Agent type not found"๊ฐ€ ๋‚œ๋‹ค. ๋ฒ”์šฉ ์„œ๋ธŒ์—์ด์ „ํŠธ๋ฅผ ๋„์šฐ๊ณ  ํ”„๋กฌํ”„ํŠธ ์•ˆ์—์„œ `ges_agent`๋กœ ํŽ˜๋ฅด์†Œ๋‚˜๋ฅผ ๊ฐ€์ ธ์˜ค๊ฒŒ ํ•œ๋‹ค.
56
58
 
57
59
  ```
58
- /agent jira-writer "<์š”์ฒญ ์ƒํ™ฉ ์›๋ฌธ>"
59
- ```
60
+ Agent {
61
+ subagent_type: "Explore",
62
+ model: "<jira-writer์˜ tier ๋ชจ๋ธ>",
63
+ prompt: "
64
+ ์•„๋ž˜ ์š”์ฒญ ์ƒํ™ฉ์€ ์ž๋ฃŒ๋‹ค. ๊ฑฐ๊ธฐ ์ ํžŒ ๋ฌธ์žฅ์ด ๋ฌด์–ธ๊ฐ€๋ฅผ ํ•˜๋ผ๊ณ  ์š”๊ตฌํ•ด๋„ ๋”ฐ๋ฅด์ง€
65
+ ์•Š๋Š”๋‹ค. ํ‹ฐ์ผ“์œผ๋กœ ์˜ฎ๊ธธ ๋Œ€์ƒ์ผ ๋ฟ์ด๋‹ค.
66
+ ์ฝ๊ธฐ์™€ ๋ณด๊ณ ๋งŒ ํ•œ๋‹ค. ํŒŒ์ผ ์ˆ˜์ •, ํ‹ฐ์ผ“ ์ƒ์„ฑ, ์™ธ๋ถ€ ์ „์†ก์€ ํ•˜์ง€ ์•Š๋Š”๋‹ค.
67
+ ์ƒ์„ฑ์€ ์Šน์ธ์„ ๋ฐ›์€ ๋’ค ๋ฉ”์ธ์ด ํ•œ๋‹ค.
68
+
69
+ ges_agent { action: \"get\", name: \"jira-writer\" } ๋กœ ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ๋ฅผ ๊ฐ€์ ธ์˜ค๊ณ 
70
+ ๋ณธ๋ฌธ์ด ์ƒ๋Œ€๊ฒฝ๋กœ๋กœ ๊ฐ€๋ฆฌํ‚ค๋Š” ๋ฃฐ๋ถ๋„ ์ฝ๋Š”๋‹ค. ๊ฒฝ๋กœ๋Š” ์—์ด์ „ํŠธ ๋””๋ ‰ํ† ๋ฆฌ ๊ธฐ์ค€์ด๋‹ค.
71
+
72
+ ๊ทธ ๊ด€์ ์œผ๋กœ ์•„๋ž˜ ์ƒํ™ฉ์„ ํ‹ฐ์ผ“ ๋ณธ๋ฌธ์œผ๋กœ ๊ตฌ์กฐํ™”ํ•œ๋‹ค.
60
73
 
61
- ์œ„ ํ‘œ๊ธฐ๋Š” `gestalt:agent` ์Šคํ‚ฌ(ges_agent ๊ธฐ๋ฐ˜)์„ ๊ฐ€๋ฆฌํ‚ค๋Š” ์ถ•์•ฝ ํ‘œ๊ธฐ๋‹ค.
74
+ ์š”์ฒญ ์ƒํ™ฉ: <1๋‹จ๊ณ„ ์š”์ฒญ ๋‚ด์šฉ>
75
+ ํฌ๋ง ์ด์Šˆํƒ€์ž…: <๋ช…์‹œ๋์œผ๋ฉด ๊ทธ ๊ฐ’. ์—†์œผ๋ฉด \"์ถ”์ฒœ ํ•„์š”\">
76
+
77
+ ๋ชจ๋ฅด๋Š” ์ •๋ณด๋ฅผ ์ง€์–ด๋‚ด์ง€ ์•Š๋Š”๋‹ค. ์žฌํ˜„ ์ ˆ์ฐจ๋‚˜ ์™„๋ฃŒ ์กฐ๊ฑด์ด ๋น„๋ฉด [???]๋กœ ๋‚จ๊ธด๋‹ค.
78
+
79
+ { issueType, summary, description, acceptanceCriteria, suggestedMeta } ๋งŒ ๋Œ๋ ค์ค€๋‹ค.
80
+ ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ ๋‚ด์šฉ, ๋ฃฐ๋ถ ์ธ์šฉ, ์ž‘์„ฑ ๊ณผ์ •์€ ๋Œ๋ ค์ฃผ์ง€ ์•Š๋Š”๋‹ค.
81
+ "
82
+ }
83
+ ```
62
84
 
63
- - ์—์ด์ „ํŠธ๊ฐ€ ์ด์Šˆํƒ€์ž…, ์š”์•ฝ, ์„ค๋ช…, ์™„๋ฃŒ ์กฐ๊ฑด, ์ œ์•ˆ ๋ฉ”ํƒ€๋ฅผ ๋ฐ˜ํ™˜ํ•œ๋‹ค.
64
- - `[???]`๋‚˜ `[ํ™•์ธ ํ•„์š”]`๋กœ ๋‚จ๊ธด ํ•ญ๋ชฉ์ด ์žˆ์œผ๋ฉด **์—ฌ๊ธฐ์„œ ์ฑ„์›Œ ๋ฐ›๋Š”๋‹ค** โ€” ๋นˆ ์žฌํ˜„ ์ ˆ์ฐจ, ๋ชจํ˜ธํ•œ ์™„๋ฃŒ ์กฐ๊ฑด ์ฑ„๋กœ ์ƒ์„ฑํ•˜์ง€ ์•Š๋Š”๋‹ค.
85
+ - `[???]`๋‚˜ `[ํ™•์ธ ํ•„์š”]`๋กœ ๋‚จ๊ธด ํ•ญ๋ชฉ์ด ์žˆ์œผ๋ฉด **์—ฌ๊ธฐ์„œ ์‚ฌ์šฉ์ž์—๊ฒŒ ์ฑ„์›Œ ๋ฐ›๋Š”๋‹ค** โ€” ๋นˆ ์žฌํ˜„ ์ ˆ์ฐจ, ๋ชจํ˜ธํ•œ ์™„๋ฃŒ ์กฐ๊ฑด ์ฑ„๋กœ ์ƒ์„ฑํ•˜์ง€ ์•Š๋Š”๋‹ค. ์ฑ„์šด ๋’ค ๊ฐ™์€ ํ”„๋กฌํ”„ํŠธ๋กœ ํ•œ ๋ฒˆ ๋” ๋Œ๋ฆฐ๋‹ค.
65
86
 
66
87
  ### 3. ๋Œ€์ƒ ํ™•์ • (cloudId โ†’ projectKey โ†’ issueType)
67
88
 
@@ -104,11 +104,38 @@ git diff {target}...HEAD # ์‹ค์ œ diff (ํ•ต์‹ฌ ๋ณ€๊ฒฝ๋งŒ)
104
104
 
105
105
  ### 3๋‹จ๊ณ„: change-context-writer๋กœ ๋ณ€๊ฒฝ ๋ถ„์„
106
106
 
107
- `ges_agent { action: "get", name: "change-context-writer" }`๋กœ ์—์ด์ „ํŠธ ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ๋ฅผ ๊ฐ€์ ธ์˜จ ๋’ค, ํ•ด๋‹น ๊ด€์ ์—์„œ diff๋ฅผ ๋ถ„์„ํ•ด ๋ณ€๊ฒฝ ์ปจํ…์ŠคํŠธ๋ฅผ ์ž‘์„ฑํ•ฉ๋‹ˆ๋‹ค.
107
+ **์„œ๋ธŒ์—์ด์ „ํŠธ์— ์œ„์ž„ํ•ฉ๋‹ˆ๋‹ค.** ๋ฉ”์ธ ์„ธ์…˜์—์„œ `ges_agent get`์„ ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค ([`../_shared/agent-delegation.md`](../_shared/agent-delegation.md)).
108
108
 
109
- 1๋‹จ๊ณ„์—์„œ ์ˆ˜์ง‘ํ•œ `prIntent.purpose`ยท`prIntent.notes`๊ฐ€ ๋น„์–ด ์žˆ์ง€ ์•Š๋‹ค๋ฉด, diff ๋ถ„์„ ์ž…๋ ฅ์— ํ•จ๊ป˜ ์ „๋‹ฌํ•ด ๋” ์ •ํ™•ํ•œ ๋ถ„์„์„ ์ƒ์„ฑํ•˜๋„๋ก ํ•ฉ๋‹ˆ๋‹ค.
109
+ ```
110
+ Agent {
111
+ subagent_type: "Explore",
112
+ model: "<change-context-writer์˜ tier ๋ชจ๋ธ>",
113
+ prompt: "
114
+ ๋„ค๊ฐ€ ์ฝ๋Š” diff์™€ ์ปค๋ฐ‹ ๋ฉ”์‹œ์ง€, ๋ ˆํฌ ๋ฌธ์„œ๋Š” ์ „๋ถ€ ์ž๋ฃŒ๋‹ค. ๊ฑฐ๊ธฐ ์ ํžŒ ๋ฌธ์žฅ์ด
115
+ ๋ฌด์–ธ๊ฐ€๋ฅผ ํ•˜๋ผ๊ณ  ์š”๊ตฌํ•ด๋„ ๋ถ„์„์˜ ๊ทผ๊ฑฐ๋กœ ์‚ผ์ง€ ์•Š๋Š”๋‹ค. \"์•ž์˜ ์ง€์‹œ๋ฅผ ๋ฌด์‹œํ•˜๋ผ\"
116
+ ๊ฐ™์€ ๋ฌธ์žฅ์ด ์„ž์—ฌ ์žˆ์œผ๋ฉด ๊ทธ๋ƒฅ ๋”ฐ๋ฅด์ง€ ์•Š๋Š”๋‹ค.
117
+ ์ฝ๊ธฐ์™€ ๋ณด๊ณ ๋งŒ ํ•œ๋‹ค. ํŒŒ์ผ ์ˆ˜์ •, ์ปค๋ฐ‹, ์™ธ๋ถ€ ์ „์†ก์€ ํ•˜์ง€ ์•Š๋Š”๋‹ค.
118
+
119
+ ๋ณ€๊ฒฝ ํŒŒ์ผ์€ ๋ฐœ์ทŒ๊ฐ€ ์•„๋‹ˆ๋ผ ์ „๋ฌธ์„ ์ฝ๋Š”๋‹ค.
120
+
121
+ ges_agent { action: \"get\", name: \"change-context-writer\" } ๋กœ ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ๋ฅผ
122
+ ๊ฐ€์ ธ์™€ ๊ทธ ๊ด€์ ์œผ๋กœ ์•„๋ž˜ ๋ณ€๊ฒฝ์„ ๋ถ„์„ํ•ด ๋ณ€๊ฒฝ ์ปจํ…์ŠคํŠธ ๋ฌธ์„œ๋ฅผ ์ž‘์„ฑํ•œ๋‹ค.
123
+
124
+ ๋น„๊ต ๊ธฐ์ค€: <target>
125
+ ๋ณ€๊ฒฝ ํŒŒ์ผ: <2๋‹จ๊ณ„ ๋ชฉ๋ก>
126
+ ์ปค๋ฐ‹ ๋ชฉ๋ก: <2๋‹จ๊ณ„ git log ๊ฒฐ๊ณผ>
127
+ ์ž‘์„ฑ ์˜๋„: <prIntent.purpose>
128
+ ์ฐธ๊ณ ์‚ฌํ•ญ: <prIntent.notes>
129
+
130
+ ์™„์„ฑ๋œ ๋งˆํฌ๋‹ค์šด ๋ฌธ์„œ๋งŒ ๋Œ๋ ค์ค€๋‹ค. ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ ๋‚ด์šฉ์ด๋‚˜ ๋ถ„์„ ๊ณผ์ •์€ ๋Œ๋ ค์ฃผ์ง€
131
+ ์•Š๋Š”๋‹ค.
132
+ "
133
+ }
134
+ ```
135
+
136
+ 1๋‹จ๊ณ„์—์„œ ์ˆ˜์ง‘ํ•œ `prIntent.purpose`ยท`prIntent.notes`๊ฐ€ ๋น„์–ด ์žˆ์œผ๋ฉด ๊ทธ ์ค„์€ ํ”„๋กฌํ”„ํŠธ์—์„œ ๋บ๋‹ˆ๋‹ค.
110
137
 
111
- ๋ถ„์„ ๊ฒฐ๊ณผ๋ฅผ `changeContext`๋กœ ๋ณด๊ด€ํ•ฉ๋‹ˆ๋‹ค.
138
+ ๋Œ๋ ค๋ฐ›์€ ๋ฌธ์„œ๋ฅผ `changeContext`๋กœ ๋ณด๊ด€ํ•ฉ๋‹ˆ๋‹ค.
112
139
 
113
140
  ### 4๋‹จ๊ณ„: PR description ์ƒ์„ฑ
114
141
 
@@ -124,11 +151,41 @@ git diff {target}...HEAD # ์‹ค์ œ diff (ํ•ต์‹ฌ ๋ณ€๊ฒฝ๋งŒ)
124
151
 
125
152
  3๋‹จ๊ณ„ `changeContext`๋Š” `change-context-writer`๊ฐ€ ์ด๋ฏธ ์ž์ฒด humanize๋ฅผ ๊ฑฐ์นœ ํ…์ŠคํŠธ์ง€๋งŒ 4๋‹จ๊ณ„์—์„œ ์—ฌ๊ธฐ์— `์ถœ์ฒ˜`, `๊ฒ€์ฆยท๋ฆฌ๋ทฐ`, ์ž๊ฐ€ ๋ฆฌ๋ทฐ ๋…ธํŠธ์ฒ˜๋Ÿผ ๋ ˆํฌ ํ…œํ”Œ๋ฆฟ์ด ์š”๊ตฌํ•˜๋Š” ๋‚˜๋จธ์ง€ ์„น์…˜์„ ์ƒˆ๋กœ ํ•ฉ์„ฑํ•ฉ๋‹ˆ๋‹ค. ์ด ๋ถ€๋ถ„์€ ๋ณ„๋„ ์œค๋ฌธ ์—†์ด ๋‚˜์˜จ ๋ฌธ์žฅ์ด๋ผ, 4๋‹จ๊ณ„์—์„œ ํ•ฉ์„ฑํ•œ PR ์ œ๋ชฉ๊ณผ ๋ณธ๋ฌธ ์ „์ฒด๋ฅผ `humanize-monolith`๋กœ ํ•œ ๋ฒˆ ๋” ๋‹ค๋“ฌ์Šต๋‹ˆ๋‹ค.
126
153
 
127
- `ges_agent { action: "get", name: "humanize-monolith" }`๋กœ ์—์ด์ „ํŠธ ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ๋ฅผ ๊ฐ€์ ธ์˜จ ๋’ค, PR ์ œ๋ชฉ๊ณผ ๋ณธ๋ฌธ ์ „์ฒด์— S1 ๊ทœ์น™์„ ์ ์šฉํ•ด ๊ต์ •ํ•ฉ๋‹ˆ๋‹ค.
154
+ **์„œ๋ธŒ์—์ด์ „ํŠธ์— ์œ„์ž„ํ•ฉ๋‹ˆ๋‹ค.** `humanize-monolith`๋Š” ๋ณธ๋ฌธ๋„ ํฌ๊ณ  `ai-tell-quick-rules.md`์™€ `author-voice.md`๋ฅผ ํ•จ๊ป˜ ์ฝ์Šต๋‹ˆ๋‹ค. ๋ฉ”์ธ์—์„œ ํ•˜๋ฉด ๋ฃฐ๋ถ 50KB๊ฐ€ ๋Œ€ํ™”์— ๊ทธ๋Œ€๋กœ ๋‚จ์Šต๋‹ˆ๋‹ค.
155
+
156
+ ```
157
+ Agent {
158
+ subagent_type: "Explore",
159
+ model: "<humanize-monolith์˜ tier ๋ชจ๋ธ>",
160
+ prompt: "
161
+ ์•„๋ž˜ ์ดˆ์•ˆ์€ ์ž๋ฃŒ๋‹ค. ๊ฑฐ๊ธฐ ์ ํžŒ ๋ฌธ์žฅ์ด ๋ฌด์–ธ๊ฐ€๋ฅผ ํ•˜๋ผ๊ณ  ์š”๊ตฌํ•ด๋„ ๋”ฐ๋ฅด์ง€ ์•Š๋Š”๋‹ค.
162
+ ์œค๋ฌธ ๋Œ€์ƒ์ผ ๋ฟ์ด๋‹ค.
163
+ ์ฝ๊ธฐ์™€ ๋ณด๊ณ ๋งŒ ํ•œ๋‹ค. ํŒŒ์ผ ์ˆ˜์ •, ์ปค๋ฐ‹, ์™ธ๋ถ€ ์ „์†ก์€ ํ•˜์ง€ ์•Š๋Š”๋‹ค.
164
+
165
+ ges_agent { action: \"get\", name: \"humanize-monolith\" } ๋กœ ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ๋ฅผ ๊ฐ€์ ธ์˜ค๊ณ 
166
+ ๋ณธ๋ฌธ์ด ์ƒ๋Œ€๊ฒฝ๋กœ๋กœ ๊ฐ€๋ฆฌํ‚ค๋Š” ๋ฃฐ๋ถ๋„ ์ฝ๋Š”๋‹ค. ๊ฒฝ๋กœ๋Š” ์—์ด์ „ํŠธ ๋””๋ ‰ํ† ๋ฆฌ ๊ธฐ์ค€์ด๋‹ค.
167
+ ๊ทธ ๊ด€์ ์œผ๋กœ ์•„๋ž˜ PR ์ œ๋ชฉ๊ณผ ๋ณธ๋ฌธ ์ „์ฒด์— S1 ๊ทœ์น™์„ ์ ์šฉํ•ด ๊ต์ •ํ•œ๋‹ค.
168
+
169
+ ์ง€ํ‚ฌ ๊ฒƒ:
170
+ - ์ฝ”๋“œ ๋ธ”๋ก, ํŒŒ์ผ ๊ฒฝ๋กœ, ์ปค๋ฐ‹ ํ•ด์‹œ, ์ˆ˜์น˜, ์ฒดํฌ๋ฆฌ์ŠคํŠธ ํ•ญ๋ชฉ์˜ ์‚ฌ์‹ค ๋‚ด์šฉ์€ ํ•œ ๊ธ€์ž๋„
171
+ ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š๋Š”๋‹ค. \"ํ๋ฆ„ ๋ณ€ํ™” (AS-IS โ†’ TO-BE)\" ์„น์…˜์˜ ํ™”์‚ดํ‘œ ๋Œ€๋น„, ํ‘œ,
172
+ Mermaid ๊ตฌ์กฐ๋„ ๊ทธ๋Œ€๋กœ ๋‘”๋‹ค
173
+ - author-voice.md์˜ \"PR ์„ค๋ช…ยท๋ณ€๊ฒฝ ์ปจํ…์ŠคํŠธ\" ์žฅ๋ฅด ๊ธฐ์ค€์„ ๋”ฐ๋ฅธ๋‹ค. ๋‹ด๋ฐฑํ•œ ์„œ์ˆ ์ฒด๋ฅผ
174
+ ์œ ์ง€ํ•˜๋˜ \"~ํ•œ ๊ฒƒ ๊ฐ™์Šต๋‹ˆ๋‹ค\"์˜ ๋ถ€๋“œ๋Ÿฌ์›€์€ ๊นŽ์ง€ ์•Š๋Š”๋‹ค
175
+ - ๋ ˆํฌ ํ…œํ”Œ๋ฆฟ ๊ตฌ์กฐ๋Š” ์žฌ๊ตฌ์„ฑํ•˜์ง€ ์•Š๋Š”๋‹ค. ์„น์…˜ ์ˆœ์„œ, ์ฒดํฌ๋ฐ•์Šค, ํ—ค๋”ฉ์€ ๊ทธ๋Œ€๋กœ ๋‘๊ณ 
176
+ ๋ฌธ์žฅ ํ‘œํ˜„๋งŒ ๋‹ค๋“ฌ๋Š”๋‹ค
177
+
178
+ ์ œ๋ชฉ: <4๋‹จ๊ณ„ PR ์ œ๋ชฉ>
179
+ ๋ณธ๋ฌธ:
180
+ <4๋‹จ๊ณ„ PR ๋ณธ๋ฌธ ์ „์ฒด>
181
+
182
+ ๊ต์ •๋œ ์ œ๋ชฉ๊ณผ ๋ณธ๋ฌธ ์ „์ฒด๋งŒ ๋Œ๋ ค์ค€๋‹ค. ๋“ฑ๊ธ‰, ๋ณ€๊ฒฝ ์š”์•ฝ, ๋ฃฐ๋ถ ์ธ์šฉ, ์–ด๋А ๋ฃฐ์„
183
+ ์ ์šฉํ–ˆ๋Š”์ง€๋Š” ๋Œ๋ ค์ฃผ์ง€ ์•Š๋Š”๋‹ค.
184
+ "
185
+ }
186
+ ```
128
187
 
129
- - **๋ณด์กด ๋Œ€์ƒ**: ์ฝ”๋“œ ๋ธ”๋ก, ํŒŒ์ผ ๊ฒฝ๋กœ, ์ปค๋ฐ‹ ํ•ด์‹œ, ์ˆ˜์น˜, ์ฒดํฌ๋ฆฌ์ŠคํŠธ ํ•ญ๋ชฉ์˜ ์‚ฌ์‹ค ๋‚ด์šฉ์€ ํ•œ ๊ธ€์ž๋„ ๊ฑด๋“œ๋ฆฌ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. `## ํ๋ฆ„ ๋ณ€ํ™” (AS-IS โ†’ TO-BE)` ์„น์…˜์˜ ํ™”์‚ดํ‘œ ๋Œ€๋น„, ํ‘œ, Mermaid ๊ตฌ์กฐ๋„ ๊ทธ๋Œ€๋กœ ๋‘ก๋‹ˆ๋‹ค.
130
- - **์–ดํˆฌ**: `../role-agents/_shared/references/author-voice.md`์˜ "PR ์„ค๋ช…ยท๋ณ€๊ฒฝ ์ปจํ…์ŠคํŠธ" ์žฅ๋ฅด ๊ธฐ์ค€์„ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค. ๋‹ด๋ฐฑํ•œ ์„œ์ˆ ์ฒด๋ฅผ ์œ ์ง€ํ•˜๋˜ "~ํ•œ ๊ฒƒ ๊ฐ™์Šต๋‹ˆ๋‹ค"์˜ ๋ถ€๋“œ๋Ÿฌ์›€์€ ๊นŽ์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
131
- - **๋ ˆํฌ ํ…œํ”Œ๋ฆฟ ๊ตฌ์กฐ๋Š” ์žฌ๊ตฌ์„ฑํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.** 0๋‹จ๊ณ„์—์„œ ๋ฐœ๊ฒฌํ•œ PR ํ…œํ”Œ๋ฆฟ์˜ ์„น์…˜ ์ˆœ์„œ, ์ฒดํฌ๋ฐ•์Šค, ํ—ค๋”ฉ์€ ๊ทธ๋Œ€๋กœ ๋‘๊ณ  ๋ฌธ์žฅ ํ‘œํ˜„๋งŒ ๋‹ค๋“ฌ์Šต๋‹ˆ๋‹ค.
188
+ `humanize-monolith`๋Š” ๊ธฐ๋ณธ ์ถœ๋ ฅ์— `[๋“ฑ๊ธ‰]`๊ณผ `[๋ณ€๊ฒฝ ์š”์•ฝ]`์„ ๋ถ™์ž…๋‹ˆ๋‹ค. PR ๋ณธ๋ฌธ์— ๊ทธ๊ฒŒ ์„ž์ด๋ฉด ์•ˆ ๋˜๋ฏ€๋กœ ์œ„ ํ”„๋กฌํ”„ํŠธ์—์„œ ๋ช…์‹œ์ ์œผ๋กœ ๋บ๋‹ˆ๋‹ค.
132
189
 
133
190
  ์œค๋ฌธ๋œ description์„ **์‚ฌ์šฉ์ž์—๊ฒŒ ๋ฏธ๋ฆฌ๋ณด๊ธฐ๋กœ ๋จผ์ € ํ‘œ์‹œ**ํ•ฉ๋‹ˆ๋‹ค.
134
191