agents-templated 1.2.11 → 1.2.12

package/bin/cli.js

@@ -119,7 +119,7 @@ program
               { name: 'Documentation files (agent-docs/)', value: 'docs' },
               { name: 'Agent rules (.github/instructions/rules/*.mdc)', value: 'rules' },
               { name: 'Skills (.github/skills/*)', value: 'skills' },
-              { name: 'AI Agent instructions (Cursor, Copilot, VSCode, Gemini)', value: 'github' }
+              { name: 'AI Agent instructions (Cursor, Copilot, Claude, Generic AGENTS)', value: 'github' }
             ],
             default: ['all']
           },
@@ -177,16 +177,16 @@ program
         );
       }
 
-      // Install AI Agent instructions (Cursor, Copilot, Claude, Gemini)
+      // Install AI Agent instructions (Cursor, Copilot, Claude, Generic AGENTS)
       if (installAll || choices.includes('github')) {
         console.log(chalk.yellow('Installing AI agent instructions...'));
         await fs.ensureDir(path.join(targetDir, '.github', 'instructions'));
         await copyFiles(templateDir, targetDir, ['.cursorrules'], options.force);
         await writeGeneratedInstructions(targetDir, templateDir, options.force);
         console.log(chalk.gray('  ✓ Cursor (.cursorrules)'));
-        console.log(chalk.gray('  ✓ GitHub Copilot (.github/instructions/copilot-instructions.md + compat shim)'));
-        console.log(chalk.gray('  ✓ Claude (.github/instructions/CLAUDE.md + compat shim)'));
-        console.log(chalk.gray('  ✓ Google Gemini (.github/instructions/GEMINI.md + compat shim)'));
+        console.log(chalk.gray('  ✓ GitHub Copilot (.github/copilot-instructions.md shim)'));
+        console.log(chalk.gray('  ✓ Claude (.claude/CLAUDE.md shim)'));
+        console.log(chalk.gray('  ✓ Generic AGENTS (AGENTS.MD shim + canonical .github/instructions/AGENTS.md)'));
       }
 
       console.log(chalk.green.bold('\nInstallation complete!\n'));
@@ -241,7 +241,7 @@ program
                 { name: 'Documentation (agent-docs/)', value: 'docs' },
                 { name: 'Agent Rules (security, testing, database, etc.)', value: 'rules' },
                 { name: 'Skills (reusable agent capabilities)', value: 'skills' },
-                { name: 'AI Agent instructions (Cursor, Copilot, VSCode, Gemini)', value: 'github' }
+                { name: 'AI Agent instructions (Cursor, Copilot, Claude, Generic AGENTS)', value: 'github' }
               ],
               validate: (answer) => {
                 if (answer.length === 0) {
@@ -277,7 +277,7 @@ program
             { name: 'Documentation (agent-docs/)', value: 'docs', checked: true },
             { name: 'Agent Rules (security, testing, database, etc.)', value: 'rules', checked: true },
             { name: 'Skills (reusable agent capabilities)', value: 'skills', checked: true },
-            { name: 'AI Agent instructions (Cursor, Copilot, VSCode, Gemini)', value: 'github', checked: true }
+            { name: 'AI Agent instructions (Cursor, Copilot, Claude, Generic AGENTS)', value: 'github', checked: true }
           ],
           validate: (answer) => {
             if (answer.length === 0) {
@@ -337,17 +337,16 @@ program
         );
       }
 
-      // Install AI Agent instructions (Cursor, Copilot, VSCode, Gemini)
+      // Install AI Agent instructions (Cursor, Copilot, Claude, Generic AGENTS)
       if (options.github) {
         console.log(chalk.yellow('Installing AI agent instructions...'));
         await fs.ensureDir(path.join(targetDir, '.github', 'instructions'));
         await copyFiles(templateDir, targetDir, ['.cursorrules'], options.force);
         await writeGeneratedInstructions(targetDir, templateDir, options.force);
         console.log(chalk.gray('  ✓ Cursor (.cursorrules)'));
-        console.log(chalk.gray('  ✓ GitHub Copilot (.github/instructions/copilot-instructions.md + compat shim)'));
-        console.log(chalk.gray('  ✓ Generic AI (.github/instructions/AGENTS.md + compat shim)'));
-        console.log(chalk.gray('  ✓ Claude (.github/instructions/CLAUDE.md + compat shim)'));
-        console.log(chalk.gray('  ✓ Google Gemini (.github/instructions/GEMINI.md + compat shim)'));
+        console.log(chalk.gray('  ✓ GitHub Copilot (.github/copilot-instructions.md shim)'));
+        console.log(chalk.gray('  ✓ Claude (.claude/CLAUDE.md shim)'));
+        console.log(chalk.gray('  ✓ Generic AGENTS (AGENTS.MD shim + canonical .github/instructions/AGENTS.md)'));
       }
 
       // Show summary and next steps
@@ -379,7 +378,7 @@ program
     console.log(chalk.yellow('docs') + '    - Documentation files (agent-docs/ directory)');
     console.log(chalk.yellow('rules') + '   - Agent rules (.github/instructions/rules/*.mdc)');
     console.log(chalk.yellow('skills') + '  - Agent skills (.github/skills/*)');
-    console.log(chalk.yellow('github') + '  - AI Agent instructions (Cursor, Copilot, VSCode, Gemini)');
+    console.log(chalk.yellow('github') + '  - AI Agent instructions (Cursor, Copilot, Claude, Generic AGENTS)');
     console.log(chalk.yellow('all') + '     - All components');
     
     console.log(chalk.blue.bold('\n\nAvailable Presets:\n'));
@@ -470,10 +469,8 @@ program
       // Check generated instruction files and drift
       const hasInstructionFootprint =
         await fs.pathExists(path.join(targetDir, '.github', 'instructions')) ||
-        await fs.pathExists(path.join(targetDir, '.claude', 'rules')) ||
-        await fs.pathExists(path.join(targetDir, GENERATED_INSTRUCTION_PATHS.compatibility.copilot)) ||
         await fs.pathExists(path.join(targetDir, GENERATED_INSTRUCTION_PATHS.compatibility.claude)) ||
-        await fs.pathExists(path.join(targetDir, GENERATED_INSTRUCTION_PATHS.compatibility.gemini)) ||
+        await fs.pathExists(path.join(targetDir, GENERATED_INSTRUCTION_PATHS.compatibility.copilot)) ||
         await fs.pathExists(path.join(targetDir, GENERATED_INSTRUCTION_PATHS.compatibility.generic));
 
       if (hasInstructionFootprint) {
@@ -487,9 +484,8 @@ program
         }
       }
 
-      const canonicalCopilotFile = path.join(targetDir, GENERATED_INSTRUCTION_PATHS.canonical.copilot);
       const compatCopilotFile = path.join(targetDir, GENERATED_INSTRUCTION_PATHS.compatibility.copilot);
-      if (await fs.pathExists(canonicalCopilotFile) || await fs.pathExists(compatCopilotFile)) {
+      if (await fs.pathExists(compatCopilotFile)) {
         passed.push(`✓ GitHub Copilot configuration found`);
       } else {
         warnings.push(`⚠ GitHub Copilot configuration missing - run 'agents-templated init --github'`);
@@ -631,6 +627,18 @@ async function hasInstalledTemplates(targetDir) {
     await fs.pathExists(path.join(targetDir, GENERATED_INSTRUCTION_PATHS.compatibility.generic));
 }
 
+async function cleanupLegacyInstructionFiles(targetDir) {
+  const legacyFiles = ['CLAUDE.md', 'GEMINI.md'];
+
+  for (const file of legacyFiles) {
+    const filePath = path.join(targetDir, file);
+    if (await fs.pathExists(filePath)) {
+      await fs.remove(filePath);
+      console.log(chalk.green(`  ✓ Removed legacy file: ${file}`));
+    }
+  }
+}
+
 async function updateSelectedComponents(targetDir, templateDir, selectedComponents, overwrite = true) {
   const components = selectedComponents.includes('all')
     ? ['docs', 'rules', 'skills', 'github']
@@ -672,6 +680,7 @@ async function updateSelectedComponents(targetDir, templateDir, selectedComponen
     await fs.ensureDir(path.join(targetDir, '.github', 'instructions'));
     await copyFiles(templateDir, targetDir, ['.cursorrules'], overwrite);
     await writeGeneratedInstructions(targetDir, templateDir, overwrite);
+    await cleanupLegacyInstructionFiles(targetDir);
   }
 
   if ((components.includes('docs') || components.includes('github')) && !components.includes('github')) {
@@ -854,6 +863,7 @@ program
 
       await writeGeneratedInstructions(targetDir, templateDir, true);
       console.log(chalk.green('  ✓ Regenerated instruction compatibility files'));
+      await cleanupLegacyInstructionFiles(targetDir);
 
       console.log(chalk.green.bold('\n✅ Updates applied successfully!\n'));
       console.log(chalk.gray('Backup files created with .backup extension\n'));

package/index.js

@@ -69,7 +69,7 @@ async function install(targetDir, options = {}) {
     );
   }
 
-  // AI Agent instructions (Cursor, Copilot, Claude, Gemini)
+  // AI Agent instructions (Cursor, Copilot, Claude)
   if (installAll || options.github) {
     await fs.ensureDir(path.join(targetDir, '.github', 'instructions'));
 

package/lib/instructions.js

@@ -5,20 +5,12 @@ const CORE_SOURCE_REL_PATH = 'instructions/source/core.md';
 
 const GENERATED_INSTRUCTION_PATHS = {
   canonical: {
-    generic: '.github/instructions/AGENTS.md',
-    copilot: '.github/instructions/copilot-instructions.md',
-    claude: '.github/instructions/CLAUDE.md',
-    gemini: '.github/instructions/GEMINI.md'
-  },
-  styleCompat: {
-    githubInstructions: '.github/instructions/agents.instructions.md',
-    claudeRules: '.claude/rules/claude.instructions.md'
+    generic: '.github/instructions/AGENTS.md'
   },
   compatibility: {
     generic: 'AGENTS.MD',
     copilot: '.github/copilot-instructions.md',
-    claude: 'CLAUDE.md',
-    gemini: 'GEMINI.md'
+    claude: '.claude/CLAUDE.md'
   }
 };
 
@@ -39,22 +31,15 @@ function buildCompatInstruction(toolName, corePath) {
   const titles = {
     generic: '# AGENTS Instructions',
     copilot: '# GitHub Copilot Instructions',
-    claude: '# Claude Instructions',
-    gemini: '# Gemini Instructions'
+    claude: '# Claude Instructions'
   };
 
   return [
     `${titles[toolName]}`,
     '',
     `Primary policy source: \`${corePath}\`.`,
-    '',
-    'Always apply these mandatory rules:',
-    '- Security-first implementation (validate inputs, authz/authn, rate limiting).',
-    '- Testing-first delivery with unit + integration coverage for changed logic.',
-    '- Strong typing and runtime boundary validation.',
-    '- Do not expose secrets or sensitive data in logs/errors.',
-    '',
-    'Use the canonical source for full policy and architecture guidance.',
+    'Minimal compatibility stub to reduce duplicated prompt tokens.',
+    'Load rules from the canonical source file above.',
     ''
   ].join('\n');
 }
@@ -64,16 +49,9 @@ function buildGeneratedArtifacts(coreContent) {
   const files = {};
 
   files[GENERATED_INSTRUCTION_PATHS.canonical.generic] = `${buildHeaders('generic')}${coreContent.trim()}\n`;
-  files[GENERATED_INSTRUCTION_PATHS.canonical.copilot] = `${buildHeaders('copilot')}${buildCompatInstruction('copilot', corePath)}`;
-  files[GENERATED_INSTRUCTION_PATHS.canonical.claude] = `${buildHeaders('claude')}${buildCompatInstruction('claude', corePath)}`;
-  files[GENERATED_INSTRUCTION_PATHS.canonical.gemini] = `${buildHeaders('gemini')}${buildCompatInstruction('gemini', corePath)}`;
-  files[GENERATED_INSTRUCTION_PATHS.styleCompat.githubInstructions] = `${buildHeaders('github-instructions-style')}${buildCompatInstruction('generic', corePath)}`;
-  files[GENERATED_INSTRUCTION_PATHS.styleCompat.claudeRules] = `${buildHeaders('claude-rules-style')}${buildCompatInstruction('claude', corePath)}`;
-
   files[GENERATED_INSTRUCTION_PATHS.compatibility.generic] = `${buildHeaders('generic-compat')}${buildCompatInstruction('generic', corePath)}`;
   files[GENERATED_INSTRUCTION_PATHS.compatibility.copilot] = `${buildHeaders('copilot-compat')}${buildCompatInstruction('copilot', corePath)}`;
   files[GENERATED_INSTRUCTION_PATHS.compatibility.claude] = `${buildHeaders('claude-compat')}${buildCompatInstruction('claude', corePath)}`;
-  files[GENERATED_INSTRUCTION_PATHS.compatibility.gemini] = `${buildHeaders('gemini-compat')}${buildCompatInstruction('gemini', corePath)}`;
 
   return files;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-templated",
-  "version": "1.2.11",
+  "version": "1.2.12",
   "description": "Technology-agnostic development template with multi-AI agent support (Cursor, Copilot, VSCode, Gemini), security-first patterns, and comprehensive testing guidelines",
   "main": "index.js",
   "bin": {

package/templates/GEMINI.md

@@ -1,142 +0,0 @@
-# Google Gemini AI Instructions
-
-This project uses enterprise-grade, technology-agnostic development patterns for all Google Gemini AI assistants, whether used through:
-- Google AI Studio (aistudio.google.com)
-- Gemini IDE extensions
-- Gemini API integration
-- Other Gemini-powered tools
-
-## Quick Start
-
-- **AI Guide**: See `AGENTS.MD` for comprehensive instructions
-- **Architecture**: See `agent-docs/ARCHITECTURE.md` for project guidelines
-- **Custom Skills**: See `agents/skills/` directory for domain-specific extensions
-- **Detailed Rules**: See `agents/rules/*.mdc` files
-- **Available Skills**: Check `agents/skills/` for project-specific skills
-
-## Core Development Patterns
-
-Follow these enterprise-grade patterns for all development work:
-
-### 1. Security-First Approach
-- **Validate all inputs**: Use schema validation for all user inputs and API requests
-- **Authentication**: Implement secure session management and authentication flows
-- **Authorization**: Apply role-based access control with proper middleware
-- **Rate limiting**: Protect public endpoints from abuse with appropriate rate limiting
-- **Error handling**: Never expose sensitive data in error messages or logs
-- **Database safety**: Use ORM/ODM patterns exclusively, avoid raw SQL queries
-- Reference: `agents/rules/security.mdc`
-
-### 2. Testing Requirements
-- **Unit tests**: Target 80% coverage for business logic
-- **Integration tests**: 15% coverage for API and database operations
-- **E2E tests**: 5% coverage for critical user journeys
-- All business logic must have appropriate test cases
-- Reference: `agents/rules/testing.mdc`
-
-### 3. Type Safety & Validation
-- Use strong typing systems available in your language of choice
-- Implement runtime validation at all API boundaries
-- Apply schema validation to form inputs and API requests
-- Reference: `agents/rules/core.mdc`
-
-### 4. Code Quality Standards
-- **Readability**: Clear variable names, proper documentation, logical organization
-- **Type safety**: Strict typing throughout, no loose type usage
-- **Performance**: Monitor resource usage, implement caching, optimize queries
-- **Maintainability**: Modular design, separation of concerns, SOLID principles
-- **Accessibility**: WCAG 2.1 AA compliance for all user-facing interfaces
-- Reference: `agents/rules/style.mdc`
-
-## Agent-Based Development
-
-This project follows an agent-based pattern where different roles handle different aspects:
-
-| Agent | Responsibility | Reference |
-|-------|-----------------|-----------|
-| **FrontendAgent** | UI/Design, components, accessibility, responsive layouts | `agents/rules/frontend.mdc` |
-| **BackendAgent** | API routes, business logic, authentication, services | `agents/rules/security.mdc` |
-| **DatabaseAgent** | Schema design, migrations, data access, optimization | `agents/rules/database.mdc` |
-| **TestAgent** | Testing strategy, coverage, test organization | `agents/rules/testing.mdc` |
-| **SecurityAgent** | Security patterns, validation, rate limiting, access control | `agents/rules/security.mdc` |
-| **ReviewerAgent** | Code quality, performance, accessibility, architecture | All rules |
-
-When implementing features, identify which agent responsibility applies and refer to the appropriate rules file.
-
-## Deterministic Slash Commands
-
-- Slash command protocol is defined in `AGENTS.MD` under `Deterministic Slash Command System Standard`.
-- Modular command contracts are stored in `agents/commands/`.
-- Command mode is strict: unknown or malformed slash commands must return structured error output and stop.
-- No conversational fallback is allowed once slash-command mode is entered.
-- Destructive actions require explicit confirmation token format: `CONFIRM-DESTRUCTIVE:<target>`.
-
-## Technology Stack Independence
-
-These patterns apply regardless of your tech stack. Adapt them to your chosen framework:
-
-### Frontend Frameworks
-- **React/Next.js/Vue/Svelte**: Component-based architecture with state management
-- **Angular**: Component + service pattern with TypeScript
-- **Traditional/Server-rendered**: Progressive enhancement with server-side rendering
-
-### Backend Frameworks
-- **Node.js**: Express, Fastify, Koa, or Next.js API routes
-- **Python**: Django, FastAPI, Flask with ORM patterns
-- **Go**: Gin, Echo, Fiber for high-performance APIs
-- **Other languages**: Apply patterns to your chosen framework
-
-### Database Technologies
-- **SQL**: PostgreSQL, MySQL, SQLite with ORM (Prisma, TypeORM, SQLAlchemy, etc.)
-- **NoSQL**: MongoDB, DynamoDB with schema validation
-- **Cloud-native**: Supabase, Firebase with built-in security
-
-## Critical Rules (Never Skip These)
-
-1. **Input Validation**: ALL user inputs must be validated with schema validation libraries
-2. **Authentication**: Implement secure authentication with proper session management
-3. **Rate Limiting**: Public endpoints MUST have rate limiting to prevent abuse
-4. **Authorization**: Role-based access control with verified permissions
-5. **Data Safety**: Never expose sensitive information in error responses
-6. **Database Access**: Use ORM/ODM exclusively, never raw queries for user data
-7. **Test Coverage**: Minimum 80% coverage for business logic
-8. **Accessibility**: WCAG 2.1 AA compliance for all user interfaces
-9. **Documentation**: Keep guides updated; code should be self-documenting
-10. **Performance**: Monitor metrics, implement caching, optimize critical paths
-
-## File Reference Guide
-
-| File | Purpose | When to Use |
-|------|---------|------------|
-| `AGENTS.MD` | Primary AI assistant guide | Always start here |
-| `agent-docs/ARCHITECTURE.md` | Architecture and technology stack decisions | Need architectural guidance |
-| `AGENTS.MD` | AI assistant guide and patterns | How to work effectively with AI |
-| `agents/commands/` | Deterministic slash command contracts | Slash-command execution |
-| `agents/rules/core.mdc` | Core development principles | General development questions |
-| `agents/rules/security.mdc` | Security patterns and implementations | Building secure features |
-| `agents/rules/testing.mdc` | Testing strategy and best practices | Writing tests or test strategy |
-| `agents/rules/frontend.mdc` | Frontend patterns and components | Building UI features |
-| `agents/rules/database.mdc` | Database and data access patterns | Working with data layers |
-| `agents/rules/style.mdc` | Code style and formatting | Code style questions |
-| `agents/skills/` | Domain-specific implementations | Looking for reusable patterns |
-
-## Workflow Recommendations
-
-1. **Read AGENTS.MD** for comprehensive AI assistance guidance
-2. **Read agent-docs/ARCHITECTURE.md** to understand the overall architecture
-3. **Reference AGENTS.MD** for AI working patterns and guidance
-3. **Reference the appropriate rule file** for implementation patterns
-4. **Look in agents/skills/** for domain-specific guidance
-5. **Follow all critical rules** without exception
-6. **Apply patterns consistently** across the codebase
-
-## Additional Context
-
-- This template is **completely technology-agnostic** and works with any programming language
-- All patterns are **framework and language-independent**
-- The rules can be adapted to your specific tech stack while maintaining the security and quality principles
-- Skills in `agents/skills/` provide specific, actionable implementations
-
----
-
-For best results with Gemini AI assistance, reference the appropriate context from `AGENTS.MD`, `agent-docs/ARCHITECTURE.md`, and the relevant `agents/rules/*.mdc` files in your prompts.