agents-templated 2.2.0 → 2.2.1

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/agents-templated.svg)](https://www.npmjs.com/package/agents-templated)
 [![npm downloads](https://img.shields.io/npm/dm/agents-templated.svg)](https://www.npmjs.com/package/agents-templated)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![GitHub stars](https://img.shields.io/github/stars/rickandrew2/agents-projects-templated?style=social)](https://github.com/rickandrew2/agents-templated)
+[![GitHub stars](https://img.shields.io/github/stars/rickandrew2/agents-templated?style=social)](https://github.com/rickandrew2/agents-templated)
 
 > **Agents Templated** is a CLI tool and npm package that instantly scaffolds production-ready project structures with enterprise-grade development patterns, security guidelines, and AI assistant configurations. Designed for developers who want to start projects the right way—with proven OWASP security practices, comprehensive testing strategies (80/15/5 coverage targets), and agent-based architecture patterns—without being locked into specific frameworks. It generates unified configuration files that work seamlessly with Cursor, GitHub Copilot, Claude, and Google Gemini, allowing AI assistants to automatically follow best practices from day one. Whether you're building a Next.js app, Django API, Go microservice, or any custom stack, Agents Templated provides the guardrails and patterns you need while giving you complete freedom to choose your technology.
 
@@ -28,13 +28,13 @@ Agents Templated scaffolds your project with:
 - Deterministic slash-command standard in `AGENTS.MD` and modular contracts in `agents/commands/`
 - Implicit natural-language routing support (`slash-command-auto`) for non-technical prompts
 - New workflow/routing/hardening rule set:
-  - `agents/rules/intent-routing.mdc`
-  - `agents/rules/system-workflow.mdc`
-  - `agents/rules/hardening.mdc`
+  - `.github/instructions/rules/intent-routing.mdc`
+  - `.github/instructions/rules/system-workflow.mdc`
+  - `.github/instructions/rules/hardening.mdc`
 - New baseline skills:
-  - `agents/skills/feature-delivery/`
-  - `agents/skills/bug-triage/`
-  - `agents/skills/app-hardening/`
+  - `.github/skills/feature-delivery/`
+  - `.github/skills/bug-triage/`
+  - `.github/skills/app-hardening/`
 - Release and audit contracts now require hardening evidence when risk profile requires it
 
 ---
@@ -124,7 +124,7 @@ Agents Templated automatically configures compatible wrappers for major AI codin
 | **Claude** | `CLAUDE.md` | ✅ Compatible |
 | **Generic agents** | `AGENTS.MD` | ✅ Compatible |
 
-**Single source of truth:** `instructions/source/core.md` drives generated tool-compatible instruction files.
+**Single source of truth:** `CLAUDE.md` drives generated tool-compatible instruction files.
 
 ---
 
@@ -421,7 +421,7 @@ await agentsTemplated.install('./my-project', {
 
 When contributing to this template:
 1. Maintain technology-agnostic patterns
-2. Update relevant rule files in `agents/rules/`
+2. Update relevant rule files in `.github/instructions/rules/`
 3. Keep documentation synchronized with code changes
 4. Follow security and testing patterns
 5. Ensure AI assistant configurations remain compatible

package/bin/cli.js

@@ -125,7 +125,7 @@ program
               { name: 'Agent rules (.github/instructions/rules/*.mdc)', value: 'rules' },
               { name: 'Skills (.github/skills/*)', value: 'skills' },
               { name: 'AI Agent instructions (Cursor, Copilot, Claude, Generic AGENTS)', value: 'github' },
-              { name: 'Agent subagents (agents/subagents/*.md)', value: 'subagents' }
+              { name: 'Agent subagents (.claude/agents/*.md)', value: 'subagents' }
             ],
             default: ['all']
           },
@@ -190,6 +190,7 @@ program
         await writeGeneratedInstructions(targetDir, templateDir, options.force);
         console.log(chalk.gray('  ✓ Claude (CLAUDE.md — canonical source)'));
         console.log(chalk.gray('  ✓ GitHub Copilot (.github/copilot-instructions.md pointer)'));
+        console.log(chalk.gray('  ✓ Cursor (.cursorrules pointer)'));
         console.log(chalk.gray('  ✓ Generic AGENTS (AGENTS.MD pointer)'));
       }
 
@@ -198,7 +199,7 @@ program
         console.log(chalk.yellow('Installing agent subagents...'));
         await fs.ensureDir(path.join(targetDir, LAYOUT.canonical.subagentsDir));
         await copyDirectory(
-          path.join(templateDir, 'agents', 'subagents'),
+          path.join(templateDir, '.claude', 'agents'),
           path.join(targetDir, LAYOUT.canonical.subagentsDir),
           options.force
         );
@@ -257,7 +258,7 @@ program
                 { name: 'Agent Rules (security, testing, database, etc.)', value: 'rules' },
                 { name: 'Skills (reusable agent capabilities)', value: 'skills' },
                 { name: 'AI Agent instructions (Cursor, Copilot, Claude, Generic AGENTS)', value: 'github' },
-                { name: 'Agent subagents (agents/subagents/*.md)', value: 'subagents' }
+                { name: 'Agent subagents (.claude/agents/*.md)', value: 'subagents' }
               ],
               validate: (answer) => {
                 if (answer.length === 0) {
@@ -294,7 +295,7 @@ program
             { 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, Claude, Generic AGENTS)', value: 'github', checked: true },
-            { name: 'Agent subagents (agents/subagents/*.md)', value: 'subagents', checked: true }
+            { name: 'Agent subagents (.claude/agents/*.md)', value: 'subagents', checked: true }
           ],
           validate: (answer) => {
             if (answer.length === 0) {
@@ -369,7 +370,7 @@ program
         console.log(chalk.yellow('Installing agent subagents...'));
         await fs.ensureDir(path.join(targetDir, LAYOUT.canonical.subagentsDir));
         await copyDirectory(
-          path.join(templateDir, 'agents', 'subagents'),
+          path.join(templateDir, '.claude', 'agents'),
           path.join(targetDir, LAYOUT.canonical.subagentsDir),
           options.force
         );
@@ -405,7 +406,7 @@ program
     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, Claude, Generic AGENTS)');
-    console.log(chalk.yellow('subagents') + ' - Agent subagents (agents/subagents/*.md)');
+    console.log(chalk.yellow('subagents') + ' - Agent subagents (.claude/agents/*.md)');
     console.log(chalk.yellow('all') + '     - All components');
     
     console.log(chalk.blue.bold('\n\nAvailable Presets:\n'));
@@ -653,7 +654,6 @@ async function cleanupLegacyInstructionFiles(targetDir) {
   // Files removed in v2.0.0: orphaned wrappers that contained duplicated policy
   // content and were not managed/validated by the generator.
   const legacyFiles = [
-    '.cursorrules',
     '.github/instructions/AGENTS.md',
     // Pre-v1.2.13 paths
     '.claude/CLAUDE.md'
@@ -714,7 +714,7 @@ async function updateSelectedComponents(targetDir, templateDir, selectedComponen
     console.log(chalk.yellow('Updating agent subagents...'));
     await fs.ensureDir(path.join(targetDir, LAYOUT.canonical.subagentsDir));
     await copyDirectory(
-      path.join(templateDir, 'agents', 'subagents'),
+      path.join(templateDir, '.claude', 'agents'),
       path.join(targetDir, LAYOUT.canonical.subagentsDir),
       overwrite
     );
@@ -1031,7 +1031,7 @@ program
 
 program
   .command('new-subagent <name>')
-  .description('Scaffold a new subagent in agents/subagents/<name>.md')
+  .description('Scaffold a new subagent in .claude/agents/<name>.md')
   .action(async (name) => {
     try {
       const targetDir = process.cwd();

package/index.js

@@ -16,12 +16,13 @@ const { CANONICAL_INSTRUCTION_FILE, writeGeneratedInstructions } = require('./li
  * @param {boolean} options.rules - Install agent rules
  * @param {boolean} options.skills - Install skills
  * @param {boolean} options.github - Install GitHub Copilot instructions
+ * @param {boolean} options.subagents - Install agent subagents
  * @param {boolean} options.force - Overwrite existing files
  * @returns {Promise<void>}
  */
 async function install(targetDir, options = {}) {
   const templateDir = path.join(__dirname, 'templates');
-  const installAll = !options.docs && !options.rules && !options.skills && !options.github;
+  const installAll = !options.docs && !options.rules && !options.skills && !options.github && !options.subagents;
 
   const files = [];
 
@@ -73,6 +74,16 @@ async function install(targetDir, options = {}) {
     await fs.ensureDir(path.join(targetDir, '.github', 'instructions'));
     await writeGeneratedInstructions(targetDir, templateDir, options.force);
   }
+
+  // Agent subagents (.claude/agents/)
+  if (installAll || options.subagents) {
+    await fs.ensureDir(path.join(targetDir, '.claude', 'agents'));
+    await copyDirectory(
+      path.join(templateDir, '.claude', 'agents'),
+      path.join(targetDir, '.claude', 'agents'),
+      options.force
+    );
+  }
 }
 
 async function copyDirectory(sourceDir, targetDir, force = false) {

package/lib/instructions.js

@@ -7,7 +7,8 @@ const CANONICAL_INSTRUCTION_FILE = 'CLAUDE.md';
 // Thin compatibility pointer files — policy lives in CLAUDE.md, not here.
 const POINTER_FILES = {
   agents: 'AGENTS.MD',
-  copilot: '.github/copilot-instructions.md'
+  copilot: '.github/copilot-instructions.md',
+  cursor: '.cursorrules'
 };
 
 function buildAgentsPointer() {
@@ -31,6 +32,17 @@ function buildCopilotPointer() {
   ].join('\n');
 }
 
+function buildCursorPointer() {
+  return [
+    '<!-- Tool profile: cursor-compat -->',
+    '# Cursor Rules',
+    '',
+    'Primary policy source: `CLAUDE.md`.',
+    'Load policy only from the canonical source file above.',
+    'If this file and CLAUDE.md conflict, CLAUDE.md wins.'
+  ].join('\n');
+}
+
 async function writeGeneratedInstructions(targetDir, templateDir, force = false) {
   // Copy CLAUDE.md from template if not present (or forced)
   const targetClaude = path.join(targetDir, CANONICAL_INSTRUCTION_FILE);
@@ -42,7 +54,8 @@ async function writeGeneratedInstructions(targetDir, templateDir, force = false)
   // Write thin pointer files
   const pointers = {
     [POINTER_FILES.agents]: buildAgentsPointer(),
-    [POINTER_FILES.copilot]: buildCopilotPointer()
+    [POINTER_FILES.copilot]: buildCopilotPointer(),
+    [POINTER_FILES.cursor]: buildCursorPointer()
   };
 
   for (const [relPath, content] of Object.entries(pointers)) {
@@ -63,7 +76,8 @@ async function validateInstructionDrift(targetDir) {
   const driftFiles = [];
   const expectedPointers = {
     [POINTER_FILES.agents]: buildAgentsPointer(),
-    [POINTER_FILES.copilot]: buildCopilotPointer()
+    [POINTER_FILES.copilot]: buildCopilotPointer(),
+    [POINTER_FILES.cursor]: buildCursorPointer()
   };
 
   for (const [relPath, expectedContent] of Object.entries(expectedPointers)) {
@@ -158,10 +172,10 @@ async function scaffoldRule(targetDir, ruleName) {
 }
 
 async function scaffoldSubagent(targetDir, name) {
-  const subagentFile = path.join(targetDir, 'agents', 'subagents', `${name}.md`);
+  const subagentFile = path.join(targetDir, '.claude', 'agents', `${name}.md`);
 
   if (await fs.pathExists(subagentFile)) {
-    throw new Error(`Subagent already exists: agents/subagents/${name}.md`);
+    throw new Error(`Subagent already exists: .claude/agents/${name}.md`);
   }
 
   const title = name.split('-').map(w => w[0].toUpperCase() + w.slice(1)).join(' ');
@@ -195,7 +209,7 @@ async function scaffoldSubagent(targetDir, name) {
 
   await fs.ensureDir(path.dirname(subagentFile));
   await fs.writeFile(subagentFile, content, 'utf8');
-  return `agents/subagents/${name}.md`;
+  return `.claude/agents/${name}.md`;
 }
 
 module.exports = {

package/lib/layout.js

@@ -6,7 +6,7 @@ const LAYOUT = {
     docsDir: 'agent-docs',
     rulesDir: '.github/instructions/rules',
     skillsDir: '.github/skills',
-    subagentsDir: 'agents/subagents'
+    subagentsDir: '.claude/agents'
   },
   legacy: {
     rulesDirs: ['agents/rules'],
@@ -41,7 +41,7 @@ function resolveSkillsDir(baseDir) {
 }
 
 function resolveSubagentsDir(baseDir) {
-  const candidates = [LAYOUT.canonical.subagentsDir];
+  const candidates = [LAYOUT.canonical.subagentsDir, 'agents/subagents'];
   return firstExistingPath(baseDir, candidates) || LAYOUT.canonical.subagentsDir;
 }
 
@@ -50,6 +50,7 @@ async function hasAnyLayout(baseDir) {
     path.join(baseDir, LAYOUT.canonical.rulesDir),
     path.join(baseDir, LAYOUT.canonical.skillsDir),
     path.join(baseDir, LAYOUT.canonical.subagentsDir),
+    path.join(baseDir, 'agents', 'subagents'),
     ...LAYOUT.compatible.rulesDirs.map((relPath) => path.join(baseDir, relPath)),
     ...LAYOUT.compatible.skillsDirs.map((relPath) => path.join(baseDir, relPath)),
     ...LAYOUT.legacy.rulesDirs.map((relPath) => path.join(baseDir, relPath)),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-templated",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "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/{agents/subagents → .claude/agents}/README.md

@@ -41,12 +41,12 @@ Subagents are invoked automatically based on `description` matching, or explicit
 ```
 
 ### Other tools (Copilot, Cursor, Windsurf)
-Reference the subagent file directly in your prompt or instruct your AI to follow the workflow defined in `agents/subagents/<name>.md`.
+Reference the subagent file directly in your prompt or instruct your AI to follow the workflow defined in `.claude/agents/<name>.md`.
 
 ## File Structure
 
 ```
-agents/subagents/
+.claude/agents/
 ├── README.md                  ← This file
 ├── planner.md
 ├── architect.md

package/templates/.cursorrules

@@ -1,9 +1,6 @@
-<!-- GENERATED FILE - DO NOT EDIT DIRECTLY -->
-<!-- Source of truth: instructions/source/core.md -->
 <!-- Tool profile: cursor-compat -->
 # Cursor Rules
 
-Primary policy source: `instructions/source/core.md`.
+Primary policy source: `CLAUDE.md`.
 Load policy only from the canonical source file above.
-Do not duplicate, summarize, or inline rules in this file.
-If this file and the canonical source conflict, the canonical source wins.
+If this file and CLAUDE.md conflict, CLAUDE.md wins.

package/templates/CLAUDE.md

@@ -39,19 +39,19 @@ All policy, routing, and skill governance lives here — edit this file directly
 
 Skills add capability only. They must not override security, testing, or core constraints.
 
-### Subagent modules (`agents/subagents/`)
+### Subagent modules (`.claude/agents/`)
 
 | Subagent | Path | Invoke when... |
 |----------|------|----------------|
-| planner | `agents/subagents/planner.md` | Breaking down features into phased plans |
-| architect | `agents/subagents/architect.md` | System design decisions, ADRs, trade-off analysis |
-| tdd-guide | `agents/subagents/tdd-guide.md` | Writing tests before implementation |
-| code-reviewer | `agents/subagents/code-reviewer.md` | Reviewing code for quality and correctness |
-| security-reviewer | `agents/subagents/security-reviewer.md` | Scanning for security vulnerabilities |
-| build-error-resolver | `agents/subagents/build-error-resolver.md` | Fixing build and type errors |
-| e2e-runner | `agents/subagents/e2e-runner.md` | Running Playwright E2E test suites |
-| refactor-cleaner | `agents/subagents/refactor-cleaner.md` | Removing dead code and unused dependencies |
-| doc-updater | `agents/subagents/doc-updater.md` | Syncing docs and READMEs after code changes |
+| planner | `.claude/agents/planner.md` | Breaking down features into phased plans |
+| architect | `.claude/agents/architect.md` | System design decisions, ADRs, trade-off analysis |
+| tdd-guide | `.claude/agents/tdd-guide.md` | Writing tests before implementation |
+| code-reviewer | `.claude/agents/code-reviewer.md` | Reviewing code for quality and correctness |
+| security-reviewer | `.claude/agents/security-reviewer.md` | Scanning for security vulnerabilities |
+| build-error-resolver | `.claude/agents/build-error-resolver.md` | Fixing build and type errors |
+| e2e-runner | `.claude/agents/e2e-runner.md` | Running Playwright E2E test suites |
+| refactor-cleaner | `.claude/agents/refactor-cleaner.md` | Removing dead code and unused dependencies |
+| doc-updater | `.claude/agents/doc-updater.md` | Syncing docs and READMEs after code changes |
 
 Subagents are bounded agents with limited tool access. They inherit all policy from this file and may not override security, testing, or core constraints.
 

package/templates/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/agents-templated.svg)](https://www.npmjs.com/package/agents-templated)
 [![npm downloads](https://img.shields.io/npm/dm/agents-templated.svg)](https://www.npmjs.com/package/agents-templated)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![GitHub stars](https://img.shields.io/github/stars/rickandrew2/agents-projects-templated?style=social)](https://github.com/rickandrew2/agents-templated)
+[![GitHub stars](https://img.shields.io/github/stars/rickandrew2/agents-templated?style=social)](https://github.com/rickandrew2/agents-templated)
 
 > **Agents Templated** is a CLI tool and npm package that instantly scaffolds production-ready project structures with enterprise-grade development patterns, security guidelines, and AI assistant configurations. Designed for developers who want to start projects the right way—with proven OWASP security practices, comprehensive testing strategies (80/15/5 coverage targets), and agent-based architecture patterns—without being locked into specific frameworks. It generates unified configuration files that work seamlessly with Cursor, GitHub Copilot, Claude, and Google Gemini, allowing AI assistants to automatically follow best practices from day one. Whether you're building a Next.js app, Django API, Go microservice, or any custom stack, Agents Templated provides the guardrails and patterns you need while giving you complete freedom to choose your technology.
 
@@ -105,7 +105,7 @@ Agents Templated automatically configures compatible wrappers for major AI codin
 | **Claude** | `CLAUDE.md` | ✅ Compatible |
 | **Generic agents** | `AGENTS.MD` | ✅ Compatible |
 
-**Single source of truth:** `instructions/source/core.md` drives generated tool-compatible instruction files.
+**Single source of truth:** `CLAUDE.md` drives generated tool-compatible instruction files.
 
 ---
 
@@ -395,7 +395,7 @@ await agentsTemplated.install('./my-project', {
 
 When contributing to this template:
 1. Maintain technology-agnostic patterns
-2. Update relevant rule files in `agents/rules/`
+2. Update relevant rule files in `.github/instructions/rules/`
 3. Keep documentation synchronized with code changes
 4. Follow security and testing patterns
 5. Ensure AI assistant configurations remain compatible

package/templates/agent-docs/ARCHITECTURE.md

@@ -3,7 +3,7 @@
 This is a **technology-agnostic development template** with enterprise-grade patterns for security, testing, and developer experience.
 These guidelines are for both humans and AI assistants working with any technology stack.
 
-- Canonical AI policy source lives in `instructions/source/core.md`.
+- Canonical AI policy source lives in `CLAUDE.md`.
 - **Agent responsibilities** and MCP integration are documented in `AGENTS.MD`.
 - **Detailed implementation rules** live in `.github/instructions/rules/*.mdc` files.
 - **Custom skills** for domain-specific tasks are organized in `.github/skills/` (see [Skills Guide](../.github/skills/README.md)).
@@ -224,8 +224,8 @@ Review the options above and select technologies that fit your:
 
 ### 2. Adapt the Template
 - Update `.github/instructions/rules/*.mdc` files with technology-specific patterns
-- Keep `.cursorrules`, `.github/copilot-instructions.md`, `AGENTS.MD`, and `CLAUDE.md` as minimal wrappers that point to `instructions/source/core.md`
-- Update `instructions/source/core.md` with stack-specific guidelines
+- Keep `.cursorrules`, `.github/copilot-instructions.md`, `AGENTS.MD`, and `CLAUDE.md` as minimal wrappers that point to `CLAUDE.md`
+- Update `CLAUDE.md` with stack-specific guidelines
 - Create appropriate configuration files for your chosen tools
 
 ### 3. Implement Core Patterns

package/templates/agent-docs/README.md

@@ -6,12 +6,11 @@ This template has been installed by the agents-templated npm package.
 
 Depending on what you installed, you may have:
 
-- **AGENTS.MD**: Agent patterns and delegation guide
+- **AGENTS.MD**: Generic compatibility wrapper for AI assistants
 - **ARCHITECTURE.md**: Project guidelines and architecture
-- **AGENTS.MD**: Instructions for AI assistants
-- **agents/rules/**: Development rules and patterns (6 files)
-- **agents/skills/**: Reusable agent skills
-- **instructions/source/core.md**: Canonical policy source (single source of truth)
+- **CLAUDE.md**: Canonical policy source (single source of truth)
+- **.github/instructions/rules/**: Rule modules (`*.mdc`)
+- **.github/skills/**: Skill modules (`*/SKILL.md`)
 - **CLAUDE.md**: Claude compatibility wrapper
 - **.github/copilot-instructions.md**: GitHub Copilot compatibility wrapper
 - **.cursorrules**: Cursor compatibility wrapper
@@ -36,8 +35,8 @@ agents-templated list
 
 ## Rules and Skills
 
-- **Rules** (`agents/rules/*.mdc`): Define *how to behave* - patterns, principles, and standards for your team
-- **Skills** (`agents/skills/*/SKILL.md`): Define *how to execute specific tasks* - domain-specific workflows and specialized knowledge
+- **Rules** (`.github/instructions/rules/*.mdc`): Define *how to behave* - patterns, principles, and standards for your team
+- **Skills** (`.github/skills/*/SKILL.md`): Define *how to execute specific tasks* - domain-specific workflows and specialized knowledge
 
 ### Using Skills in Your AI Assistants
 
@@ -45,31 +44,31 @@ Skills can be referenced in all AI configuration files:
 
 **In `.cursorrules` (Cursor IDE):**
 ```
-When the user asks about [domain], use the [skill-name] skill from agents/skills/
+When the user asks about [domain], use the [skill-name] skill from .github/skills/[skill-name]/SKILL.md
 ```
 
 **In `CLAUDE.md` (Claude):**
 ```
 
-When working on [domain-specific task], reference the [skill-name] skill in agents/skills/[skill-name]/SKILL.md
+When working on [domain-specific task], reference the [skill-name] skill in .github/skills/[skill-name]/SKILL.md
 ```
 
 **In `.github/copilot-instructions.md` (GitHub Copilot):**
 ```
-When helping with [domain-specific task], reference the [skill-name] skill from agents/skills/[skill-name]/SKILL.md
+When helping with [domain-specific task], reference the [skill-name] skill from .github/skills/[skill-name]/SKILL.md
 ```
 
-All wrappers point to `instructions/source/core.md`, and skills can be referenced from any assistant through that canonical policy. Create custom skills in `agents/skills/` to extend capabilities across your entire team.
+All wrappers point to `CLAUDE.md`, and skills can be referenced from any assistant through that canonical policy. Create custom skills in `.github/skills/` to extend capabilities across your entire team.
 
 ## Getting Started
 
 1. Review AGENTS.MD for AI assistance guidance
 2. Review ARCHITECTURE.md for overall project guidelines
 3. Adapt the rules to your specific technology stack
-4. Create custom skills in `agents/skills/` for your domain
+4. Create custom skills in `.github/skills/` for your domain
 5. Configure your AI assistants (Cursor, Copilot, Claude, generic agents) to reference your skills
 
 ## Documentation
 
-For full documentation, visit: https://github.com/rickandrew2/agents-projects-templated
+For full documentation, visit: https://github.com/rickandrew2/agents-templated
 

package/templates/agents/skills/README.md

@@ -34,7 +34,7 @@ To create a new skill for your specific domain:
 
 1. **Create a new folder** in this directory:
    ```
-   agents/skills/my-custom-skill/
+   .github/skills/my-custom-skill/
    ```
 
 2. **Create a SKILL.md file** with metadata and instructions:
@@ -54,7 +54,7 @@ To create a new skill for your specific domain:
 ### Skill Structure
 
 ```
-agents/skills/
+.github/skills/
 ├── find-skills/
 │   └── SKILL.md              # Meta-skill for discovering skills
 ├── feature-delivery/
@@ -104,24 +104,24 @@ Skills can be referenced in all your AI assistant configuration files:
 
 ### Cursor IDE (`.cursorrules`)
 ```
-When the user asks about [domain], use the [skill-name] skill from agents/skills/[skill-name]/SKILL.md
+When the user asks about [domain], use the [skill-name] skill from .github/skills/[skill-name]/SKILL.md
 ```
 
 ### Claude (`CLAUDE.md`)
 ```markdown
 ## When Working on [Domain]
 
-Reference the [skill-name] skill in `agents/skills/[skill-name]/SKILL.md` for patterns and guidance.
+Reference the [skill-name] skill in `.github/skills/[skill-name]/SKILL.md` for patterns and guidance.
 ```
 
 ### GitHub Copilot (`.github/copilot-instructions.md`)
 ```markdown
-When helping with [domain-specific task], reference the [skill-name] skill from `agents/skills/[skill-name]/SKILL.md`
+When helping with [domain-specific task], reference the [skill-name] skill from `.github/skills/[skill-name]/SKILL.md`
 ```
 
 ### Documentation (`AGENTS.MD`)
 ```markdown
-- When working with [domain], see the [skill-name] skill in `agents/skills/[skill-name]/SKILL.md`
+- When working with [domain], see the [skill-name] skill in `.github/skills/[skill-name]/SKILL.md`
 ```
 
 **All AI assistants support skill references.** Keep your team aligned by linking to skill files across your configuration files.

package/templates/instructions/source/core.md

@@ -1,219 +0,0 @@
-# Core AI Development Contract (Canonical Source)
-
-This file is the single canonical instruction source for all AI agents in this repository.
-
-All other instruction files (CLAUDE.md, AGENTS.MD, .github/copilot-instructions.md, .cursorrules, etc.)
-must act only as thin wrappers that reference this file.
-
-Do NOT duplicate policy content outside this file.
-
----
-
-## Reference Index
-
-### Rule Modules — `.github/instructions/rules/`
-
-| Module | File | Governs |
-|--------|------|---------|
-| Security | `.github/instructions/rules/security.mdc` | Input validation, authz/authn, secrets, rate limiting |
-| Testing | `.github/instructions/rules/testing.mdc` | Test strategy, coverage targets, test discipline |
-| Core | `.github/instructions/rules/core.mdc` | Type safety, runtime boundaries, error modeling |
-| Database | `.github/instructions/rules/database.mdc` | ORM patterns, migrations, query safety |
-| Frontend | `.github/instructions/rules/frontend.mdc` | Accessibility, responsiveness, client-side trust |
-| Style | `.github/instructions/rules/style.mdc` | Naming, modularity, separation of concerns |
-| System Workflow | `.github/instructions/rules/system-workflow.mdc` | Branch strategy, PR structure, review gates |
-| Workflows | `.github/instructions/rules/workflows.mdc` | Automation, CI/CD, deployment gates |
-| Hardening | `.github/instructions/rules/hardening.mdc` | Threat modeling, audit mode, dependency review |
-| Intent Routing | `.github/instructions/rules/intent-routing.mdc` | Deterministic task-to-rule mapping |
-
-### Skill Modules — `.github/skills/`
-
-| Skill | Path | Activate when... |
-|-------|------|------------------|
-| app-hardening | `.github/skills/app-hardening/SKILL.md` | User requests hardening, anti-tamper, or integrity controls |
-| bug-triage | `.github/skills/bug-triage/SKILL.md` | User reports something broken, failing, or crashing |
-| feature-delivery | `.github/skills/feature-delivery/SKILL.md` | User says "build", "add", or "implement" a feature |
-| find-skills | `.github/skills/find-skills/SKILL.md` | User asks "find a skill for X" or "is there a skill that..." |
-| ui-ux-pro-max | `.github/skills/ui-ux-pro-max/SKILL.md` | User requests UI, design, layout, or visual work |
-
-> Skills augment capability only. They MUST NOT override security, testing, or core constraints.
-
----
-
-## System Overview
-
-This project follows enterprise-grade, technology-agnostic development standards with:
-
-- Security-first architecture
-- Strong typing and runtime validation
-- Deterministic agent delegation
-- Structured testing strategy
-- Accessibility and quality enforcement
-- Modular skill-based capability extensions
-
----
-
-## Always Enforce
-
-### 1. Security-First (NON-OVERRIDABLE)
-Reference: `.github/instructions/rules/security.mdc`
-
-- Validate ALL external inputs at system boundaries
-- Authenticate protected endpoints — no exceptions
-- Authorize role-based access on every protected operation
-- Rate limit all public APIs
-- Never expose secrets, credentials, or PII in logs, errors, or responses
-- Apply secure-by-default patterns throughout
-
-No skill, command, or wrapper may downgrade or bypass these requirements.
-
----
-
-### 2. Testing Discipline (NON-OVERRIDABLE)
-Reference: `.github/instructions/rules/testing.mdc`
-
-Target distribution:
-- Unit: 80%
-- Integration: 15%
-- E2E: 5%
-
-- Business logic MUST have tests — no exceptions
-- Critical flows require integration coverage
-- Never disable or remove tests to make a build pass
-- Avoid untested edge cases
-
-No skill, command, or wrapper may downgrade or bypass these requirements.
-
----
-
-### 3. Type Safety & Boundaries
-Reference: `.github/instructions/rules/core.mdc`
-
-- Strong typing internally
-- Runtime validation at all system boundaries
-- Explicit error modeling
-- Deterministic control flow
-
----
-
-### 4. Database Integrity
-Reference: `.github/instructions/rules/database.mdc`
-
-- Use ORM/ODM patterns
-- Avoid raw queries unless justified
-- Enforce constraints at DB level
-- Prevent N+1 queries
-- Migrations must be reversible
-
----
-
-### 5. Frontend Standards
-Reference: `.github/instructions/rules/frontend.mdc`
-
-- WCAG 2.1 AA compliance
-- Responsive by default
-- Clear loading and error states
-- No unsafe client-side trust
-- Progressive enhancement preferred
-
----
-
-### 6. Code Style & Consistency
-Reference: `.github/instructions/rules/style.mdc`
-
-- Consistent naming
-- Small composable modules
-- Clear separation of concerns
-- Avoid magic values
-- Explicit contracts
-
----
-
-### 7. System Workflow Discipline
-Reference: `.github/instructions/rules/system-workflow.mdc`
-Reference: `.github/instructions/rules/workflows.mdc`
-
-- Feature branches only
-- No direct main edits
-- Deterministic PR structure
-- Enforced review gates
-
----
-
-### 8. Hardening Mode
-Reference: `.github/instructions/rules/hardening.mdc`
-
-When in hardening or audit mode:
-- Assume hostile input
-- Perform threat modeling
-- Validate configuration safety
-- Enforce strict rate limiting
-- Audit dependencies
-
----
-
-### 9. Intent Routing
-Reference: `.github/instructions/rules/intent-routing.mdc`
-
-Route tasks deterministically:
-
-- UI / Design → Frontend rules
-- API / Logic → Security + Core rules
-- Database → Database rules
-- Testing → Testing rules
-- Refactor / Cleanup → Style rules
-- Audit / Production Readiness → Hardening rules
-
-No ambiguous routing. Every task maps to exactly one primary rule module.
-
----
-
-# Skills System
-
-Skills extend behavior modularly. They are loaded on demand — never pre-loaded globally.
-
-Located at: `.github/skills/`
-
-Rules:
-- Skills MUST NOT override security, testing, or core constraints.
-- Skills augment capability, not policy.
-- This file (`instructions/source/core.md`) remains authoritative over all skills.
-- Skill activation is triggered by user intent (see Reference Index above).
-
----
-
-# Deterministic Command Mode
-
-If slash-command mode is enabled:
-
-- Unknown commands → return structured error
-- No conversational fallback
-- Destructive commands require explicit confirmation token:
-  `CONFIRM-DESTRUCTIVE:<target>`
-
-Command contracts (if applicable) must be modular and strict.
-
----
-
-# Critical Non-Negotiables
-
-- Never expose secrets
-- Never trust client input
-- Never bypass validation
-- Never skip testing on business logic
-- Never reduce security for convenience
-- Never duplicate canonical policy outside this file
-- Never let a skill or wrapper override security or testing rules
-
----
-
-# Canonical Contract
-
-This file (`instructions/source/core.md`) is:
-
-- The single source of truth for all global policy
-- The only file allowed to define routing logic, rule governance, and skill governance
-- The authority over all wrappers, rule modules, and skill modules
-
-All other instruction entrypoints MUST reference this file and remain minimal pointer-only files.
-No other file may claim authority over this file.