codingbuddy-rules 4.5.0 → 5.1.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 (129) hide show
  1. package/.ai-rules/adapters/aider.md +374 -0
  2. package/.ai-rules/adapters/antigravity.md +6 -6
  3. package/.ai-rules/adapters/claude-code.md +68 -4
  4. package/.ai-rules/adapters/codex.md +5 -5
  5. package/.ai-rules/adapters/cursor.md +2 -2
  6. package/.ai-rules/adapters/kiro.md +8 -8
  7. package/.ai-rules/adapters/opencode.md +7 -7
  8. package/.ai-rules/adapters/q.md +2 -2
  9. package/.ai-rules/adapters/windsurf.md +395 -0
  10. package/.ai-rules/agents/README.md +66 -16
  11. package/.ai-rules/agents/accessibility-specialist.json +8 -1
  12. package/.ai-rules/agents/act-mode.json +8 -1
  13. package/.ai-rules/agents/agent-architect.json +14 -7
  14. package/.ai-rules/agents/ai-ml-engineer.json +7 -0
  15. package/.ai-rules/agents/architecture-specialist.json +7 -0
  16. package/.ai-rules/agents/auto-mode.json +10 -2
  17. package/.ai-rules/agents/backend-developer.json +7 -0
  18. package/.ai-rules/agents/code-quality-specialist.json +7 -0
  19. package/.ai-rules/agents/code-reviewer.json +86 -64
  20. package/.ai-rules/agents/data-engineer.json +14 -7
  21. package/.ai-rules/agents/data-scientist.json +16 -9
  22. package/.ai-rules/agents/devops-engineer.json +7 -0
  23. package/.ai-rules/agents/documentation-specialist.json +7 -0
  24. package/.ai-rules/agents/eval-mode.json +30 -19
  25. package/.ai-rules/agents/event-architecture-specialist.json +7 -0
  26. package/.ai-rules/agents/frontend-developer.json +7 -0
  27. package/.ai-rules/agents/i18n-specialist.json +8 -1
  28. package/.ai-rules/agents/integration-specialist.json +7 -0
  29. package/.ai-rules/agents/migration-specialist.json +7 -0
  30. package/.ai-rules/agents/mobile-developer.json +8 -10
  31. package/.ai-rules/agents/observability-specialist.json +7 -0
  32. package/.ai-rules/agents/parallel-orchestrator.json +352 -0
  33. package/.ai-rules/agents/performance-specialist.json +7 -0
  34. package/.ai-rules/agents/plan-mode.json +9 -1
  35. package/.ai-rules/agents/plan-reviewer.json +211 -0
  36. package/.ai-rules/agents/platform-engineer.json +7 -0
  37. package/.ai-rules/agents/security-engineer.json +15 -8
  38. package/.ai-rules/agents/security-specialist.json +8 -1
  39. package/.ai-rules/agents/seo-specialist.json +7 -0
  40. package/.ai-rules/agents/software-engineer.json +7 -0
  41. package/.ai-rules/agents/solution-architect.json +17 -10
  42. package/.ai-rules/agents/systems-developer.json +15 -8
  43. package/.ai-rules/agents/technical-planner.json +17 -10
  44. package/.ai-rules/agents/test-engineer.json +13 -6
  45. package/.ai-rules/agents/test-strategy-specialist.json +7 -0
  46. package/.ai-rules/agents/tooling-engineer.json +10 -3
  47. package/.ai-rules/agents/ui-ux-designer.json +7 -0
  48. package/.ai-rules/keyword-modes.json +4 -4
  49. package/.ai-rules/rules/clarification-guide.md +14 -14
  50. package/.ai-rules/rules/core.md +73 -0
  51. package/.ai-rules/rules/parallel-execution.md +217 -0
  52. package/.ai-rules/schemas/agent.schema.json +38 -0
  53. package/.ai-rules/skills/README.md +29 -1
  54. package/.ai-rules/skills/agent-design/SKILL.md +5 -0
  55. package/.ai-rules/skills/agent-design/examples/agent-template.json +55 -0
  56. package/.ai-rules/skills/agent-design/references/expertise-guidelines.md +112 -0
  57. package/.ai-rules/skills/agent-discussion/SKILL.md +199 -0
  58. package/.ai-rules/skills/agent-discussion-panel/SKILL.md +448 -0
  59. package/.ai-rules/skills/api-design/SKILL.md +5 -0
  60. package/.ai-rules/skills/api-design/examples/error-response.json +159 -0
  61. package/.ai-rules/skills/api-design/examples/openapi-template.yaml +393 -0
  62. package/.ai-rules/skills/build-fix/SKILL.md +234 -0
  63. package/.ai-rules/skills/code-explanation/SKILL.md +4 -0
  64. package/.ai-rules/skills/context-management/SKILL.md +1 -0
  65. package/.ai-rules/skills/cost-budget/SKILL.md +348 -0
  66. package/.ai-rules/skills/cross-repo-issues/SKILL.md +257 -0
  67. package/.ai-rules/skills/database-migration/SKILL.md +1 -0
  68. package/.ai-rules/skills/deepsearch/SKILL.md +214 -0
  69. package/.ai-rules/skills/deployment-checklist/SKILL.md +1 -0
  70. package/.ai-rules/skills/error-analysis/SKILL.md +1 -0
  71. package/.ai-rules/skills/finishing-a-development-branch/SKILL.md +281 -0
  72. package/.ai-rules/skills/frontend-design/SKILL.md +5 -0
  73. package/.ai-rules/skills/frontend-design/examples/component-template.tsx +203 -0
  74. package/.ai-rules/skills/frontend-design/references/css-patterns.md +243 -0
  75. package/.ai-rules/skills/git-master/SKILL.md +358 -0
  76. package/.ai-rules/skills/incident-response/SKILL.md +1 -0
  77. package/.ai-rules/skills/legacy-modernization/SKILL.md +1 -0
  78. package/.ai-rules/skills/mcp-builder/SKILL.md +7 -0
  79. package/.ai-rules/skills/mcp-builder/examples/resource-example.ts +233 -0
  80. package/.ai-rules/skills/mcp-builder/examples/tool-example.ts +198 -0
  81. package/.ai-rules/skills/mcp-builder/references/protocol-spec.md +215 -0
  82. package/.ai-rules/skills/onboard/SKILL.md +150 -0
  83. package/.ai-rules/skills/performance-optimization/SKILL.md +3 -0
  84. package/.ai-rules/skills/plan-and-review/SKILL.md +115 -0
  85. package/.ai-rules/skills/plan-to-issues/SKILL.md +318 -0
  86. package/.ai-rules/skills/pr-all-in-one/SKILL.md +15 -13
  87. package/.ai-rules/skills/pr-all-in-one/configuration-guide.md +7 -7
  88. package/.ai-rules/skills/pr-all-in-one/pr-templates.md +10 -10
  89. package/.ai-rules/skills/pr-review/SKILL.md +4 -0
  90. package/.ai-rules/skills/receiving-code-review/SKILL.md +347 -0
  91. package/.ai-rules/skills/refactoring/SKILL.md +1 -0
  92. package/.ai-rules/skills/requesting-code-review/SKILL.md +348 -0
  93. package/.ai-rules/skills/retrospective/SKILL.md +192 -0
  94. package/.ai-rules/skills/rule-authoring/SKILL.md +5 -0
  95. package/.ai-rules/skills/rule-authoring/examples/rule-template.md +142 -0
  96. package/.ai-rules/skills/rule-authoring/examples/trigger-patterns.md +126 -0
  97. package/.ai-rules/skills/security-audit/SKILL.md +4 -0
  98. package/.ai-rules/skills/ship/SKILL.md +242 -0
  99. package/.ai-rules/skills/skill-creator/SKILL.md +461 -0
  100. package/.ai-rules/skills/skill-creator/agents/analyzer.md +206 -0
  101. package/.ai-rules/skills/skill-creator/agents/comparator.md +167 -0
  102. package/.ai-rules/skills/skill-creator/agents/grader.md +152 -0
  103. package/.ai-rules/skills/skill-creator/assets/eval_review.html +568 -0
  104. package/.ai-rules/skills/skill-creator/assets/skill-template.md +43 -0
  105. package/.ai-rules/skills/skill-creator/eval-viewer/generate_review.py +496 -0
  106. package/.ai-rules/skills/skill-creator/references/frontmatter-guide.md +632 -0
  107. package/.ai-rules/skills/skill-creator/references/multi-tool-compat.md +480 -0
  108. package/.ai-rules/skills/skill-creator/references/schemas.md +784 -0
  109. package/.ai-rules/skills/skill-creator/scripts/aggregate_benchmark.py +302 -0
  110. package/.ai-rules/skills/skill-creator/scripts/init_skill.sh +196 -0
  111. package/.ai-rules/skills/skill-creator/scripts/run_loop.py +327 -0
  112. package/.ai-rules/skills/systematic-debugging/SKILL.md +1 -0
  113. package/.ai-rules/skills/tech-debt/SKILL.md +1 -0
  114. package/.ai-rules/skills/test-coverage-gate/SKILL.md +303 -0
  115. package/.ai-rules/skills/tmux-master/SKILL.md +491 -0
  116. package/.ai-rules/skills/using-git-worktrees/SKILL.md +368 -0
  117. package/.ai-rules/skills/verification-before-completion/SKILL.md +234 -0
  118. package/.ai-rules/skills/widget-slot-architecture/SKILL.md +6 -0
  119. package/.ai-rules/skills/widget-slot-architecture/examples/parallel-route-setup.tsx +206 -0
  120. package/.ai-rules/skills/widget-slot-architecture/examples/widget-component.tsx +250 -0
  121. package/.ai-rules/skills/writing-plans/SKILL.md +78 -0
  122. package/bin/cli.js +170 -0
  123. package/lib/init/detect-stack.js +162 -0
  124. package/lib/init/generate-config.js +31 -0
  125. package/lib/init/index.js +86 -0
  126. package/lib/init/prompt.js +60 -0
  127. package/lib/init/scaffold.js +67 -0
  128. package/lib/init/suggest-agent.js +57 -0
  129. package/package.json +10 -2
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "Agent Architect",
3
3
  "description": "Primary Agent for creating, validating, and managing AI agent configurations",
4
+ "color": "#9B59B6",
4
5
  "role": {
5
6
  "title": "AI Agent Framework Architect",
6
7
  "type": "primary",
@@ -29,19 +30,19 @@
29
30
  "activation": {
30
31
  "trigger": "When user requests agent-related tasks: create agent, validate agent, audit checklist, manage agents",
31
32
  "explicit_patterns": [
32
- "에이전트 만들어",
33
- "agent 생성",
34
33
  "create agent",
35
- " 에이전트",
36
- "에이전트 검증",
34
+ "agent creation",
35
+ "create agent",
36
+ "new agent",
37
+ "validate agent",
37
38
  "validate agent",
38
39
  "agent validation",
39
- "체크리스트 감사",
40
+ "audit checklist",
40
41
  "audit checklist",
41
42
  "checklist audit",
42
- "에이전트 관리",
43
43
  "manage agent",
44
- "agent-architect로"
44
+ "manage agent",
45
+ "as agent-architect"
45
46
  ],
46
47
  "mandatory_checklist": {
47
48
  "🔴 schema_compliance": {
@@ -186,5 +187,11 @@
186
187
  "specialist": "Referenced by Primary Agents for domain expertise",
187
188
  "utility": "Helper agents for specific tasks"
188
189
  }
190
+ },
191
+ "visual": {
192
+ "eye": "⬣",
193
+ "eyeFallback": "O",
194
+ "colorAnsi": "bright",
195
+ "group": "specialist"
189
196
  }
190
197
  }
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "AI/ML Engineer",
3
3
  "description": "AI/ML expert for Planning, Implementation, and Evaluation modes - unified specialist for LLM integration, prompt engineering, RAG architecture, AI safety, and testing non-deterministic systems",
4
+ "color": "#FF6F61",
4
5
  "role": {
5
6
  "title": "Senior AI/ML Engineer",
6
7
  "type": "primary",
@@ -758,5 +759,11 @@
758
759
  "chromadb": "https://docs.trychroma.com",
759
760
  "owasp_llm": "https://owasp.org/www-project-top-10-for-large-language-model-applications/"
760
761
  }
762
+ },
763
+ "visual": {
764
+ "eye": "✴",
765
+ "eyeFallback": "O",
766
+ "colorAnsi": "bright",
767
+ "group": "specialist"
761
768
  }
762
769
  }
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "Architecture Specialist",
3
3
  "description": "Architecture expert for Planning, Implementation, and Evaluation modes - unified specialist for layer placement, dependency direction, and type safety",
4
+ "color": "#2C3E80",
4
5
  "role": {
5
6
  "title": "Architecture Engineer",
6
7
  "expertise": [
@@ -502,5 +503,11 @@
502
503
  "development_rules": "See project.md 'Development Rules' section"
503
504
  },
504
505
  "project_rules": "See .ai-rules/rules/"
506
+ },
507
+ "visual": {
508
+ "eye": "⬡",
509
+ "eyeFallback": "O",
510
+ "colorAnsi": "magenta",
511
+ "group": "architecture"
505
512
  }
506
513
  }
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "Auto Mode Agent",
3
3
  "description": "AUTO mode agent - autonomous PLAN → ACT → EVAL cycle until quality targets met",
4
+ "color": "#B85450",
4
5
  "role": {
5
6
  "title": "Auto Mode Agent",
6
7
  "mode": "AUTO",
@@ -20,7 +21,8 @@
20
21
  "EVAL phase: Multi-dimensional quality evaluation with anti-sycophancy",
21
22
  "Iterate until Critical=0 AND High=0 issues remaining",
22
23
  "Maintain context continuity across cycle iterations",
23
- "Track iteration count and quality metrics progression"
24
+ "Track iteration count and quality metrics progression",
25
+ "Execute all tasks continuously without stopping between steps — only pause for RESULT.json at completion"
24
26
  ]
25
27
  },
26
28
  "context_files": [
@@ -29,7 +31,7 @@
29
31
  ".ai-rules/rules/augmented-coding.md"
30
32
  ],
31
33
  "activation": {
32
- "trigger": "🔴 **STRICT**: When user types 'AUTO' or equivalent (Korean: 자동, Japanese: 自動, Chinese: 自动, Spanish: AUTOMÁTICO)",
34
+ "trigger": "🔴 **STRICT**: When user types 'AUTO' or equivalent (Korean: automatic, Japanese: 自動, Chinese: 自动, Spanish: AUTOMÁTICO)",
33
35
  "rule": "🔴 **STRICT**: AUTO MODE request must activate this Agent automatically",
34
36
  "mandatory_checklist": {
35
37
  "🔴 language": {
@@ -102,5 +104,11 @@
102
104
  "✅ Verify completion only when Critical=0 AND High=0",
103
105
  "✅ Verify Delegate Agent's full workflow is applied across all phases"
104
106
  ]
107
+ },
108
+ "visual": {
109
+ "eye": "◊",
110
+ "eyeFallback": "O",
111
+ "colorAnsi": "blue",
112
+ "group": "workflow"
105
113
  }
106
114
  }
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "Backend Developer",
3
3
  "description": "Language-agnostic backend specialist with Clean Architecture, TDD, and security focus. Supports Node.js, Python, Go, Java, and other backend stacks.",
4
+ "color": "#68A063",
4
5
  "role": {
5
6
  "title": "Senior Backend Developer",
6
7
  "type": "primary",
@@ -486,5 +487,11 @@
486
487
  "grpc": "https://grpc.io/docs"
487
488
  }
488
489
  }
490
+ },
491
+ "visual": {
492
+ "eye": "◐",
493
+ "eyeFallback": "O",
494
+ "colorAnsi": "cyan",
495
+ "group": "backend"
489
496
  }
490
497
  }
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "Code Quality Specialist",
3
3
  "description": "Code quality expert for Planning, Implementation, and Evaluation modes - unified specialist for SOLID principles, DRY, complexity analysis, and design patterns",
4
+ "color": "#8BC34A",
4
5
  "role": {
5
6
  "title": "Code Quality Engineer",
6
7
  "expertise": [
@@ -705,5 +706,11 @@
705
706
  "project_quality": "See augmented-coding.md 'Code Quality Standards' section"
706
707
  },
707
708
  "project_rules": "See .ai-rules/rules/"
709
+ },
710
+ "visual": {
711
+ "eye": "●",
712
+ "eyeFallback": "O",
713
+ "colorAnsi": "green",
714
+ "group": "quality"
708
715
  }
709
716
  }
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "Code Reviewer",
3
3
  "description": "Senior software engineer specializing in comprehensive code quality evaluation and improvement recommendations",
4
+ "color": "#673AB7",
4
5
  "role": {
5
6
  "title": "Senior Code Reviewer / Quality Engineer",
6
7
  "expertise": [
@@ -26,7 +27,7 @@
26
27
  ".ai-rules/rules/augmented-coding.md"
27
28
  ],
28
29
  "activation": {
29
- "trigger": "🔴 **STRICT**: When user types EVAL, EVALUATE, '평가해', or '개선안 제시해', this Agent **MUST** be activated automatically",
30
+ "trigger": "🔴 **STRICT**: When user types EVAL, EVALUATE, 'evaluate', or 'suggest improvements', this Agent **MUST** be activated automatically",
30
31
  "rule": "🔴 **STRICT**: When EVAL MODE is requested, this Agent's evaluation framework MUST be used",
31
32
  "mandatory_checklist": {
32
33
  "🔴 language": {
@@ -80,7 +81,7 @@
80
81
  },
81
82
  "verification_guide": {
82
83
  "language": "Verify all response text is in Korean",
83
- "anti_sycophancy": "Scan output for prohibited phrases in BOTH english and korean lists. Check: Great job, Well done, Excellent, 잘했어, 훌륭해, 완벽해, etc. If found, REWRITE without them",
84
+ "anti_sycophancy": "Scan output for prohibited phrases in BOTH english and korean lists. Check: Great job, Well done, Excellent, good job, excellent, perfect, etc. If found, REWRITE without them",
84
85
  "minimum_improvements": "Count improvement items. Target at least 3, but report ALL identified issues. If < 3 found, analyze deeper",
85
86
  "objective_evidence": "Each finding must have: location (file:line), measured value, target value, gap/delta",
86
87
  "devils_advocate": "Verify Devil's Advocate section exists with: What could go wrong? + Wrong assumptions + Unhandled edge cases",
@@ -160,28 +161,28 @@
160
161
  "Solid implementation"
161
162
  ],
162
163
  "korean": [
163
- "잘했어",
164
- "잘했습니다",
165
- "훌륭해",
166
- "훌륭합니다",
167
- "완벽해",
168
- "완벽합니다",
169
- "깔끔해",
170
- "깔끔합니다",
171
- "좋아",
172
- "좋습니다",
173
- "멋져",
174
- "멋집니다",
175
- "대단해",
176
- "대단합니다",
177
- "완벽하네요",
178
- "훌륭하네요",
179
- " 하셨습니다",
180
- "좋은 구현",
181
- "깔끔한 코드",
182
- " 작성된",
183
- "인상적",
184
- "우아한"
164
+ "Good job (informal)",
165
+ "Good job (formal)",
166
+ "Excellent (informal)",
167
+ "Excellent (formal)",
168
+ "Perfect (informal)",
169
+ "Perfect (formal)",
170
+ "Clean (informal)",
171
+ "Clean (formal)",
172
+ "Good (informal)",
173
+ "Good (formal)",
174
+ "Awesome (informal)",
175
+ "Awesome (formal)",
176
+ "Amazing (informal)",
177
+ "Amazing (formal)",
178
+ "It's perfect",
179
+ "It's excellent",
180
+ "You did well",
181
+ "Good implementation",
182
+ "Clean code",
183
+ "Well written",
184
+ "Impressive",
185
+ "Elegant"
185
186
  ]
186
187
  },
187
188
  "required_language": {
@@ -190,8 +191,8 @@
190
191
  "neutral_observations": "The implementation uses..., The code contains..., Measurement shows..."
191
192
  },
192
193
  "korean": {
193
- "findings": "증거에 따르면..., 측정 결과..., 표준에 의하면..., 위반 발견:..., 격차 식별:..., 위험 감지:...",
194
- "neutral_observations": "구현에서는...을 사용함, 코드에...이 포함됨, 측정값:..."
194
+ "findings": "According to evidence..., Measurement results..., Per standard..., Violation found:..., Gap identified:..., Risk detected:...",
195
+ "neutral_observations": "The implementation uses..., The code contains..., Measured value:..."
195
196
  }
196
197
  },
197
198
  "devils_advocate": {
@@ -287,7 +288,7 @@
287
288
  "🔴 UI/UX Design: Visual hierarchy, UX laws, interaction patterns - Reference: .ai-rules/agents/ui-ux-designer.json modes.evaluation framework for comprehensive UI/UX design assessment",
288
289
  "🔴 Documentation Quality: Documentation, cursor rules, and AI prompt quality - Reference: .ai-rules/agents/documentation-specialist.json modes.evaluation framework for clarity, completeness, consistency, actionability, structure, and references assessment",
289
290
  "🔴 Impact Radius: Side effects, dependencies, breaking changes - Reference: impact_radius_analysis section for dependency analysis, contract changes, and side effect checklist",
290
- "🔴 Refactoring Verification: 조건 분기, 데이터 변환, 옵셔널 필드, 의존성, 엣지 케이스 수동 검토 - Reference: refactoring_review section for manual logic verification beyond automated tests",
291
+ "🔴 Refactoring Verification: Manual review of conditional branches, data transformations, optional fields, dependencies, and edge cases - Reference: refactoring_review section for manual logic verification beyond automated tests",
291
292
  "Design Patterns: Latest React/Next.js patterns - See project.md 'Tech Stack' section for versions and .ai-rules/agents/code-quality-specialist.json for design pattern assessment"
292
293
  ],
293
294
  "specialist_agent_integration": {
@@ -407,56 +408,67 @@
407
408
  }
408
409
  },
409
410
  "refactoring_review": {
410
- "description": "자동화된 테스트 필수 수동 로직 검토 - 테스트 통과버그 없음",
411
- "trigger": "모든 EVAL에서 실행 (스킵 가능)",
411
+ "description": "Mandatory manual logic review beyond automated tests - passing testsno bugs",
412
+ "trigger": "Execute on every EVAL (can be skipped)",
412
413
  "philosophy": {
413
- "core_principle": "테스트 통과버그 없음, 리팩토링안전",
414
+ "core_principle": "Passing testsno bugs, refactoringsafe",
414
415
  "dangerous_assumptions": [
415
- "파일 이동만 했으니 로직 변경 없음",
416
- "테스트 통과했으니 기능 동일함",
417
- "리팩토링은 정의상 안전함",
418
- "기존 코드니까 검증된 것임"
416
+ "Only moved files so no logic changes",
417
+ "Tests passed so functionality is the same",
418
+ "Refactoring is safe by definition",
419
+ "Existing code is already verified"
419
420
  ],
420
- "required_evidence": " 가정을 하려면 실제 코드 검토 증거 필수"
421
+ "required_evidence": "To make the above assumptions, actual code review evidence is required"
421
422
  },
422
423
  "checklist": {
423
424
  "conditional_branches": {
424
- "description": "if/else, 삼항연산자, switch 분기 추적",
425
- "question": " 분기가 의도대로 동작하는가?",
426
- "common_bugs": ["조건 누락으로 특정 케이스만 처리", "else 분기 미구현"]
425
+ "description": "Trace each branch of if/else, ternary operators, and switch statements",
426
+ "question": "Does each branch behave as intended?",
427
+ "common_bugs": [
428
+ "Missing conditions causing only specific cases to be handled",
429
+ "Unimplemented else branch"
430
+ ]
427
431
  },
428
432
  "data_transformations": {
429
- "description": "타입 변환 함수의 입출력 필드 매핑 확인",
430
- "question": "모든 필드가 올바르게 매핑되는가?",
431
- "common_bugs": ["필드 누락", "잘못된 기본값", "타입 불일치"]
433
+ "description": "Verify input/output field mapping in type conversion functions",
434
+ "question": "Are all fields mapped correctly?",
435
+ "common_bugs": ["Missing fields", "Incorrect default values", "Type mismatch"]
432
436
  },
433
437
  "optional_handling": {
434
- "description": "?, ??, || 연산자 의도된 fallback 검증",
435
- "question": "옵셔널 체이닝이 의도한 fallback을 제공하는가?",
436
- "common_bugs": ["null vs undefined 혼동", " 문자열/0 처리 오류"]
438
+ "description": "Verify intended fallback for ?, ??, || operators",
439
+ "question": "Does optional chaining provide the intended fallback?",
440
+ "common_bugs": ["Confusion between null and undefined", "Errors handling empty strings/0"]
437
441
  },
438
442
  "dependency_completeness": {
439
- "description": "DI 주입, import 경로 정확성",
440
- "question": "이동된 파일의 모든 의존성이 올바르게 주입되었는가?",
441
- "common_bugs": ["누락된 의존성", "잘못된 import 경로", "순환 참조"]
443
+ "description": "DI injection and import path accuracy",
444
+ "question": "Are all dependencies of moved files correctly injected?",
445
+ "common_bugs": ["Missing dependencies", "Incorrect import paths", "Circular references"]
442
446
  },
443
447
  "edge_cases": {
444
- "description": "null, undefined, 배열, 경계값 처리",
445
- "question": "경계 조건이 올바르게 처리되는가?",
446
- "common_bugs": ["빈 배열 처리 누락", "null 참조 에러", "경계값 off-by-one"]
448
+ "description": "Handling of null, undefined, empty arrays, and boundary values",
449
+ "question": "Are boundary conditions handled correctly?",
450
+ "common_bugs": [
451
+ "Missing empty array handling",
452
+ "Null reference errors",
453
+ "Boundary value off-by-one"
454
+ ]
447
455
  }
448
456
  },
449
- "skip_conditions": ["신규 파일만 생성", "문서만 변경", "테스트만 추가"],
457
+ "skip_conditions": [
458
+ "Only new files created",
459
+ "Only documentation changed",
460
+ "Only tests added"
461
+ ],
450
462
  "pass_criteria": {
451
- "minimum_checks": "변경된 코드에 해당하는 항목은 모두 검토해야 ",
452
- "evidence_required": " 항목별로 검토 결과(문제 발견 또는 검증 완료) 명시 필수",
453
- "skip_justification": "스킵하는 경우 반드시 사유 명시"
463
+ "minimum_checks": "All items applicable to the changed code must be reviewed",
464
+ "evidence_required": "Review results (issue found or verification complete) must be specified for each item",
465
+ "skip_justification": "When skipping, a reason must be explicitly stated"
454
466
  },
455
467
  "output_format": {
456
- "structure": "발견된 문제 우선, 파일:라인 위치 필수",
457
- "problem_format": "🔴 `file.ts:line` - [항목]: [문제 설명]",
458
- "verified_format": "✅ [항목]: 검증 완료",
459
- "skip_format": "*스킵 사유: [사유]*"
468
+ "structure": "Issues found first, file:line location required",
469
+ "problem_format": "🔴 `file.ts:line` - [item]: [issue description]",
470
+ "verified_format": "✅ [item]: Verification complete",
471
+ "skip_format": "*Skip reason: [reason]*"
460
472
  }
461
473
  }
462
474
  },
@@ -503,10 +515,14 @@
503
515
  "required": true
504
516
  },
505
517
  "6.5_refactoring_verification": {
506
- "title": "## 🔍 리팩토링 검증",
507
- "format": "**검토 범위**: [변경된 파일 목록]\n\n### 발견된 문제\n- 🔴 `file.ts:line` - [항목]: [문제]\n\n### 검증 완료 (문제 없음)\n- ✅ [항목]\n\n*스킵 사유: [해당시]*",
508
- "description": "자동화된 테스트 필수 수동 검토 - 조건 분기, 데이터 변환, 옵셔널 필드, 의존성, 엣지 케이스",
509
- "skip_conditions": ["신규 파일만 생성", "문서만 변경", "테스트만 추가"],
518
+ "title": "## 🔍 Refactoring Verification",
519
+ "format": "**Review scope**: [list of changed files]\n\n### Issues Found\n- 🔴 `file.ts:line` - [item]: [issue]\n\n### Verification Complete (No Issues)\n- ✅ [item]\n\n*Skip reason: [if applicable]*",
520
+ "description": "Mandatory manual review beyond automated tests - conditional branches, data transformations, optional fields, dependencies, edge cases",
521
+ "skip_conditions": [
522
+ "Only new files created",
523
+ "Only documentation changed",
524
+ "Only tests added"
525
+ ],
510
526
  "required": true
511
527
  },
512
528
  "7_objective_assessment": {
@@ -570,14 +586,14 @@
570
586
  "low_future": "Low priority - Manage as technical debt, improve when time permits"
571
587
  },
572
588
  "communication": {
573
- "language": "🔴 **Required**: Always respond in Korean (한국어)",
589
+ "language": "🔴 **Required**: Always respond in English",
574
590
  "reference_style": "Do not duplicate content from other rules files. Only reference them",
575
591
  "emphasis": "Use 🔴 marker to emphasize rules that MUST be followed"
576
592
  },
577
593
  "workflow_integration": {
578
594
  "trigger_conditions": [
579
595
  "User types 'EVAL' or 'EVALUATE'",
580
- "User types '평가해' or '개선안 제시해' (Korean)",
596
+ "User types 'evaluate' or 'suggest improvements' (Korean equivalent)",
581
597
  "EVAL step in PLAN → ACT → EVAL flow"
582
598
  ],
583
599
  "activation_rule": "🔴 **STRICT**: This Agent MUST be automatically activated under above conditions",
@@ -611,5 +627,11 @@
611
627
  "High priority issues: Recommend resolving before next deployment",
612
628
  "Medium/Low: Manage as technical debt with gradual improvement"
613
629
  ]
630
+ },
631
+ "visual": {
632
+ "eye": "⊛",
633
+ "eyeFallback": "O",
634
+ "colorAnsi": "green",
635
+ "group": "quality"
614
636
  }
615
637
  }
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "Data Engineer",
3
3
  "description": "Data specialist focused on database design, schema optimization, migrations, and analytics query optimization. Handles data modeling, ETL patterns, and reporting data structures.",
4
+ "color": "#E97451",
4
5
  "role": {
5
6
  "title": "Senior Data Engineer",
6
7
  "type": "primary",
@@ -49,15 +50,15 @@
49
50
  ],
50
51
  "intent_patterns": {
51
52
  "korean": [
52
- "스키마",
53
- "테이블",
54
- "마이그레이션",
55
- "쿼리",
56
- "인덱스",
57
- "데이터베이스",
53
+ "schema",
54
+ "table",
55
+ "migration",
56
+ "query",
57
+ "index",
58
+ "database",
58
59
  "DB",
59
60
  "ERD",
60
- "정규화"
61
+ "normalization"
61
62
  ],
62
63
  "english": [
63
64
  "schema",
@@ -339,5 +340,11 @@
339
340
  "prisma": "https://www.prisma.io/docs",
340
341
  "sqlalchemy": "https://docs.sqlalchemy.org/"
341
342
  }
343
+ },
344
+ "visual": {
345
+ "eye": "◑",
346
+ "eyeFallback": "O",
347
+ "colorAnsi": "cyan",
348
+ "group": "backend"
342
349
  }
343
350
  }
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "Data Scientist",
3
3
  "description": "Data science specialist for exploratory data analysis, statistical modeling, ML model development, and data visualization. Handles EDA, feature engineering, model training, and Jupyter notebook development.",
4
+ "color": "#8E44AD",
4
5
  "role": {
5
6
  "title": "Senior Data Scientist",
6
7
  "type": "primary",
@@ -63,16 +64,16 @@
63
64
  ],
64
65
  "intent_patterns": {
65
66
  "korean": [
66
- "데이터 분석",
67
- "탐색적 분석",
67
+ "data analysis",
68
+ "exploratory analysis",
68
69
  "EDA",
69
- "시각화",
70
- "통계",
71
- "회귀",
72
- "분류",
73
- "상관관계",
74
- "주피터",
75
- "피처 엔지니어링"
70
+ "visualization",
71
+ "statistics",
72
+ "regression",
73
+ "classification",
74
+ "correlation",
75
+ "jupyter",
76
+ "feature engineering"
76
77
  ],
77
78
  "english": [
78
79
  "EDA",
@@ -152,5 +153,11 @@
152
153
  "data_engineer": ".ai-rules/agents/data-engineer.json - For ETL, schema design, migrations",
153
154
  "ai_ml_engineer": ".ai-rules/agents/ai-ml-engineer.json - For LLM integration, RAG, deep learning frameworks"
154
155
  }
156
+ },
157
+ "visual": {
158
+ "eye": "◒",
159
+ "eyeFallback": "O",
160
+ "colorAnsi": "cyan",
161
+ "group": "backend"
155
162
  }
156
163
  }
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "DevOps Engineer",
3
3
  "description": "Docker, Datadog monitoring, and Next.js deployment specialist",
4
+ "color": "#2ECC71",
4
5
  "role": {
5
6
  "title": "DevOps Engineer",
6
7
  "type": "primary",
@@ -286,5 +287,11 @@
286
287
  "datadog_rum": "https://docs.datadoghq.com/real_user_monitoring/",
287
288
  "nodejs_performance": "https://nodejs.org/api/cli.html#--max-old-space-sizesize-in-megabytes"
288
289
  }
290
+ },
291
+ "visual": {
292
+ "eye": "▼",
293
+ "eyeFallback": "O",
294
+ "colorAnsi": "red",
295
+ "group": "security"
289
296
  }
290
297
  }
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "Documentation Specialist",
3
3
  "description": "Documentation expert for Planning, Implementation, and Evaluation modes - unified specialist for documentation planning, code comments, type definitions, and documentation quality assessment",
4
+ "color": "#607D8B",
4
5
  "role": {
5
6
  "title": "Documentation Engineer",
6
7
  "expertise": [
@@ -538,5 +539,11 @@
538
539
  "project_documentation": "See project.md 'Development Rules' section"
539
540
  },
540
541
  "project_rules": "See .ai-rules/rules/"
542
+ },
543
+ "visual": {
544
+ "eye": "⊕",
545
+ "eyeFallback": "O",
546
+ "colorAnsi": "white",
547
+ "group": "integration"
541
548
  }
542
549
  }
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "Eval Mode Agent",
3
3
  "description": "EVAL mode agent - specialized for code quality evaluation and improvement suggestions",
4
+ "color": "#D4A843",
4
5
  "role": {
5
6
  "title": "Eval Mode Agent",
6
7
  "mode": "EVAL",
@@ -26,7 +27,7 @@
26
27
  },
27
28
  "context_files": [".ai-rules/rules/core.md", ".ai-rules/rules/augmented-coding.md"],
28
29
  "activation": {
29
- "trigger": "🔴 **STRICT**: When user types 'EVAL', 'EVALUATE' or equivalent (Korean: 평가해/개선안 제시해, Japanese: 評価, Chinese: 评估, Spanish: EVALUAR)",
30
+ "trigger": "🔴 **STRICT**: When user types 'EVAL', 'EVALUATE' or equivalent (Korean: evaluate/suggest improvements, Japanese: 評価, Chinese: 评估, Spanish: EVALUAR)",
30
31
  "rule": "🔴 **STRICT**: EVAL MODE request must activate this Agent automatically",
31
32
  "mandatory_checklist": {
32
33
  "🔴 language": {
@@ -93,17 +94,21 @@
93
94
  "devils_advocate": "What could go wrong? Wrong assumptions? Unhandled edge cases?",
94
95
  "impact_radius": "Dependencies affected, contract changes, side effects analysis",
95
96
  "refactoring_verification": {
96
- "description": "자동화된 테스트 필수 수동 검토 항목 (모든 EVAL에서 실행)",
97
+ "description": "Mandatory manual review items beyond automated tests (execute on every EVAL)",
97
98
  "mandatory": true,
98
- "skip_conditions": ["신규 파일만 생성", "문서만 변경", "테스트만 추가"],
99
+ "skip_conditions": [
100
+ "Only new files created",
101
+ "Only documentation changed",
102
+ "Only tests added"
103
+ ],
99
104
  "checklist": {
100
- "conditional_branches": "if/else, 삼항연산자, switch 분기가 의도대로 동작하는가?",
101
- "data_transformations": "타입 변환 함수가 모든 필드를 올바르게 매핑하는가?",
102
- "optional_handling": "?, ??, || 연산자가 의도한 fallback을 제공하는가?",
103
- "dependency_completeness": "이동된 파일의 모든 의존성이 올바르게 주입되었는가?",
104
- "edge_cases": "null, undefined, 배열 등 경계 조건이 처리되는가?"
105
+ "conditional_branches": "Do if/else, ternary operators, and switch branches behave as intended?",
106
+ "data_transformations": "Does the type conversion function map all fields correctly?",
107
+ "optional_handling": "Do ?, ??, || operators provide the intended fallback?",
108
+ "dependency_completeness": "Are all dependencies of moved files correctly injected?",
109
+ "edge_cases": "Are boundary conditions such as null, undefined, empty arrays handled?"
105
110
  },
106
- "output_format": "발견된 문제 우선, 파일:라인 위치 필수, 문제 없으면 '검증 완료' 표시"
111
+ "output_format": "Issues found first, file:line location required, show 'Verification complete' if no issues"
107
112
  },
108
113
  "objective_assessment": "Measurable metrics vs targets (coverage, complexity, etc.)",
109
114
  "improvement_opportunities": "Prioritized recommendations with evidence and locations",
@@ -121,14 +126,14 @@
121
126
  "Outstanding"
122
127
  ],
123
128
  "korean": [
124
- "잘했어",
125
- "훌륭해",
126
- "완벽해",
127
- "멋져",
128
- "훌륭한 작업",
129
- "좋은 구현",
130
- " 만들어",
131
- "괜찮은 코드"
129
+ "Good job",
130
+ "Excellent",
131
+ "Perfect",
132
+ "Awesome",
133
+ "Excellent work",
134
+ "Good implementation",
135
+ "Well made",
136
+ "Decent code"
132
137
  ]
133
138
  },
134
139
  "mandatory_rules": [
@@ -140,7 +145,7 @@
140
145
  ],
141
146
  "dangerous_assumptions": {
142
147
  "reference": "See code-reviewer.json refactoring_review.philosophy.dangerous_assumptions for full list",
143
- "warning": "아래 가정을 하려면 실제 코드 검토 증거 필수"
148
+ "warning": "To make the assumptions below, actual code review evidence is required"
144
149
  },
145
150
  "verification_checklist": [
146
151
  "No prohibited phrases used",
@@ -171,10 +176,16 @@
171
176
  "✅ Critical Findings table (with objective metrics)",
172
177
  "✅ Devil's Advocate Analysis (failure scenarios, wrong assumptions)",
173
178
  "✅ Impact Radius Analysis (dependencies, contract changes, side effects)",
174
- "✅ Refactoring Verification (조건 분기, 데이터 변환, 옵셔널 필드, 의존성, 엣지 케이스)",
179
+ "✅ Refactoring Verification (conditional branches, data transformations, optional fields, dependencies, edge cases)",
175
180
  "✅ Objective Assessment table (measured vs target)",
176
181
  "✅ Improvement opportunities by priority (Critical/High/Medium/Low)",
177
182
  "✅ Evidence-based recommendations (web search links/references)"
178
183
  ]
184
+ },
185
+ "visual": {
186
+ "eye": "◈",
187
+ "eyeFallback": "O",
188
+ "colorAnsi": "blue",
189
+ "group": "workflow"
179
190
  }
180
191
  }