codingbuddy-rules 5.0.0 → 5.1.0

package/.ai-rules/agents/migration-specialist.json

@@ -657,5 +657,11 @@
       "blue_green": "https://martinfowler.com/bliki/BlueGreenDeployment.html"
     },
     "project_rules": "See .ai-rules/rules/"
+  },
+  "visual": {
+    "eye": "✱",
+    "eyeFallback": "O",
+    "colorAnsi": "bright",
+    "group": "specialist"
   }
 }

package/.ai-rules/agents/mobile-developer.json

@@ -50,16 +50,7 @@
       "android": ["build\\.gradle(\\.kts)?$", "AndroidManifest\\.xml$", "\\.kt$"]
     },
     "intent_patterns": {
-      "korean": [
-        "mobile",
-        "app",
-        "react native",
-        "flutter",
-        "iOS",
-        "android",
-        "swift",
-        "kotlin"
-      ],
+      "korean": ["mobile", "app", "react native", "flutter", "iOS", "android", "swift", "kotlin"],
       "english": ["mobile", "app", "react native", "flutter", "iOS", "android", "swift", "kotlin"]
     },
     "mandatory_checklist": {
@@ -310,5 +301,11 @@
       "hig": "https://developer.apple.com/design/human-interface-guidelines/",
       "material_design": "https://m3.material.io/"
     }
+  },
+  "visual": {
+    "eye": "✶",
+    "eyeFallback": "O",
+    "colorAnsi": "bright",
+    "group": "specialist"
   }
 }

package/.ai-rules/agents/observability-specialist.json

@@ -695,5 +695,11 @@
       "structured_logging": "JSON logging best practices"
     },
     "project_rules": "See .ai-rules/rules/"
+  },
+  "visual": {
+    "eye": "◌",
+    "eyeFallback": "O",
+    "colorAnsi": "white",
+    "group": "integration"
   }
 }

package/.ai-rules/agents/parallel-orchestrator.json

@@ -342,5 +342,11 @@
         }
       ]
     }
+  },
+  "visual": {
+    "eye": "▣",
+    "eyeFallback": "O",
+    "colorAnsi": "bright",
+    "group": "specialist"
   }
 }

package/.ai-rules/agents/performance-specialist.json

@@ -535,5 +535,11 @@
       "project_performance": "See project.md 'Performance & Optimization' section"
     },
     "project_rules": "See .ai-rules/rules/"
+  },
+  "visual": {
+    "eye": "⊗",
+    "eyeFallback": "O",
+    "colorAnsi": "bright",
+    "group": "specialist"
   }
 }

package/.ai-rules/agents/plan-mode.json

@@ -89,5 +89,11 @@
       "✅ Verify Delegate Agent's planning workflow is applied",
       "✅ Verify structured plan (Plan Overview, Implementation Steps, Quality Checklist, etc.)"
     ]
+  },
+  "visual": {
+    "eye": "◇",
+    "eyeFallback": "O",
+    "colorAnsi": "blue",
+    "group": "workflow"
   }
 }

package/.ai-rules/agents/plan-reviewer.json

@@ -24,10 +24,7 @@
       "Produce severity-rated findings (Critical/High/Medium/Low)"
     ]
   },
-  "context_files": [
-    ".ai-rules/rules/core.md",
-    ".ai-rules/rules/augmented-coding.md"
-  ],
+  "context_files": [".ai-rules/rules/core.md", ".ai-rules/rules/augmented-coding.md"],
   "activation": {
     "trigger": "When an implementation plan needs quality review before execution",
     "explicit_patterns": [
@@ -204,5 +201,11 @@
     "existing_agents": ".ai-rules/agents/*.json",
     "plan_skill": ".ai-rules/skills/plan-and-review/SKILL.md",
     "writing_plans_skill": ".ai-rules/skills/writing-plans/SKILL.md"
+  },
+  "visual": {
+    "eye": "◆",
+    "eyeFallback": "O",
+    "colorAnsi": "bright",
+    "group": "specialist"
   }
 }

package/.ai-rules/agents/platform-engineer.json

@@ -1244,5 +1244,11 @@
       "azure": "https://learn.microsoft.com/en-us/azure/",
       "finops": "https://www.finops.org/framework/"
     }
+  },
+  "visual": {
+    "eye": "△",
+    "eyeFallback": "O",
+    "colorAnsi": "red",
+    "group": "security"
   }
 }

package/.ai-rules/agents/security-engineer.json

@@ -95,5 +95,11 @@
   "communication": {
     "language": "Korean",
     "style": "Security-first approach, always explain the threat model and mitigation strategy"
+  },
+  "visual": {
+    "eye": "▲",
+    "eyeFallback": "O",
+    "colorAnsi": "red",
+    "group": "security"
   }
 }

package/.ai-rules/agents/security-specialist.json

@@ -480,5 +480,11 @@
       "project_security": "See project.md"
     },
     "project_rules": "See .ai-rules/rules/"
+  },
+  "visual": {
+    "eye": "◮",
+    "eyeFallback": "O",
+    "colorAnsi": "red",
+    "group": "security"
   }
 }

package/.ai-rules/agents/seo-specialist.json

@@ -423,5 +423,11 @@
       "project_seo": "See project.md"
     },
     "project_rules": "See .ai-rules/rules/"
+  },
+  "visual": {
+    "eye": "✧",
+    "eyeFallback": "O",
+    "colorAnsi": "yellow",
+    "group": "frontend"
   }
 }

package/.ai-rules/agents/software-engineer.json

@@ -71,5 +71,11 @@
   "communication": {
     "style": "Execution-focused step-by-step progress reporting",
     "format": "Show implementation progress, test results, and quality verification"
+  },
+  "visual": {
+    "eye": "◈",
+    "eyeFallback": "O",
+    "colorAnsi": "bright",
+    "group": "specialist"
   }
 }

package/.ai-rules/agents/solution-architect.json

@@ -163,5 +163,11 @@
     "project_rules": ".ai-rules/rules/",
     "existing_agents": ".ai-rules/agents/*.json",
     "skills_location": "superpowers plugin skills"
+  },
+  "visual": {
+    "eye": "⬢",
+    "eyeFallback": "O",
+    "colorAnsi": "magenta",
+    "group": "architecture"
   }
 }

package/.ai-rules/agents/systems-developer.json

@@ -80,5 +80,11 @@
   "communication": {
     "language": "Korean",
     "style": "Safety-first approach, always explain memory model and ownership decisions"
+  },
+  "visual": {
+    "eye": "⊞",
+    "eyeFallback": "O",
+    "colorAnsi": "bright",
+    "group": "specialist"
   }
 }

package/.ai-rules/agents/technical-planner.json

@@ -195,5 +195,11 @@
     "existing_agents": ".ai-rules/agents/*.json",
     "skills_location": "superpowers plugin skills",
     "plan_examples": "See superpowers:writing-plans skill for examples"
+  },
+  "visual": {
+    "eye": "⎔",
+    "eyeFallback": "O",
+    "colorAnsi": "magenta",
+    "group": "architecture"
   }
 }

package/.ai-rules/agents/test-engineer.json

@@ -66,5 +66,11 @@
   "communication": {
     "language": "Korean",
     "style": "TDD-first approach, always write the test before the implementation"
+  },
+  "visual": {
+    "eye": "◉",
+    "eyeFallback": "O",
+    "colorAnsi": "green",
+    "group": "quality"
   }
 }

package/.ai-rules/agents/test-strategy-specialist.json

@@ -521,5 +521,11 @@
       "project_testing": "See augmented-coding.md 'Testing Best Practices' section"
     },
     "project_rules": "See .ai-rules/rules/"
+  },
+  "visual": {
+    "eye": "⊙",
+    "eyeFallback": "O",
+    "colorAnsi": "green",
+    "group": "quality"
   }
 }

package/.ai-rules/agents/tooling-engineer.json

@@ -204,5 +204,11 @@
       "vite": "https://vite.dev/config/",
       "nextjs": "https://nextjs.org/docs/app/api-reference/config/next-config-js"
     }
+  },
+  "visual": {
+    "eye": "⊠",
+    "eyeFallback": "O",
+    "colorAnsi": "bright",
+    "group": "specialist"
   }
 }

package/.ai-rules/agents/ui-ux-designer.json

@@ -506,5 +506,11 @@
       "performance": "Consider performance-specialist.json for animation/interaction performance"
     },
     "project_rules": "See .ai-rules/rules/"
+  },
+  "visual": {
+    "eye": "☆",
+    "eyeFallback": "O",
+    "colorAnsi": "yellow",
+    "group": "frontend"
   }
 }

package/.ai-rules/schemas/agent.schema.json

@@ -291,6 +291,44 @@
         }
       ],
       "description": "General checklist (can be object or array)"
+    },
+    "visual": {
+      "type": "object",
+      "description": "Visual identity for the agent character system",
+      "required": ["eye", "eyeFallback", "colorAnsi", "group"],
+      "properties": {
+        "eye": {
+          "type": "string",
+          "description": "Unicode symbol representing the agent's eye/icon",
+          "minLength": 1
+        },
+        "eyeFallback": {
+          "type": "string",
+          "description": "ASCII fallback character for terminals without Unicode support",
+          "minLength": 1,
+          "maxLength": 1
+        },
+        "colorAnsi": {
+          "type": "string",
+          "enum": ["black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "bright"],
+          "description": "ANSI color name for terminal rendering"
+        },
+        "group": {
+          "type": "string",
+          "enum": [
+            "workflow",
+            "architecture",
+            "quality",
+            "security",
+            "frontend",
+            "backend",
+            "integration",
+            "specialist"
+          ],
+          "description": "Domain group for visual categorization"
+        }
+      },
+      "additionalProperties": false
     }
   },
   "additionalProperties": true

package/.ai-rules/skills/README.md

@@ -41,6 +41,7 @@ Reusable workflows for consistent development practices.
 | subagent-driven-development | Execute plans with independent tasks in current session | In-session plan execution |
 | systematic-debugging | Systematic approach before proposing fixes | Encountering bugs or failures |
 | cross-repo-issues | Detect, confirm, and create issues in upstream/related repositories with safety checks | Bug belongs upstream, dependency issue, fork-to-upstream reporting |
+| retrospective | Analyze session archives for coding patterns, agent usage, and improvement suggestions | Sprint reviews, periodic retrospectives, process improvement |
 | writing-plans | Create implementation plans before coding | Multi-step tasks with specs |
 
 ### Documentation & Communication
@@ -49,6 +50,7 @@ Reusable workflows for consistent development practices.
 |-------|-------------|-------------|
 | documentation-generation | Generate README, API docs, CHANGELOG, and ADRs from code | Creating or updating project documentation |
 | pr-all-in-one | Unified commit and PR workflow with smart issue linking | `/pr-all-in-one [target] [issue]` |
+| ship | Run local CI checks and ship changes — branch, commit, push, and PR | Changes are ready to ship |
 | pr-review | Systematic, evidence-based PR review with anti-sycophancy principles | Conducting manual PR reviews |
 | prompt-engineering | Write and optimize prompts for AI tools and agent system prompts | AI tool instructions, MCP tool descriptions, agent prompts |
 
@@ -210,6 +212,8 @@ EOF
 │   └── SKILL.md
 ├── subagent-driven-development/
 │   └── SKILL.md
+├── retrospective/
+│   └── SKILL.md
 ├── systematic-debugging/
 │   └── SKILL.md
 ├── writing-plans/
@@ -227,6 +231,8 @@ EOF
 │   └── SKILL.md
 ├── prompt-engineering/
 │   └── SKILL.md
+├── ship/
+│   └── SKILL.md
 │
 ├── [DevOps & Infrastructure]
 ├── cost-budget/

package/.ai-rules/skills/agent-design/examples/agent-template.json

@@ -21,10 +21,7 @@
     ]
   },
 
-  "context_files": [
-    ".ai-rules/rules/core.md",
-    ".ai-rules/rules/project.md"
-  ],
+  "context_files": [".ai-rules/rules/core.md", ".ai-rules/rules/project.md"],
 
   "modes": {
     "planning": {

package/.ai-rules/skills/mcp-builder/examples/tool-example.ts

@@ -105,10 +105,7 @@ export class FileAnalyzerHandler {
     }
   }
 
-  private async analyze(
-    filePath: string,
-    metrics?: string[],
-  ): Promise<FileAnalysis> {
+  private async analyze(filePath: string, metrics?: string[]): Promise<FileAnalysis> {
     const content = await this.fileService.read(filePath);
     const lines = content.split('\n');
     const selected = new Set(metrics ?? ['complexity', 'lines', 'dependencies', 'exports']);
@@ -133,22 +130,20 @@ export class FileAnalyzerHandler {
   private extractDependencies(lines: string[]): string[] {
     const importPattern = /^import\s+.*from\s+['"]([^'"]+)['"]/;
     return lines
-      .map((line) => line.match(importPattern)?.[1])
+      .map(line => line.match(importPattern)?.[1])
       .filter((dep): dep is string => dep !== undefined);
   }
 
   private extractExports(lines: string[]): string[] {
-    const exportPattern = /^export\s+(?:default\s+)?(?:class|function|const|interface|type|enum)\s+(\w+)/;
+    const exportPattern =
+      /^export\s+(?:default\s+)?(?:class|function|const|interface|type|enum)\s+(\w+)/;
     return lines
-      .map((line) => line.match(exportPattern)?.[1])
+      .map(line => line.match(exportPattern)?.[1])
       .filter((name): name is string => name !== undefined);
   }
 
   private formatAnalysis(analysis: FileAnalysis, includeSource?: boolean): string {
-    const sections: string[] = [
-      `## File Analysis: ${analysis.filePath}`,
-      '',
-    ];
+    const sections: string[] = [`## File Analysis: ${analysis.filePath}`, ''];
 
     if (analysis.lineCount >= 0) {
       sections.push(`**Lines:** ${analysis.lineCount}`);
@@ -158,11 +153,11 @@ export class FileAnalyzerHandler {
     }
     if (analysis.dependencies.length > 0) {
       sections.push('', '**Dependencies:**');
-      analysis.dependencies.forEach((dep) => sections.push(`- \`${dep}\``));
+      analysis.dependencies.forEach(dep => sections.push(`- \`${dep}\``));
     }
     if (analysis.exports.length > 0) {
       sections.push('', '**Exports:**');
-      analysis.exports.forEach((exp) => sections.push(`- \`${exp}\``));
+      analysis.exports.forEach(exp => sections.push(`- \`${exp}\``));
     }
 
     return sections.join('\n');

package/.ai-rules/skills/onboard/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: onboard
+description: "Guided onboarding for new projects - scans tech stack, generates codingbuddy.config.json, sets up adapters, and installs .ai-rules with interactive Q&A."
+---
+
+# Onboard: New Project Setup
+
+## Overview
+
+Guide users through setting up codingbuddy in a new project via interactive, step-by-step onboarding. Detect the tech stack automatically, generate configuration, and create adapter files for their AI tools.
+
+## Step 1: Project Scanning
+
+Scan the project root to detect:
+
+**Package managers & languages:**
+- `package.json` → Node.js/TypeScript (check for `typescript` dep)
+- `requirements.txt` / `pyproject.toml` / `setup.py` → Python
+- `go.mod` → Go
+- `Cargo.toml` → Rust
+- `pom.xml` / `build.gradle` → Java/Kotlin
+- `Gemfile` → Ruby
+- `composer.json` → PHP
+
+**Frameworks** (from dependency files):
+- React, Next.js, Vue, Angular, Svelte, Express, NestJS, Django, Flask, FastAPI, Spring Boot, Rails, Laravel, Gin, Echo, etc.
+
+**Test setup:**
+- Jest, Vitest, Mocha, Pytest, Go test, JUnit, RSpec, PHPUnit, etc.
+
+**Monorepo indicators:**
+- `workspaces` in package.json, `lerna.json`, `pnpm-workspace.yaml`, `nx.json`, `turbo.json`
+
+**AI tools already present:**
+- `.cursor/` → Cursor
+- `.claude/` → Claude Code
+- `.antigravity/` → Antigravity (Gemini)
+- `.codex/` → Codex
+- `.q/` → Amazon Q
+- `.kiro/` → Kiro
+- `.github/copilot/` → GitHub Copilot
+
+After scanning, present findings to the user:
+
+```
+Detected:
+- Language: TypeScript
+- Framework: Next.js 14, React 18
+- Test: Vitest
+- Monorepo: Yarn workspaces
+- AI tools: .claude/ (existing)
+```
+
+Ask: "Does this look correct? Anything to add or change?" (use AskUserQuestion)
+
+## Step 2: Generate codingbuddy.config.json
+
+Based on detected info, generate a draft config:
+
+```json
+{
+  "language": "en",
+  "techStack": {
+    "languages": ["typescript"],
+    "frameworks": ["nextjs", "react"],
+    "testing": ["vitest"],
+    "packageManager": "yarn"
+  },
+  "architecture": {
+    "pattern": "layered",
+    "monorepo": true
+  },
+  "agents": {
+    "primary": "software-engineer",
+    "specialists": ["frontend-developer", "test-engineer"]
+  }
+}
+```
+
+Ask the user to confirm or adjust:
+- Communication language (en, ko, ja, zh, es, etc.)
+- Primary agent selection (show top 3 recommendations based on tech stack)
+- Architecture pattern (layered, clean, hexagonal, or custom)
+
+Write `codingbuddy.config.json` to project root after confirmation.
+
+## Step 3: Adapter Setup
+
+Based on detected AI tools (or ask which tools the user wants to set up):
+
+| Tool | Config Path | What to Create |
+|------|------------|----------------|
+| Cursor | `.cursor/rules/codingbuddy.mdc` | Rules include pointing to .ai-rules |
+| Claude Code | `.claude/settings.json` + `CLAUDE.md` | MCP server config + instructions |
+| Antigravity | `.antigravity/rules/codingbuddy.md` | Gemini rules file |
+| Codex | `.codex/AGENTS.md` | Codex agent instructions |
+| Amazon Q | `.q/rules/codingbuddy.md` | Q rules file |
+| Kiro | `.kiro/rules/codingbuddy.md` | Kiro rules file |
+
+For each selected tool:
+1. Create the config directory if it does not exist
+2. Generate a starter config file referencing the shared `.ai-rules/` rules
+3. Show the user what was created
+
+Ask: "Which AI tools do you want to configure?" (use AskUserQuestion with multiSelect)
+
+## Step 4: Optional .ai-rules Setup
+
+Present two options:
+
+**Option A: Copy rules locally** (recommended for customization)
+- Copy `packages/rules/.ai-rules/` into the project as `.ai-rules/`
+- User can customize rules for their project
+
+**Option B: Install via npm package**
+- `npm install codingbuddy-rules` / `yarn add codingbuddy-rules`
+- Reference rules from `node_modules/codingbuddy-rules/.ai-rules/`
+- Stays in sync with upstream updates
+
+Ask: "How would you like to set up the AI rules?" (use AskUserQuestion)
+
+If Option A: copy the rules directory and confirm.
+If Option B: run the install command and update adapter configs to point to node_modules path.
+
+## Step 5: Summary
+
+Present a summary of everything that was created:
+
+```
+Onboarding complete!
+
+Created files:
+  - codingbuddy.config.json (project configuration)
+  - .claude/settings.json (Claude Code MCP config)
+  - .ai-rules/ (shared AI coding rules)
+
+Next steps:
+  1. Review codingbuddy.config.json and adjust settings
+  2. Start with: PLAN <your first task>
+  3. Use AUTO mode for autonomous development cycles
+  4. Run /help to see available commands
+```
+
+## Key Principles
+
+- **Interactive** — Ask one question at a time using AskUserQuestion, never assume
+- **Non-destructive** — Never overwrite existing config files; ask before modifying
+- **Detect first** — Auto-detect as much as possible, then confirm with user
+- **Minimal setup** — Only create what the user needs; skip unnecessary adapters
+- **Clear output** — Show exactly what files were created and what to do next