cp-toolkit 3.0.1 → 3.1.1

package/bin/cp-toolkit.js

@@ -46,6 +46,7 @@ program
   .description('Initialize cp-kit in a directory (creates .github/ structure)')
   .option('-y, --yes', 'Skip prompts and use defaults')
   .option('-f, --force', 'Overwrite existing configuration')
+  .option('-g, --global', 'Install instructions globally to VS Code User Prompts directory')
   .action(initCommand);
 
 // cp-kit add <type> <name>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cp-toolkit",
-  "version": "3.0.1",
+  "version": "3.1.1",
   "description": "Copilot Toolkit - Native AI Agents & Skills for GitHub Copilot (v2026)",
   "keywords": [
     "ai-agents",

package/src/commands/init.js

@@ -11,6 +11,7 @@
 
 import fs from 'fs-extra';
 import path from 'path';
+import os from 'os';
 import chalk from 'chalk';
 import ora from 'ora';
 import prompts from 'prompts';
@@ -20,10 +21,89 @@ import { fileURLToPath } from 'url';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+function getGlobalPromptsDir() {
+  const platform = os.platform();
+  const homeDir = os.homedir();
+  
+  if (platform === 'win32') {
+    return path.join(process.env.APPDATA, 'Code', 'User', 'prompts');
+  } else if (platform === 'darwin') {
+    return path.join(homeDir, 'Library', 'Application Support', 'Code', 'User', 'prompts');
+  } else {
+    // Linux and others
+    return path.join(homeDir, '.config', 'Code', 'User', 'prompts');
+  }
+}
+
+async function initGlobal(options, templatesDir) {
+  const targetDir = getGlobalPromptsDir();
+  console.log(chalk.bold.cyan('\n🌍 cp-toolkit - Installing Global Instructions\n'));
+  console.log(chalk.dim(`Target directory: ${targetDir}`));
+
+  if (!options.yes) {
+     const { confirm } = await prompts({
+      type: 'confirm',
+      name: 'confirm',
+      message: `Install instructions globally to VS Code User Data?`,
+      initial: true
+    });
+    if (!confirm) return;
+  }
+
+  const spinner = ora('Installing global instructions...').start();
+  
+  try {
+    // Check if Code/User exists (VS Code installed?)
+    if (!fs.existsSync(path.dirname(targetDir))) {
+      spinner.warn(chalk.yellow('VS Code User directory not found. Is VS Code installed?'));
+      const { create } = await prompts({
+        type: 'confirm',
+        name: 'create',
+        message: 'Create directory anyway?',
+        initial: true
+      });
+      if (!create) return;
+    }
+
+    await fs.ensureDir(targetDir);
+
+    // Copy instructions
+    // We flatten them: templates/instructions/*.md -> targetDir/*.md
+    const instructionsSourceDir = path.join(templatesDir, 'instructions');
+    const files = await fs.readdir(instructionsSourceDir);
+    
+    let count = 0;
+    for (const file of files) {
+      if (file.endsWith('.md')) {
+        await fs.copy(
+          path.join(instructionsSourceDir, file),
+          path.join(targetDir, file),
+          { overwrite: options.force }
+        );
+        count++;
+      }
+    }
+
+    spinner.succeed(chalk.green(`✨ Installed ${count} global instruction files!`));
+    console.log(chalk.bold('\n🚀 Next Steps:'));
+    console.log(`   1. Instructions are now available in ${chalk.cyan('ALL')} your projects.`);
+    console.log(`   2. Use ${chalk.yellow('Settings Sync')} in VS Code to sync them across machines.`);
+    
+  } catch (error) {
+    spinner.fail(chalk.red('❌ Failed to install global instructions'));
+    console.error(error);
+  }
+}
+
 export async function initCommand(directory, options) {
+  const templatesDir = path.join(__dirname, '../../templates');
+
+  if (options.global) {
+    return initGlobal(options, templatesDir);
+  }
+
   const targetDir = directory ? path.resolve(directory) : process.cwd();
   const dirName = path.basename(targetDir);
-  const templatesDir = path.join(__dirname, '../../templates');
 
   console.log(chalk.bold.cyan('\n🚀 cp-toolkit - GitHub Copilot Agent Toolkit\n'));
 

package/templates/agents/backend-specialist.agent.md

@@ -3,8 +3,6 @@ name: backend-specialist
 description: Expert backend architect for Node.js, Python, and modern serverless/edge systems. Use for API development, server-side logic, database integration, and security. Triggers on backend, server, api, endpoint, database, auth.
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
-capabilities: clean-code, nodejs-best-practices, python-patterns, api-patterns, database-design, mcp-builder, lint-and-validate, powershell-windows, bash-linux
-applyTo: ["**/api/**", "**/*.server.*", "**/controllers/**", "**/*.service.ts"]
 ---
 
 # Backend Development Architect

package/templates/agents/code-archaeologist.agent.md

@@ -3,8 +3,6 @@ name: code-archaeologist
 description: Expert in legacy code, refactoring, and understanding undocumented systems. Use for reading messy code, reverse engineering, and modernization planning. Triggers on legacy, refactor, spaghetti code, analyze repo, explain codebase.
 tools: Read, Grep, Glob, Edit, Write
 model: inherit
-capabilities: clean-code, refactoring-patterns, code-review-checklist
-applyTo: ["**/*legacy*/**", "**/*.old.*", "**/deprecated/**"]
 ---
 
 # Code Archaeologist

package/templates/agents/database-architect.agent.md

@@ -3,8 +3,6 @@ name: database-architect
 description: Expert database architect for schema design, query optimization, migrations, and modern serverless databases. Use for database operations, schema changes, indexing, and data modeling. Triggers on database, sql, schema, migration, query, postgres, index, table.
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
-capabilities: clean-code, database-design
-applyTo: ["**/prisma/**", "**/*.sql", "**/migrations/**", "**/db/**"]
 ---
 
 # Database Architect

package/templates/agents/debugger.agent.md

@@ -1,8 +1,6 @@
 ---
 name: debugger
 description: Expert in systematic debugging, root cause analysis, and crash investigation. Use for complex bugs, production issues, performance problems, and error analysis. Triggers on bug, error, crash, not working, broken, investigate, fix.
-capabilities: clean-code, systematic-debugging
-applyTo: ["**/*.log", "**/*.error.log", "**/debug/**", "**/*.dump"]
 ---
 
 # Debugger - Root Cause Analysis Expert

package/templates/agents/devops-engineer.agent.md

@@ -3,8 +3,6 @@ name: devops-engineer
 description: Expert in deployment, server management, CI/CD, and production operations. CRITICAL - Use for deployment, server access, rollback, and production changes. HIGH RISK operations. Triggers on deploy, production, server, pm2, ssh, release, rollback, ci/cd.
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
-capabilities: clean-code, deployment-procedures, server-management, powershell-windows, bash-linux
-applyTo: ["**/Dockerfile", "**/*.yaml", "**/terraform/**", "**/.env*"]
 ---
 
 # DevOps Engineer

package/templates/agents/documentation-writer.agent.md

@@ -3,8 +3,6 @@ name: documentation-writer
 description: Expert in technical documentation. Use ONLY when user explicitly requests documentation (README, API docs, changelog). DO NOT auto-invoke during normal development.
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
-capabilities: clean-code, documentation-templates
-applyTo: ["**/README.md", "**/CHANGELOG.md", "**/docs/**", "**/*.doc.md"]
 ---
 
 # Documentation Writer

package/templates/agents/explorer-agent.agent.md

@@ -3,8 +3,6 @@ name: explorer-agent
 description: Advanced codebase discovery, deep architectural analysis, and proactive research agent. The eyes and ears of the framework. Use for initial audits, refactoring plans, and deep investigative tasks.
 tools: Read, Grep, Glob, Bash, ViewCodeItem, FindByName
 model: inherit
-capabilities: clean-code, architecture, plan-writing, brainstorming, systematic-debugging
-applyTo: ["**/package.json", "**/CODEBASE.md", "**/.gitignore", "**/.gitmodules"]
 ---
 
 # Explorer Agent - Advanced Discovery & Research

package/templates/agents/frontend-specialist.agent.md

@@ -3,8 +3,6 @@ name: frontend-specialist
 description: Senior Frontend Architect who builds maintainable React/Next.js systems with performance-first mindset. Use when working on UI components, styling, state management, responsive design, or frontend architecture. Triggers on keywords like component, react, vue, ui, ux, css, tailwind, responsive.
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
-capabilities: clean-code, nextjs-react-expert, web-design-guidelines, tailwind-patterns, frontend-design, lint-and-validate
-applyTo: ["**/components/**", "**/*.tsx", "**/*.css", "**/hooks/**"]
 ---
 
 # Senior Frontend Architect

package/templates/agents/game-developer.agent.md

@@ -3,8 +3,6 @@ name: game-developer
 description: Game development across all platforms (PC, Web, Mobile, VR/AR). Use when building games with Unity, Godot, Unreal, Phaser, Three.js, or any game engine. Covers game mechanics, multiplayer, optimization, 2D/3D graphics, and game design patterns.
 tools: Read, Write, Edit, Bash, Grep, Glob
 model: inherit
-capabilities: clean-code, game-development, game-development/pc-games, game-development/web-games, game-development/mobile-games, game-development/game-design, game-development/multiplayer, game-development/vr-ar, game-development/2d-games, game-development/3d-games, game-development/game-art, game-development/game-audio
-applyTo: ["**/*.unity", "**/*.gd", "**/*.uproject", "**/*.shader"]
 ---
 
 # Game Developer Agent

package/templates/agents/mobile-developer.agent.md

@@ -3,8 +3,6 @@ name: mobile-developer
 description: Expert in React Native and Flutter mobile development. Use for cross-platform mobile apps, native features, and mobile-specific patterns. Triggers on mobile, react native, flutter, ios, android, app store, expo.
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
-capabilities: clean-code, mobile-design
-applyTo: ["**/android/**", "**/ios/**", "**/*.dart", "**/*.kt", "**/*.swift"]
 ---
 
 # Mobile Developer

package/templates/agents/orchestrator.agent.md

@@ -3,8 +3,6 @@ name: orchestrator
 description: Multi-agent coordination and task orchestration. Use when a task requires multiple perspectives, parallel analysis, or coordinated execution across different domains. Invoke this agent for complex tasks that benefit from security, backend, frontend, testing, and DevOps expertise combined.
 tools: Read, Grep, Glob, Bash, Write, Edit, Agent
 model: inherit
-capabilities: clean-code, parallel-agents, behavioral-modes, plan-writing, brainstorming, architecture, lint-and-validate, powershell-windows, bash-linux
-applyTo: ["**/PLAN.md", "**/.github/workflows/**", "**/ARCHITECTURE.md"]
 ---
 
 # Orchestrator - Native Multi-Agent Coordination

package/templates/agents/penetration-tester.agent.md

@@ -3,8 +3,6 @@ name: penetration-tester
 description: Expert in offensive security, penetration testing, red team operations, and vulnerability exploitation. Use for security assessments, attack simulations, and finding exploitable vulnerabilities. Triggers on pentest, exploit, attack, hack, breach, pwn, redteam, offensive.
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
-capabilities: clean-code, vulnerability-scanner, red-team-tactics, api-patterns
-applyTo: ["**/security-audit/*.md", "**/*.pcap", "**/*.burp", "**/exploit.py"]
 ---
 
 # Penetration Tester

package/templates/agents/performance-optimizer.agent.md

@@ -3,8 +3,6 @@ name: performance-optimizer
 description: Expert in performance optimization, profiling, Core Web Vitals, and bundle optimization. Use for improving speed, reducing bundle size, and optimizing runtime performance. Triggers on performance, optimize, speed, slow, memory, cpu, benchmark, lighthouse.
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
-capabilities: clean-code, performance-profiling
-applyTo: ["**/*.profile.json", "**/lighthouse-report.json", "**/webpack-bundle-analyzer/**"]
 ---
 
 # Performance Optimizer

package/templates/agents/product-manager.agent.md

@@ -3,8 +3,6 @@ name: product-manager
 description: Expert in product requirements, user stories, and acceptance criteria. Use for defining features, clarifying ambiguity, and prioritizing work. Triggers on requirements, user story, acceptance criteria, product specs.
 tools: Read, Grep, Glob, Bash
 model: inherit
-capabilities: plan-writing, brainstorming, clean-code
-applyTo: ["**/PRD.md", "**/*.prd.md", "**/requirements.md", "**/user-stories.md"]
 ---
 
 # Product Manager

package/templates/agents/product-owner.agent.md

@@ -3,8 +3,6 @@ name: product-owner
 description: Strategic facilitator bridging business needs and technical execution. Expert in requirements elicitation, roadmap management, and backlog prioritization. Triggers on requirements, user story, backlog, MVP, PRD, stakeholder.
 tools: Read, Grep, Glob, Bash
 model: inherit
-capabilities: plan-writing, brainstorming, clean-code
-applyTo: ["**/BACKLOG.md", "**/*.backlog.md", "**/priorities.md", "**/roadmap.md"]
 ---
 
 # Product Owner

package/templates/agents/project-planner.agent.md

@@ -3,8 +3,6 @@ name: project-planner
 description: Smart project planning agent. Breaks down user requests into tasks, plans file structure, determines which agent does what, creates dependency graph. Use when starting new projects or planning major features.
 tools: Read, Grep, Glob, Bash
 model: inherit
-capabilities: clean-code, app-builder, plan-writing, brainstorming
-applyTo: ["**/PLAN.md", "**/*.plan.md", "**/roadmap.md", "**/*.todo.md"]
 ---
 
 # Project Planner - Smart Project Planning

package/templates/agents/qa-automation-engineer.agent.md

@@ -3,8 +3,6 @@ name: qa-automation-engineer
 description: Specialist in test automation infrastructure and E2E testing. Focuses on Playwright, Cypress, CI pipelines, and breaking the system. Triggers on e2e, automated test, pipeline, playwright, cypress, regression.
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
-capabilities: webapp-testing, testing-patterns, web-design-guidelines, clean-code, lint-and-validate
-applyTo: ["**/cypress/**", "**/*.spec.ts", "**/*.cy.ts", "**/playwright.config.ts"]
 ---
 
 # QA Automation Engineer

package/templates/agents/security-auditor.agent.md

@@ -3,8 +3,6 @@ name: security-auditor
 description: Elite cybersecurity expert. Think like an attacker, defend like an expert. OWASP 2025, supply chain security, zero trust architecture. Triggers on security, vulnerability, owasp, xss, injection, auth, encrypt, supply chain, pentest.
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
-capabilities: clean-code, vulnerability-scanner, red-team-tactics, api-patterns
-applyTo: ["**/auth/**", "**/middleware/**", "**/*.config.*"]
 ---
 
 # Security Auditor

package/templates/agents/seo-specialist.agent.md

@@ -3,8 +3,6 @@ name: seo-specialist
 description: SEO and GEO (Generative Engine Optimization) expert. Handles SEO audits, Core Web Vitals, E-E-A-T optimization, AI search visibility. Use for SEO improvements, content optimization, or AI citation strategies.
 tools: Read, Grep, Glob, Bash, Write
 model: inherit
-capabilities: clean-code, seo-fundamentals, geo-fundamentals
-applyTo: ["**/robots.txt", "**/sitemap.xml", "**/*.meta.json", "**/seo-audit.md"]
 ---
 
 # SEO Specialist

package/templates/agents/test-engineer.agent.md

@@ -3,8 +3,6 @@ name: test-engineer
 description: Expert in testing, TDD, and test automation. Use for writing tests, improving coverage, debugging test failures. Triggers on test, spec, coverage, jest, pytest, playwright, e2e, unit test.
 tools: Read, Grep, Glob, Bash, Edit, Write
 model: inherit
-capabilities: clean-code, testing-patterns, tdd-workflow, webapp-testing, code-review-checklist, lint-and-validate
-applyTo: ["**/*.test.ts", "**/*.test.js", "**/__tests__/**", "**/jest.config.js"]
 ---
 
 # Test Engineer

package/templates/instructions/testing-development.instructions.md

@@ -1,42 +1,49 @@
 ---
 name: testing-development
 description: Guidelines for test structure, frameworks, and code coverage best practices.
-version: 1.0
+version: 2.0
 applyTo: "**/*.test.*,**/*.spec.*,**/tests/**,**/__tests__/**"
 ---
 
 # Testing Development Guidelines
 
-## Test Structure
-- Unit tests for individual functions/classes
-- Integration tests for component interactions
-- End-to-end tests for user workflows
-- Performance tests for critical paths
-- Accessibility tests for UI components
-
-## Testing Frameworks
-- Jest for JavaScript/TypeScript
-- pytest for Python
-- RSpec for Ruby
-- JUnit for Java
-- Appropriate framework per language
-
-## Test Patterns
-- Arrange-Act-Assert (AAA) pattern
-- Descriptive test names (not test1, test2)
-- One assertion per test when possible
-- Mock external dependencies
-- Test edge cases and error conditions
-
-## Code Coverage
-- Aim for 80%+ coverage on critical code
-- Focus on business logic over getters/setters
-- Integration tests for coverage gaps
-- Coverage reports in CI/CD pipeline
-
-## Best Practices
-- Tests run independently (no shared state)
-- Fast execution for developer experience
-- CI/CD integration with quality gates
-- Test data management and cleanup
-- Documentation of test scenarios
+You are an expert in Software Quality Assurance and Test Automation.
+When writing or analyzing tests in this repository, you MUST follow these directives:
+
+## 1. Test Structure & Strategy
+- **Unit Tests**: Isolate individual functions/methods. Mock ALL external dependencies (DB, API, File System).
+- **Integration Tests**: Verify interaction between modules (e.g., API + DB). Use containerized services if possible.
+- **E2E Tests**: Simulate user journeys. Use Playwright/Cypress standards.
+
+## 2. The AAA Pattern (Strict Enforcement)
+Every test case MUST follow the **Arrange-Act-Assert** pattern structure explicitly.
+
+```javascript
+// ✅ CORRECT
+it('should calculate total validation', () => {
+  // Arrange
+  const input = 10;
+  const expected = 20;
+
+  // Act
+  const result = calculate(input);
+
+  // Assert
+  expect(result).toBe(expected);
+});
+```
+
+## 3. Naming Conventions
+- **Files**: `*.test.ts` (Unit), `*.spec.ts` (E2E/Integration).
+- **Descriptions**: Use "should [expected behavior] when [condition]".
+  - ❌ `test('login', ...)`
+  - ✅ `test('should return 401 when token is expired', ...)`
+
+## 4. Mocking & Isolation
+- **No side effects**: Tests must be atomic and order-independent.
+- **State reset**: Use `beforeEach`/`afterEach` to clean up state.
+- **External calls**: NEVER rely on real 3rd party APIs in unit tests.
+
+## 5. Agent Behavior
+- If the user asks to "fix a bug", **ALWAYS** ask to write a reproduction test case first.
+- If code coverage is low, proactively suggest adding missing test cases for edge conditions.