agents-templated 1.2.7 → 1.2.9

package/README.md

@@ -14,13 +14,29 @@
 Agents Templated scaffolds your project with:
 
 ✅ **AI Agent Configurations** – Auto-discovery files for 4 major AI coding assistants  
+✅ **Deterministic Command Contracts** – Structured slash-command protocol in `agents/commands/`  
 ✅ **Security-First Patterns** – OWASP Top 10 protection guidelines built-in  
+✅ **Hardening Guidance** – Risk-based hardening/obfuscation and release evidence gates  
 ✅ **Testing Strategy** – 80/15/5 coverage targets (unit/integration/e2e)  
 ✅ **Agent-Based Architecture** – Specialized patterns for frontend, backend, database, testing, security  
 ✅ **Technology-Agnostic** – Works with React, Django, Go, FastAPI, Next.js, or any stack you choose
 
 **Important:** This package does **NOT** install frameworks or libraries. It scaffolds the structure, patterns, and AI configurations—you install your chosen tech stack separately.
 
+### What’s New in This Version
+
+- 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`
+- New baseline skills:
+  - `agents/skills/feature-delivery/`
+  - `agents/skills/bug-triage/`
+  - `agents/skills/app-hardening/`
+- Release and audit contracts now require hardening evidence when risk profile requires it
+
 ---
 
 ## 🚀 Quick Start
@@ -54,10 +70,6 @@ npx agents-templated@latest init --all
 
 After initializing, install your chosen framework:
 
-### 2. Install Your Tech Stack
-
-After initializing, install your chosen framework:
-
 ```bash
 # Frontend
 npm install next react react-dom              # Next.js
@@ -89,7 +101,10 @@ Your AI assistant will auto-load the configurations and follow enterprise patter
 | 🚀 **Quick Start Presets** | 5 popular tech stack presets (Next.js, Express, Django, FastAPI, Go) |
 | 🧙 **Interactive Wizard** | Guided setup with personalized recommendations |
 | 🤖 **4 AI Agents Supported** | Cursor, GitHub Copilot, Claude, Google Gemini (auto-discovery) |
+| 🧭 **Deterministic Commands** | Slash-command contracts with strict structured outputs |
+| 💬 **Auto Intent Routing** | Non-slash prompts can map to command contracts (`slash-command-auto`) |
 | 🔒 **Security-First** | OWASP Top 10 protection patterns built-in |
+| 🛡️ **Hardening Workflow** | Risk-based hardening rules plus verification/release gates |
 | 🧪 **Testing Strategy** | 80/15/5 coverage targets (unit/integration/e2e) |
 | ✅ **Project Validation** | `validate` and `doctor` commands for health checks |
 | 🔄 **Template Updates** | Keep your templates in sync with `update` command |
@@ -109,7 +124,7 @@ Agents Templated automatically configures 4 major AI coding assistants:
 | **Claude** | `CLAUDE.md` | ✅ Auto-loads in Claude IDE/API |
 | **Gemini** | `GEMINI.md` | ✅ Auto-loads in Gemini IDE/API |
 
-**All agents follow the same rules:** `agents/rules/` directory contains unified patterns for security, testing, code style, and architecture. No duplication, one source of truth.
+**All agents follow the same standards:** `agents/rules/` contains behavior rules, and `agents/commands/` contains deterministic slash-command contracts.
 
 ---
 
@@ -120,7 +135,7 @@ When you run `agents-templated init`, you get:
 ```
 your-project/
 ├── agent-docs/                      # 📚 Comprehensive documentation
-│   ├── AGENTS.md                   # AI assistant guide
+│   ├── AGENTS.MD                   # AI assistant guide
 │   ├── ARCHITECTURE.md             # Project architecture & tech stack
 │   └── README.md                   # Human-readable setup guide
 │
@@ -131,9 +146,25 @@ your-project/
 │   │   ├── testing.mdc            # Testing strategy
 │   │   ├── frontend.mdc           # Frontend patterns
 │   │   ├── database.mdc           # Database patterns
-│   │   └── style.mdc              # Code style guidelines
+│   │   ├── style.mdc              # Code style guidelines
+│   │   ├── workflows.mdc          # Workflow and quality gates
+│   │   ├── intent-routing.mdc     # Intent-to-command routing policy
+│   │   ├── system-workflow.mdc    # End-to-end delivery lifecycle gates
+│   │   └── hardening.mdc          # Hardening and obfuscation guidance
+│   ├── commands/
+│   │   ├── SCHEMA.md              # Global slash-command response schema
+│   │   ├── plan.md                # /plan contract
+│   │   ├── fix.md                 # /fix contract
+│   │   ├── audit.md               # /audit contract
+│   │   ├── release.md             # /release contract
+│   │   ├── ...                    # Other command contracts
+│   │   └── README.md              # Commands directory guide
 │   └── skills/
 │       ├── find-skills/           # Skill discovery helper
+│       ├── feature-delivery/      # Scoped feature delivery workflow
+│       ├── bug-triage/            # Reproduction-first defect workflow
+│       ├── app-hardening/         # Hardening and release-evidence workflow
+│       ├── ui-ux-pro-max/         # Advanced UI/UX design implementation skill
 │       ├── README.md              # Guide for creating custom skills
 │       └── [your-custom-skills]/  # Your project-specific skills
 │
@@ -260,7 +291,7 @@ Skills define *how to execute specific tasks*, complementing rules that define *
 
 ### 4. Read the Documentation
 
-- **[AGENTS.md](AGENTS.md)** – AI assistant guide
+- **[AGENTS.MD](AGENTS.MD)** – AI assistant guide
 - **[agent-docs/ARCHITECTURE.md](agent-docs/ARCHITECTURE.md)** – Project architecture & tech stack guidance
 - **[agents/skills/README.md](agents/skills/README.md)** – Custom skills guide
 - **[agents/rules/security.mdc](agents/rules/security.mdc)** – Security patterns (CRITICAL)
@@ -310,7 +341,7 @@ Your AI will follow the enterprise patterns automatically!
 | **TestAgent** | Unit, integration, E2E, accessibility testing |
 | **SecurityAgent** | Input validation, authentication, OWASP compliance |
 
-**Reference**: [AGENTS.md](AGENTS.md)
+**Reference**: [AGENTS.MD](AGENTS.MD)
 
 ---
 

package/bin/cli.js

@@ -428,7 +428,7 @@ program
     console.log(chalk.blue.bold('\nAvailable Components:\n'));
     console.log(chalk.yellow('docs') + '    - Documentation files (agent-docs/ directory)');
     console.log(chalk.yellow('rules') + '   - Agent rules (core, database, frontend, security, testing, style)');
-    console.log(chalk.yellow('skills') + '  - Agent skills (find-skills, web-design-guidelines)');
+    console.log(chalk.yellow('skills') + '  - Agent skills (find-skills, ui-ux-pro-max)');
     console.log(chalk.yellow('github') + '  - AI Agent instructions (Cursor, Copilot, VSCode, Gemini)');
     console.log(chalk.yellow('all') + '     - All components');
     
@@ -657,7 +657,7 @@ program
       console.log(chalk.blue.bold('\n🔄 Checking for template updates...\n'));
 
       // Check if templates are installed
-      const hasTemplates = await fs.pathExists(path.join(targetDir, 'AGENTS.MD')) ||
+      const hasTemplates = await fs.pathExists(path.join(targetDir, 'AGENTS.md')) ||
                          await fs.pathExists(path.join(targetDir, 'agents'));
 
       if (!hasTemplates) {
@@ -728,10 +728,12 @@ program
       const checkFiles = [
         { file: 'AGENTS.md', component: 'root' },
         { file: 'agent-docs/ARCHITECTURE.md', component: 'docs' },
-        { file: 'AGENTS.md', component: 'root' },
         { file: 'agents/rules/security.mdc', component: 'rules' },
         { file: 'agents/rules/testing.mdc', component: 'rules' },
         { file: 'agents/rules/core.mdc', component: 'rules' },
+        { file: 'agents/skills/README.md', component: 'skills' },
+        { file: 'agents/skills/find-skills/SKILL.md', component: 'skills' },
+        { file: 'agents/skills/ui-ux-pro-max/SKILL.md', component: 'skills' },
         { file: '.github/copilot-instructions.md', component: 'github' }
       ];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-templated",
-  "version": "1.2.7",
+  "version": "1.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/.github/copilot-instructions.md

@@ -22,13 +22,21 @@ This project follows enterprise-grade, technology-agnostic development patterns.
 
 ## Agent Delegation
 
-When implementing features, follow agent patterns from `agent-docs/AGENTS.md`:
+When implementing features, follow agent patterns from `AGENTS.MD`:
 - **UI/Design** → FrontendAgent patterns (`agents/rules/frontend.mdc`)
 - **API/Logic** → BackendAgent patterns (`agents/rules/security.mdc`)
 - **Database** → DatabaseAgent patterns (`agents/rules/database.mdc`)
 - **Testing** → TestAgent patterns (`agents/rules/testing.mdc`)
 - **Security** → SecurityAgent patterns (`agents/rules/security.mdc`)
 
+## 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>`.
+
 ## Critical Rules
 
 - Validate ALL user inputs with schema validation
@@ -41,9 +49,9 @@ When implementing features, follow agent patterns from `agent-docs/AGENTS.md`:
 
 ## Reference Files
 
-- `agent-docs/AI_INSTRUCTIONS.md` - Primary AI assistant guide
+- `AGENTS.MD` - Primary AI assistant guide
 - `agent-docs/ARCHITECTURE.md` - Architecture and technology stack guidance
-- `agent-docs/AGENTS.md` - Agent responsibilities and delegation
+- `agents/commands/` - Deterministic slash command contracts
 - `agents/rules/core.mdc` - Core principles
 - `agents/rules/security.mdc` - Security patterns (CRITICAL)
 - `agents/rules/testing.mdc` - Testing strategy (CRITICAL)