@cubis/foundry 0.3.31 → 0.3.32

package/bin/cubis.js

@@ -61,12 +61,23 @@ const WORKFLOW_PROFILES = {
       workflowDirs: [".agent/workflows"],
       agentDirs: [".agent/agents"],
       skillDirs: [".agent/skills"],
+      commandDirs: [".gemini/commands"],
       ruleFilesByPriority: [".agent/rules/GEMINI.md"]
     },
     global: {
-      workflowDirs: ["~/.gemini/antigravity/workflows"],
-      agentDirs: ["~/.gemini/antigravity/agents"],
-      skillDirs: ["~/.gemini/antigravity/skills"],
+      workflowDirs: [
+        "~/.gemini/antigravity/workflows",
+        "~/.gemini/antigravity/global_workflows"
+      ],
+      agentDirs: [
+        "~/.gemini/antigravity/agents",
+        "~/.gemini/antigravity/global_agents"
+      ],
+      skillDirs: [
+        "~/.gemini/antigravity/skills",
+        "~/.gemini/antigravity/global_skills"
+      ],
+      commandDirs: ["~/.gemini/commands"],
       ruleFilesByPriority: ["~/.gemini/GEMINI.md"]
     },
     detectorPaths: [".agent", ".agent/workflows", ".agent/rules/GEMINI.md"],
@@ -101,12 +112,14 @@ const WORKFLOW_PROFILES = {
       workflowDirs: [".github/copilot/workflows"],
       agentDirs: [".github/agents"],
       skillDirs: [".github/skills"],
+      promptDirs: [".github/prompts"],
       ruleFilesByPriority: ["AGENTS.md", ".github/copilot-instructions.md"]
     },
     global: {
       workflowDirs: ["~/.copilot/workflows"],
       agentDirs: ["~/.copilot/agents"],
       skillDirs: ["~/.copilot/skills"],
+      promptDirs: ["~/.copilot/prompts"],
       ruleFilesByPriority: ["~/.copilot/copilot-instructions.md"]
     },
     detectorPaths: [
@@ -1359,7 +1372,9 @@ async function recordBundleInstallState({ scope, platform, bundleId, artifacts,
     installedAt: new Date().toISOString(),
     workflows: artifacts.workflows.map(toPosixPath),
     agents: artifacts.agents.map(toPosixPath),
-    skills: artifacts.skills.map(toPosixPath)
+    skills: artifacts.skills.map(toPosixPath),
+    commands: (artifacts.commands || []).map(toPosixPath),
+    prompts: (artifacts.prompts || []).map(toPosixPath)
   };
 
   await writeState(scope, state, cwd);
@@ -1381,11 +1396,27 @@ async function resolveProfilePaths(profileId, scope, cwd = process.cwd()) {
   const profile = WORKFLOW_PROFILES[profileId];
   if (!profile) throw new Error(`Unknown platform '${profileId}'.`);
   const cfg = profile[scope];
+  const workflowDirs = Array.isArray(cfg.workflowDirs) ? cfg.workflowDirs : [];
+  const agentDirs = Array.isArray(cfg.agentDirs) ? cfg.agentDirs : [];
+  const skillDirs = Array.isArray(cfg.skillDirs) ? cfg.skillDirs : [];
+  const commandDirs = Array.isArray(cfg.commandDirs) ? cfg.commandDirs : [];
+  const promptDirs = Array.isArray(cfg.promptDirs) ? cfg.promptDirs : [];
+
+  const resolvePreferredDir = async (dirs) => {
+    if (dirs.length === 0) return null;
+    const expanded = dirs.map((dirPath) => expandPath(dirPath, cwd));
+    for (const candidate of expanded) {
+      if (await pathExists(candidate)) return candidate;
+    }
+    return expanded[0];
+  };
 
   return {
-    workflowsDir: expandPath(cfg.workflowDirs[0], cwd),
-    agentsDir: expandPath(cfg.agentDirs[0], cwd),
-    skillsDir: expandPath(cfg.skillDirs[0], cwd),
+    workflowsDir: await resolvePreferredDir(workflowDirs),
+    agentsDir: await resolvePreferredDir(agentDirs),
+    skillsDir: await resolvePreferredDir(skillDirs),
+    commandsDir: commandDirs[0] ? expandPath(commandDirs[0], cwd) : null,
+    promptsDir: promptDirs[0] ? expandPath(promptDirs[0], cwd) : null,
     ruleFilesByPriority: cfg.ruleFilesByPriority.map((filePath) => expandPath(filePath, cwd))
   };
 }
@@ -1399,7 +1430,9 @@ async function resolveArtifactProfilePaths(profileId, scope, cwd = process.cwd()
   return {
     ...scopedPaths,
     workflowsDir: workspacePaths.workflowsDir,
-    agentsDir: workspacePaths.agentsDir
+    agentsDir: workspacePaths.agentsDir,
+    commandsDir: workspacePaths.commandsDir ?? scopedPaths.commandsDir,
+    promptsDir: workspacePaths.promptsDir ?? scopedPaths.promptsDir
   };
 }
 
@@ -3643,9 +3676,14 @@ async function findNestedSkillDirs(rootDir, depth = 0, nested = []) {
     if (!entry.isDirectory()) continue;
     const childDir = path.join(rootDir, entry.name);
     const skillFile = path.join(childDir, "SKILL.md");
-    if (depth >= 1 && (await pathExists(skillFile))) {
+
+    // Treat direct children and deeper descendants as nested skills.
+    // Once a nested skill boundary is detected, stop descending further.
+    if (depth >= 0 && (await pathExists(skillFile))) {
       nested.push(childDir);
+      continue;
     }
+
     await findNestedSkillDirs(childDir, depth + 1, nested);
   }
   return nested;
@@ -3717,6 +3755,12 @@ async function installBundleArtifacts({
     if (platformInstallsCustomAgents(platform)) {
       await mkdir(profilePaths.agentsDir, { recursive: true });
     }
+    if (profilePaths.commandsDir && Array.isArray(platformSpec.commands) && platformSpec.commands.length > 0) {
+      await mkdir(profilePaths.commandsDir, { recursive: true });
+    }
+    if (profilePaths.promptsDir && Array.isArray(platformSpec.prompts) && platformSpec.prompts.length > 0) {
+      await mkdir(profilePaths.promptsDir, { recursive: true });
+    }
   }
 
   const bundleRoot = path.join(agentAssetsRoot(), "workflows", bundleId);
@@ -3724,7 +3768,7 @@ async function installBundleArtifacts({
 
   const installed = [];
   const skipped = [];
-  const artifacts = { workflows: [], agents: [], skills: [] };
+  const artifacts = { workflows: [], agents: [], skills: [], commands: [], prompts: [] };
 
   const workflowFiles = Array.isArray(platformSpec.workflows) ? platformSpec.workflows : [];
   for (const workflowFile of workflowFiles) {
@@ -3760,6 +3804,38 @@ async function installBundleArtifacts({
     else installed.push(destination);
   }
 
+  const commandFiles = Array.isArray(platformSpec.commands) ? platformSpec.commands : [];
+  for (const commandFile of commandFiles) {
+    if (!profilePaths.commandsDir) continue;
+    const source = path.join(platformRoot, "commands", commandFile);
+    const destination = path.join(profilePaths.commandsDir, path.basename(commandFile));
+
+    if (!(await pathExists(source))) {
+      throw new Error(`Missing command source file: ${source}`);
+    }
+
+    const result = await copyArtifact({ source, destination, overwrite, dryRun });
+    artifacts.commands.push(destination);
+    if (result.action === "skipped" || result.action === "would-skip") skipped.push(destination);
+    else installed.push(destination);
+  }
+
+  const promptFiles = Array.isArray(platformSpec.prompts) ? platformSpec.prompts : [];
+  for (const promptFile of promptFiles) {
+    if (!profilePaths.promptsDir) continue;
+    const source = path.join(platformRoot, "prompts", promptFile);
+    const destination = path.join(profilePaths.promptsDir, path.basename(promptFile));
+
+    if (!(await pathExists(source))) {
+      throw new Error(`Missing prompt source file: ${source}`);
+    }
+
+    const result = await copyArtifact({ source, destination, overwrite, dryRun });
+    artifacts.prompts.push(destination);
+    if (result.action === "skipped" || result.action === "would-skip") skipped.push(destination);
+    else installed.push(destination);
+  }
+
   const skillIds = await resolveInstallSkillIds({
     platformSpec,
     extraSkillIds
@@ -3969,6 +4045,18 @@ async function removeBundleArtifacts({
     if (await safeRemove(destination, dryRun)) removed.push(destination);
   }
 
+  for (const commandFile of platformSpec.commands || []) {
+    if (!profilePaths.commandsDir) continue;
+    const destination = path.join(profilePaths.commandsDir, path.basename(commandFile));
+    if (await safeRemove(destination, dryRun)) removed.push(destination);
+  }
+
+  for (const promptFile of platformSpec.prompts || []) {
+    if (!profilePaths.promptsDir) continue;
+    const destination = path.join(profilePaths.promptsDir, path.basename(promptFile));
+    if (await safeRemove(destination, dryRun)) removed.push(destination);
+  }
+
   const skillIds = await resolveInstallSkillIds({ platformSpec, extraSkillIds: [] });
   for (const skillId of skillIds) {
     const destination = path.join(profilePaths.skillsDir, skillId);
@@ -3997,14 +4085,26 @@ function printPlatforms() {
       `  project agents:    ${agentsEnabled ? profile.project.agentDirs[0] : "(disabled for this platform)"}`
     );
     console.log(`  project skills:    ${profile.project.skillDirs[0]}`);
+    if (Array.isArray(profile.project.commandDirs) && profile.project.commandDirs.length > 0) {
+      console.log(`  project commands:  ${profile.project.commandDirs[0]}`);
+    }
+    if (Array.isArray(profile.project.promptDirs) && profile.project.promptDirs.length > 0) {
+      console.log(`  project prompts:   ${profile.project.promptDirs[0]}`);
+    }
     console.log(`  project rules:     ${profile.project.ruleFilesByPriority.join(" | ")}`);
     console.log(`  global workflows:  ${profile.global.workflowDirs[0]}`);
     console.log(
       `  global agents:     ${agentsEnabled ? profile.global.agentDirs[0] : "(disabled for this platform)"}`
     );
     console.log(`  global skills:     ${profile.global.skillDirs[0]}`);
+    if (Array.isArray(profile.global.commandDirs) && profile.global.commandDirs.length > 0) {
+      console.log(`  global commands:   ${profile.global.commandDirs[0]}`);
+    }
+    if (Array.isArray(profile.global.promptDirs) && profile.global.promptDirs.length > 0) {
+      console.log(`  global prompts:    ${profile.global.promptDirs[0]}`);
+    }
     console.log(`  global rules:      ${profile.global.ruleFilesByPriority.join(" | ")}`);
-    console.log("  default install:   workflows/agents -> project, skills -> global");
+    console.log("  default install:   workflows/agents/commands/prompts -> project, skills -> global");
   }
 }
 
@@ -4225,6 +4325,16 @@ async function createDoctorReport({ platform, scope, cwd = process.cwd() }) {
     skills: {
       path: artifactPaths.skillsDir,
       exists: await pathExists(artifactPaths.skillsDir)
+    },
+    commands: {
+      path: artifactPaths.commandsDir,
+      enabled: Boolean(artifactPaths.commandsDir),
+      exists: artifactPaths.commandsDir ? await pathExists(artifactPaths.commandsDir) : null
+    },
+    prompts: {
+      path: artifactPaths.promptsDir,
+      enabled: Boolean(artifactPaths.promptsDir),
+      exists: artifactPaths.promptsDir ? await pathExists(artifactPaths.promptsDir) : null
     }
   };
 
@@ -4306,9 +4416,11 @@ async function createDoctorReport({ platform, scope, cwd = process.cwd() }) {
   if (
     !pathStatus.workflows.exists &&
     !pathStatus.skills.exists &&
-    !(pathStatus.agents.enabled && pathStatus.agents.exists)
+    !(pathStatus.agents.enabled && pathStatus.agents.exists) &&
+    !(pathStatus.commands.enabled && pathStatus.commands.exists) &&
+    !(pathStatus.prompts.enabled && pathStatus.prompts.exists)
   ) {
-    recommendations.push("No workflow/agent/skill directories found in this scope.");
+    recommendations.push("No workflow/agent/skill/command/prompt directories found in this scope.");
   }
 
   if (platform === "codex" && scope === "project") {
@@ -4369,6 +4481,20 @@ async function createDoctorReport({ platform, scope, cwd = process.cwd() }) {
     );
   }
 
+  if (platform === "antigravity" && pathStatus.workflows.exists && pathStatus.commands.enabled && !pathStatus.commands.exists) {
+    warnings.push("Antigravity workflows are present but .gemini/commands is missing.");
+    recommendations.push(
+      `Reinstall to generate command files: cbx workflows install --platform antigravity --bundle agent-environment-setup --scope ${scope} --overwrite`
+    );
+  }
+
+  if (platform === "copilot" && pathStatus.workflows.exists && pathStatus.prompts.enabled && !pathStatus.prompts.exists) {
+    warnings.push("Copilot workflows are present but prompts directory is missing.");
+    recommendations.push(
+      `Reinstall to generate prompt files: cbx workflows install --platform copilot --bundle agent-environment-setup --scope ${scope} --overwrite`
+    );
+  }
+
   if (platform === "copilot" && pathStatus.skills.exists) {
     const findings = await validateCopilotSkillsSchema(artifactPaths.skillsDir);
     if (findings.length > 0) {
@@ -4434,6 +4560,16 @@ function printDoctorReport(report) {
     console.log(`- Agents: ${report.paths.agents.path} : ${report.paths.agents.exists ? "exists" : "missing"}`);
   }
   console.log(`- Skills: ${report.paths.skills.path} : ${report.paths.skills.exists ? "exists" : "missing"}`);
+  if (report.paths.commands.enabled === false) {
+    console.log(`- Commands: (disabled)`);
+  } else {
+    console.log(`- Commands: ${report.paths.commands.path} : ${report.paths.commands.exists ? "exists" : "missing"}`);
+  }
+  if (report.paths.prompts.enabled === false) {
+    console.log(`- Prompts: (disabled)`);
+  } else {
+    console.log(`- Prompts: ${report.paths.prompts.path} : ${report.paths.prompts.exists ? "exists" : "missing"}`);
+  }
 
   console.log("\nManaged block:");
   console.log(`- Status: ${report.managedBlockStatus}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cubis/foundry",
-  "version": "0.3.31",
+  "version": "0.3.32",
   "description": "Cubis Foundry CLI for workflow-first AI agent environments",
   "type": "module",
   "bin": {
@@ -23,6 +23,9 @@
     "test:smoke": "bash scripts/smoke-workflows.sh",
     "test:all": "npm run test:attributes && npm run test:smoke",
     "test:all:strict": "npm run test:attributes:strict && npm run test:smoke",
+    "generate:platform-assets": "node scripts/generate-platform-assets.mjs",
+    "sync:skill-mirrors": "node scripts/sync-skill-mirrors.mjs",
+    "generate:skills-index": "node scripts/generate-skills-index.mjs",
     "generate:powers": "node \"workflows/scripts/generate-powers.mjs\"",
     "generate:powers:force": "node \"workflows/scripts/generate-powers.mjs\" --force",
     "generate:powers:from-skills": "node \"workflows/scripts/generate-powers.mjs\" --from-skills",

package/workflows/skills/architecture/SKILL.md

@@ -1,55 +1,21 @@
 ---
 name: architecture
-description: Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design.
-allowed-tools: Read, Glob, Grep
+description: "Compatibility alias skill. Deprecated: use architecture-designer."
+metadata:
+  deprecated: true
+  replaced_by: architecture-designer
+  removal_target: v0.6.0
 ---
 
-# Architecture Decision Framework
+# Architecture
 
-> "Requirements drive architecture. Trade-offs inform decisions. ADRs capture rationale."
+## Compatibility Alias
 
-## 🎯 Selective Reading Rule
+This skill is deprecated and kept for backward compatibility.
 
-**Read ONLY files relevant to the request!** Check the content map, find what you need.
+Use `architecture-designer` as the canonical skill.
 
-| File | Description | When to Read |
-|------|-------------|--------------|
-| `context-discovery.md` | Questions to ask, project classification | Starting architecture design |
-| `trade-off-analysis.md` | ADR templates, trade-off framework | Documenting decisions |
-| `pattern-selection.md` | Decision trees, anti-patterns | Choosing patterns |
-| `examples.md` | MVP, SaaS, Enterprise examples | Reference implementations |
-| `patterns-reference.md` | Quick lookup for patterns | Pattern comparison |
+## Migration
 
----
-
-## 🔗 Related Skills
-
-| Skill | Use For |
-|-------|---------|
-| `@[skills/database-design]` | Database schema design |
-| `@[skills/api-patterns]` | API design patterns |
-| `@[skills/deployment-procedures]` | Deployment architecture |
-
----
-
-## Core Principle
-
-**"Simplicity is the ultimate sophistication."**
-
-- Start simple
-- Add complexity ONLY when proven necessary
-- You can always add patterns later
-- Removing complexity is MUCH harder than adding it
-
----
-
-## Validation Checklist
-
-Before finalizing architecture:
-
-- [ ] Requirements clearly understood
-- [ ] Constraints identified
-- [ ] Each decision has trade-off analysis
-- [ ] Simpler alternatives considered
-- [ ] ADRs written for significant decisions
-- [ ] Team expertise matches chosen patterns
+1. Replace direct references to `architecture` with `architecture-designer`.
+2. Apply the full workflow from `architecture-designer` for new work.

package/workflows/skills/building-mcp-server-on-cloudflare/references/tool-patterns.md

@@ -0,0 +1,29 @@
+# Tool Patterns for Cloudflare MCP Servers
+
+Use these patterns when defining tools in a Worker-based MCP server.
+
+## 1) Read-only lookup tool
+- Purpose: fetch status/info without side effects.
+- Input schema: strict object with required identifiers.
+- Output: typed payload + stable error shape.
+
+## 2) Mutating action tool
+- Purpose: create/update/delete with explicit confirmation rules.
+- Input schema: include idempotency key when possible.
+- Output: operation result with `changed: true|false`.
+
+## 3) Search/list tool
+- Purpose: paginated retrieval.
+- Input schema: `limit`, `cursor` (opaque token), optional filters.
+- Output: `items`, `next_cursor`, `has_more`.
+
+## 4) Long-running task launcher
+- Purpose: start async work and return tracking handle.
+- Input schema: task definition + options.
+- Output: `task_id`, `status_url` or poll key.
+
+## Guardrails
+- Validate all tool inputs before processing.
+- Return deterministic errors with machine-readable codes.
+- Avoid leaking secrets in logs or output.
+- Keep tool names stable once published.

package/workflows/skills/code-review-checklist/SKILL.md

@@ -1,109 +1,21 @@
 ---
 name: code-review-checklist
-description: Code review guidelines covering code quality, security, and best practices.
-allowed-tools: Read, Glob, Grep
+description: "Compatibility alias skill. Deprecated: use code-reviewer."
+metadata:
+  deprecated: true
+  replaced_by: code-reviewer
+  removal_target: v0.6.0
 ---
 
 # Code Review Checklist
 
-## Quick Review Checklist
+## Compatibility Alias
 
-### Correctness
-- [ ] Code does what it's supposed to do
-- [ ] Edge cases handled
-- [ ] Error handling in place
-- [ ] No obvious bugs
+This skill is deprecated and kept for backward compatibility.
 
-### Security
-- [ ] Input validated and sanitized
-- [ ] No SQL/NoSQL injection vulnerabilities
-- [ ] No XSS or CSRF vulnerabilities
-- [ ] No hardcoded secrets or sensitive credentials
-- [ ] **AI-Specific:** Protection against Prompt Injection (if applicable)
-- [ ] **AI-Specific:** Outputs are sanitized before being used in critical sinks
+Use `code-reviewer` as the canonical skill.
 
-### Performance
-- [ ] No N+1 queries
-- [ ] No unnecessary loops
-- [ ] Appropriate caching
-- [ ] Bundle size impact considered
+## Migration
 
-### Code Quality
-- [ ] Clear naming
-- [ ] DRY - no duplicate code
-- [ ] SOLID principles followed
-- [ ] Appropriate abstraction level
-
-### Testing
-- [ ] Unit tests for new code
-- [ ] Edge cases tested
-- [ ] Tests readable and maintainable
-
-### Documentation
-- [ ] Complex logic commented
-- [ ] Public APIs documented
-- [ ] README updated if needed
-
-## AI & LLM Review Patterns (2025)
-
-### Logic & Hallucinations
-- [ ] **Chain of Thought:** Does the logic follow a verifiable path?
-- [ ] **Edge Cases:** Did the AI account for empty states, timeouts, and partial failures?
-- [ ] **External State:** Is the code making safe assumptions about file systems or networks?
-
-### Prompt Engineering Review
-```markdown
-// ❌ Vague prompt in code
-const response = await ai.generate(userInput);
-
-// ✅ Structured & Safe prompt
-const response = await ai.generate({
-  system: "You are a specialized parser...",
-  input: sanitize(userInput),
-  schema: ResponseSchema
-});
-```
-
-## Anti-Patterns to Flag
-
-```typescript
-// ❌ Magic numbers
-if (status === 3) { ... }
-
-// ✅ Named constants
-if (status === Status.ACTIVE) { ... }
-
-// ❌ Deep nesting
-if (a) { if (b) { if (c) { ... } } }
-
-// ✅ Early returns
-if (!a) return;
-if (!b) return;
-if (!c) return;
-// do work
-
-// ❌ Long functions (100+ lines)
-// ✅ Small, focused functions
-
-// ❌ any type
-const data: any = ...
-
-// ✅ Proper types
-const data: UserData = ...
-```
-
-## Review Comments Guide
-
-```
-// Blocking issues use 🔴
-🔴 BLOCKING: SQL injection vulnerability here
-
-// Important suggestions use 🟡
-🟡 SUGGESTION: Consider using useMemo for performance
-
-// Minor nits use 🟢
-🟢 NIT: Prefer const over let for immutable variable
-
-// Questions use ❓
-❓ QUESTION: What happens if user is null here?
-```
+1. Replace direct references to `code-review-checklist` with `code-reviewer`.
+2. Apply the full workflow from `code-reviewer` for new work.

package/workflows/skills/debugging-wizard/SKILL.md

@@ -1,87 +1,21 @@
 ---
-name: "debugging-wizard"
-description: "Use when investigating errors, analyzing stack traces, or finding root causes of unexpected behavior. Invoke for error investigation, troubleshooting, log analysis, root cause analysis."
+name: debugging-wizard
+description: "Compatibility alias skill. Deprecated: use systematic-debugging."
+metadata:
+  deprecated: true
+  replaced_by: systematic-debugging
+  removal_target: v0.6.0
 ---
 
-
 # Debugging Wizard
 
-## Overview
-
-Expert debugger applying systematic methodology to isolate and resolve issues in any codebase.
-
-## Role Definition
-
-You are a senior engineer with 15+ years debugging experience across multiple languages and frameworks. You apply scientific methodology to isolate root causes efficiently. You never guess - you test hypotheses systematically.
-
-## When to Use This Skill
-
-- Investigating errors, exceptions, or unexpected behavior
-- Analyzing stack traces and error messages
-- Finding root causes of intermittent issues
-- Performance debugging and profiling
-- Memory leak investigation
-- Race condition diagnosis
-
-## Core Workflow
-
-1. **Reproduce** - Establish consistent reproduction steps
-2. **Isolate** - Narrow down to smallest failing case
-3. **Hypothesize** - Form testable theories about cause
-4. **Test** - Verify/disprove each hypothesis
-5. **Fix** - Implement and verify solution
-6. **Prevent** - Add tests/safeguards against regression
-
-## Available Steering Files
-
-Load detailed guidance on-demand:
-
-| Topic           | Reference                     | Load When                              |
-| --------------- | ----------------------------- | -------------------------------------- |
-| Debugging Tools | `references/debugging-tools.md` | Setting up debuggers by language       |
-| Common Patterns | `references/common-patterns.md` | Recognizing bug patterns               |
-| Strategies      | `references/strategies.md`      | Binary search, git bisect, time travel |
-| Quick Fixes     | `references/quick-fixes.md`     | Common error solutions                 |
-
-<!-- Row below adapted from obra/superpowers by Jesse Vincent (@obra), MIT License -->
-
-| Systematic Debugging | `references/systematic-debugging.md` | Complex bugs, multiple failed fixes, root cause analysis |
-
-## Constraints
-
-### MUST DO
-
-- Reproduce the issue first
-- Gather complete error messages and stack traces
-- Test one hypothesis at a time
-- Document findings for future reference
-- Add regression tests after fixing
-- Remove all debug code before committing
-
-### MUST NOT DO
-
-- Guess without testing
-- Make multiple changes at once
-- Skip reproduction steps
-- Assume you know the cause
-- Debug in production without safeguards
-- Leave console.log/debugger statements in code
-
-## Output Templates
-
-When debugging, provide:
-
-1. **Root Cause**: What specifically caused the issue
-2. **Evidence**: Stack trace, logs, or test that proves it
-3. **Fix**: Code change that resolves it
-4. **Prevention**: Test or safeguard to prevent recurrence
+## Compatibility Alias
 
-## Knowledge Reference
+This skill is deprecated and kept for backward compatibility.
 
-Debuggers (Chrome DevTools, VS Code, pdb, delve), profilers, log aggregation, distributed tracing, memory analysis, git bisect, error tracking (Sentry)
+Use `systematic-debugging` as the canonical skill.
 
-## Related Powers
+## Migration
 
-- **Test Master** - Writing regression tests
-- **Fullstack Guardian** - Implementing fixes
-- **Monitoring Expert** - Setting up alerting
+1. Replace direct references to `debugging-wizard` with `systematic-debugging`.
+2. Apply the full workflow from `systematic-debugging` for new work.