agents-templated 2.2.7 → 2.2.9

package/README.md

@@ -37,6 +37,7 @@ Agents Templated scaffolds your project with:
   - `.github/skills/bug-triage/`
   - `.github/skills/error-patterns/`
   - `.github/skills/app-hardening/`
+  - `.github/skills/shadcn-ui/`
 - Release and audit contracts now require hardening evidence when risk profile requires it
 
 ---
@@ -145,7 +146,6 @@ your-project/
 │   └── README.md                   # Human-readable setup guide
 │
 ├── .github/
-│   ├── instructions/                # Compatibility pointer directory
 │   ├── skills/
 │   │   ├── find-skills/           # Skill discovery helper
 │   │   ├── feature-delivery/      # Scoped feature delivery workflow
@@ -153,6 +153,7 @@ your-project/
 │   │   ├── error-patterns/         # Persistent error-debugging memory workflow
 │   │   ├── app-hardening/         # Hardening and release-evidence workflow
 │   │   ├── ui-ux-pro-max/         # Advanced UI/UX design implementation skill
+│   │   ├── shadcn-ui/             # shadcn/ui setup and component patterns
 │   │   ├── README.md              # Guide for creating custom skills
 │   │   └── [your-custom-skills]/  # Your project-specific skills
 │   └── copilot-instructions.md    # Compatibility shim for Copilot

package/bin/cli.js

@@ -186,7 +186,6 @@ program
       // 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 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)'));
@@ -358,7 +357,6 @@ program
       // 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 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)'));
@@ -383,10 +381,10 @@ program
       console.log(chalk.white('   1. Review CLAUDE.md (canonical AI policy — edit this directly)'));
       console.log(chalk.white('   2. Review agent-docs/ARCHITECTURE.md for project guidelines'));
       console.log(chalk.white('   3. AGENTS.MD and .github/copilot-instructions.md are thin pointers to CLAUDE.md'));
-      console.log(chalk.white('   4. Customize agents/rules/*.md for your tech stack'));
+      console.log(chalk.white('   4. Customize .claude/rules/*.md for your tech stack'));
       
       console.log(chalk.cyan('\n🔒 Security Reminder:\n'));
-      console.log(chalk.white('   • Review agents/rules/security.md'));
+      console.log(chalk.white('   • Review .claude/rules/security.md'));
       console.log(chalk.white('   • Validate all inputs with schema validation'));
       console.log(chalk.white('   • Implement rate limiting on public endpoints'));
       console.log(chalk.white('   • Never expose sensitive data in errors\n'));
@@ -666,6 +664,16 @@ async function cleanupLegacyInstructionFiles(targetDir) {
       console.log(chalk.green(`  ✓ Removed legacy file: ${file}`));
     }
   }
+
+  // Remove deprecated directory if it is now empty.
+  const legacyInstructionsDir = path.join(targetDir, '.github', 'instructions');
+  if (await fs.pathExists(legacyInstructionsDir)) {
+    const entries = await fs.readdir(legacyInstructionsDir);
+    if (entries.length === 0) {
+      await fs.remove(legacyInstructionsDir);
+      console.log(chalk.green('  ✓ Removed legacy directory: .github/instructions/'));
+    }
+  }
 }
 
 async function updateSelectedComponents(targetDir, templateDir, selectedComponents, overwrite = true) {
@@ -705,7 +713,6 @@ async function updateSelectedComponents(targetDir, templateDir, selectedComponen
 
   if (components.includes('github')) {
     console.log(chalk.yellow('Updating AI agent instructions...'));
-    await fs.ensureDir(path.join(targetDir, '.github', 'instructions'));
     await writeGeneratedInstructions(targetDir, templateDir, overwrite);
     await cleanupLegacyInstructionFiles(targetDir);
   }
@@ -836,7 +843,8 @@ program
         { targetFile: `${LAYOUT.canonical.skillsDir}/README.md`, templateFile: 'agents/skills/README.md', component: 'skills' },
         { targetFile: `${LAYOUT.canonical.skillsDir}/find-skills/SKILL.md`, templateFile: 'agents/skills/find-skills/SKILL.md', component: 'skills' },
         { targetFile: `${LAYOUT.canonical.skillsDir}/error-patterns/SKILL.md`, templateFile: 'agents/skills/error-patterns/SKILL.md', component: 'skills' },
-        { targetFile: `${LAYOUT.canonical.skillsDir}/ui-ux-pro-max/SKILL.md`, templateFile: 'agents/skills/ui-ux-pro-max/SKILL.md', component: 'skills' }
+        { targetFile: `${LAYOUT.canonical.skillsDir}/ui-ux-pro-max/SKILL.md`, templateFile: 'agents/skills/ui-ux-pro-max/SKILL.md', component: 'skills' },
+        { targetFile: `${LAYOUT.canonical.skillsDir}/shadcn-ui/SKILL.md`, templateFile: 'agents/skills/shadcn-ui/SKILL.md', component: 'skills' }
       ];
 
       for (const {targetFile, templateFile, component} of checkFiles) {
@@ -991,7 +999,7 @@ program
       console.log(chalk.blue('\n📚 Quick Tips:\n'));
       console.log(chalk.white('  • Run "agents-templated validate" to check setup'));
       console.log(chalk.white('  • Run "agents-templated wizard" for guided setup'));
-      console.log(chalk.white('  • Review agents/rules/security.md for security patterns\n'));
+      console.log(chalk.white('  • Review .claude/rules/security.md for security patterns\n'));
 
     } catch (error) {
       console.error(chalk.red('Error:'), error.message);
@@ -1001,7 +1009,7 @@ program
 
 program
   .command('new-skill <name>')
-  .description('Scaffold a new skill in agents/skills/<name>/SKILL.md')
+  .description('Scaffold a new skill in .github/skills/<name>/SKILL.md')
   .action(async (name) => {
     try {
       const targetDir = process.cwd();
@@ -1017,7 +1025,7 @@ program
 
 program
   .command('new-rule <name>')
-  .description('Scaffold a new rule in agents/rules/<name>.md')
+  .description('Scaffold a new rule in .claude/rules/<name>.md')
   .action(async (name) => {
     try {
       const targetDir = process.cwd();

package/index.js

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

package/lib/instructions.js

@@ -96,11 +96,11 @@ async function validateInstructionDrift(targetDir) {
 }
 
 async function scaffoldSkill(targetDir, skillName) {
-  const skillDir = path.join(targetDir, 'agents', 'skills', skillName);
+  const skillDir = path.join(targetDir, '.github', 'skills', skillName);
   const skillFile = path.join(skillDir, 'SKILL.md');
 
   if (await fs.pathExists(skillFile)) {
-    throw new Error(`Skill already exists: agents/skills/${skillName}/SKILL.md`);
+    throw new Error(`Skill already exists: .github/skills/${skillName}/SKILL.md`);
   }
 
   const title = skillName.split('-').map(w => w[0].toUpperCase() + w.slice(1)).join(' ');
@@ -132,15 +132,15 @@ async function scaffoldSkill(targetDir, skillName) {
 
   await fs.ensureDir(skillDir);
   await fs.writeFile(skillFile, content, 'utf8');
-  return `agents/skills/${skillName}/SKILL.md`;
+  return `.github/skills/${skillName}/SKILL.md`;
 }
 
 async function scaffoldRule(targetDir, ruleName) {
-  const rulesDir = path.join(targetDir, 'agents', 'rules');
+  const rulesDir = path.join(targetDir, '.claude', 'rules');
   const ruleFile = path.join(rulesDir, `${ruleName}.md`);
 
   if (await fs.pathExists(ruleFile)) {
-    throw new Error(`Rule already exists: agents/rules/${ruleName}.md`);
+    throw new Error(`Rule already exists: .claude/rules/${ruleName}.md`);
   }
 
   const content = [
@@ -168,7 +168,7 @@ async function scaffoldRule(targetDir, ruleName) {
 
   await fs.ensureDir(rulesDir);
   await fs.writeFile(ruleFile, content, 'utf8');
-  return `agents/rules/${ruleName}.md`;
+  return `.claude/rules/${ruleName}.md`;
 }
 
 async function scaffoldSubagent(targetDir, name) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-templated",
-  "version": "2.2.7",
+  "version": "2.2.9",
   "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/.claude/rules/planning.md

@@ -32,7 +32,7 @@ Each plan file must contain:
 
 ```
 ---
-mode: agent
+agent: agent
 description: One-line summary of what this plan covers.
 ---
 

package/templates/README.md

@@ -124,11 +124,11 @@ your-project/
 │   └── README.md                   # Human-readable setup guide
 │
 ├── .github/
-│   ├── instructions/                # Compatibility pointer directory
 │   ├── skills/
 │   │   ├── find-skills/           # Skill discovery helper
 │   │   ├── error-patterns/         # Persistent error-debugging memory workflow
 │   │   ├── ui-ux-pro-max/         # Advanced UI/UX design implementation skill
+│   │   ├── shadcn-ui/             # shadcn/ui setup and component patterns
 │   │   ├── README.md              # Guide for creating custom skills
 │   │   └── [your-custom-skills]/  # Your project-specific skills
 │   └── copilot-instructions.md    # Compatibility shim for Copilot

package/templates/agents/skills/README.md

@@ -100,6 +100,7 @@ Consider creating skills for:
 - `bug-triage`: Use for defects and regressions requiring reproducible evidence, root-cause isolation, and minimal safe patches.
 - `error-patterns`: Use when errors repeat to apply known fixes from lessons-learned and automatically record new resolutions.
 - `app-hardening`: Use for high-risk/distributed runtimes to enforce hardening profile, obfuscation decisions, and release evidence.
+- `shadcn-ui`: Use for shadcn/ui installation, component composition, form patterns, and theme customization.
 
 ## Using Skills in Your Project