agents-templated 1.2.8 → 1.2.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/README.md +39 -9
  2. package/package.json +1 -1
  3. package/templates/.github/copilot-instructions.md +11 -3
  4. package/templates/AGENTS.MD +579 -2
  5. package/templates/CLAUDE.md +13 -4
  6. package/templates/GEMINI.md +15 -6
  7. package/templates/README.md +12 -4
  8. package/templates/agent-docs/ARCHITECTURE.md +1 -1
  9. package/templates/agent-docs/README.md +2 -2
  10. package/templates/agents/commands/README.md +24 -0
  11. package/templates/agents/commands/SCHEMA.md +22 -0
  12. package/templates/agents/commands/audit.md +38 -0
  13. package/templates/agents/commands/docs.md +34 -0
  14. package/templates/agents/commands/fix.md +34 -0
  15. package/templates/agents/commands/perf.md +34 -0
  16. package/templates/agents/commands/plan.md +34 -0
  17. package/templates/agents/commands/pr.md +35 -0
  18. package/templates/agents/commands/refactor.md +34 -0
  19. package/templates/agents/commands/release.md +39 -0
  20. package/templates/agents/commands/scaffold.md +34 -0
  21. package/templates/agents/commands/task.md +35 -0
  22. package/templates/agents/commands/test.md +34 -0
  23. package/templates/agents/rules/hardening.mdc +52 -0
  24. package/templates/agents/rules/intent-routing.mdc +45 -0
  25. package/templates/agents/rules/security.mdc +9 -1
  26. package/templates/agents/rules/system-workflow.mdc +63 -0
  27. package/templates/agents/rules/testing.mdc +14 -1
  28. package/templates/agents/rules/workflows.mdc +7 -0
  29. package/templates/agents/skills/README.md +13 -1
  30. package/templates/agents/skills/app-hardening/SKILL.md +45 -0
  31. package/templates/agents/skills/bug-triage/SKILL.md +36 -0
  32. package/templates/agents/skills/feature-delivery/SKILL.md +38 -0
package/README.md CHANGED
@@ -14,13 +14,29 @@
14
14
  Agents Templated scaffolds your project with:
15
15
 
16
16
  ✅ **AI Agent Configurations** – Auto-discovery files for 4 major AI coding assistants
17
+ ✅ **Deterministic Command Contracts** – Structured slash-command protocol in `agents/commands/`
17
18
  ✅ **Security-First Patterns** – OWASP Top 10 protection guidelines built-in
19
+ ✅ **Hardening Guidance** – Risk-based hardening/obfuscation and release evidence gates
18
20
  ✅ **Testing Strategy** – 80/15/5 coverage targets (unit/integration/e2e)
19
21
  ✅ **Agent-Based Architecture** – Specialized patterns for frontend, backend, database, testing, security
20
22
  ✅ **Technology-Agnostic** – Works with React, Django, Go, FastAPI, Next.js, or any stack you choose
21
23
 
22
24
  **Important:** This package does **NOT** install frameworks or libraries. It scaffolds the structure, patterns, and AI configurations—you install your chosen tech stack separately.
23
25
 
26
+ ### What’s New in This Version
27
+
28
+ - Deterministic slash-command standard in `AGENTS.MD` and modular contracts in `agents/commands/`
29
+ - Implicit natural-language routing support (`slash-command-auto`) for non-technical prompts
30
+ - New workflow/routing/hardening rule set:
31
+ - `agents/rules/intent-routing.mdc`
32
+ - `agents/rules/system-workflow.mdc`
33
+ - `agents/rules/hardening.mdc`
34
+ - New baseline skills:
35
+ - `agents/skills/feature-delivery/`
36
+ - `agents/skills/bug-triage/`
37
+ - `agents/skills/app-hardening/`
38
+ - Release and audit contracts now require hardening evidence when risk profile requires it
39
+
24
40
  ---
25
41
 
26
42
  ## 🚀 Quick Start
@@ -54,10 +70,6 @@ npx agents-templated@latest init --all
54
70
 
55
71
  After initializing, install your chosen framework:
56
72
 
57
- ### 2. Install Your Tech Stack
58
-
59
- After initializing, install your chosen framework:
60
-
61
73
  ```bash
62
74
  # Frontend
63
75
  npm install next react react-dom # Next.js
@@ -89,7 +101,10 @@ Your AI assistant will auto-load the configurations and follow enterprise patter
89
101
  | 🚀 **Quick Start Presets** | 5 popular tech stack presets (Next.js, Express, Django, FastAPI, Go) |
90
102
  | 🧙 **Interactive Wizard** | Guided setup with personalized recommendations |
91
103
  | 🤖 **4 AI Agents Supported** | Cursor, GitHub Copilot, Claude, Google Gemini (auto-discovery) |
104
+ | 🧭 **Deterministic Commands** | Slash-command contracts with strict structured outputs |
105
+ | 💬 **Auto Intent Routing** | Non-slash prompts can map to command contracts (`slash-command-auto`) |
92
106
  | 🔒 **Security-First** | OWASP Top 10 protection patterns built-in |
107
+ | 🛡️ **Hardening Workflow** | Risk-based hardening rules plus verification/release gates |
93
108
  | 🧪 **Testing Strategy** | 80/15/5 coverage targets (unit/integration/e2e) |
94
109
  | ✅ **Project Validation** | `validate` and `doctor` commands for health checks |
95
110
  | 🔄 **Template Updates** | Keep your templates in sync with `update` command |
@@ -109,7 +124,7 @@ Agents Templated automatically configures 4 major AI coding assistants:
109
124
  | **Claude** | `CLAUDE.md` | ✅ Auto-loads in Claude IDE/API |
110
125
  | **Gemini** | `GEMINI.md` | ✅ Auto-loads in Gemini IDE/API |
111
126
 
112
- **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.
127
+ **All agents follow the same standards:** `agents/rules/` contains behavior rules, and `agents/commands/` contains deterministic slash-command contracts.
113
128
 
114
129
  ---
115
130
 
@@ -120,7 +135,7 @@ When you run `agents-templated init`, you get:
120
135
  ```
121
136
  your-project/
122
137
  ├── agent-docs/ # 📚 Comprehensive documentation
123
- │ ├── AGENTS.md # AI assistant guide
138
+ │ ├── AGENTS.MD # AI assistant guide
124
139
  │ ├── ARCHITECTURE.md # Project architecture & tech stack
125
140
  │ └── README.md # Human-readable setup guide
126
141
 
@@ -131,9 +146,24 @@ your-project/
131
146
  │ │ ├── testing.mdc # Testing strategy
132
147
  │ │ ├── frontend.mdc # Frontend patterns
133
148
  │ │ ├── database.mdc # Database patterns
134
- │ │ └── style.mdc # Code style guidelines
149
+ │ │ ├── style.mdc # Code style guidelines
150
+ │ │ ├── workflows.mdc # Workflow and quality gates
151
+ │ │ ├── intent-routing.mdc # Intent-to-command routing policy
152
+ │ │ ├── system-workflow.mdc # End-to-end delivery lifecycle gates
153
+ │ │ └── hardening.mdc # Hardening and obfuscation guidance
154
+ │ ├── commands/
155
+ │ │ ├── SCHEMA.md # Global slash-command response schema
156
+ │ │ ├── plan.md # /plan contract
157
+ │ │ ├── fix.md # /fix contract
158
+ │ │ ├── audit.md # /audit contract
159
+ │ │ ├── release.md # /release contract
160
+ │ │ ├── ... # Other command contracts
161
+ │ │ └── README.md # Commands directory guide
135
162
  │ └── skills/
136
163
  │ ├── find-skills/ # Skill discovery helper
164
+ │ ├── feature-delivery/ # Scoped feature delivery workflow
165
+ │ ├── bug-triage/ # Reproduction-first defect workflow
166
+ │ ├── app-hardening/ # Hardening and release-evidence workflow
137
167
  │ ├── ui-ux-pro-max/ # Advanced UI/UX design implementation skill
138
168
  │ ├── README.md # Guide for creating custom skills
139
169
  │ └── [your-custom-skills]/ # Your project-specific skills
@@ -261,7 +291,7 @@ Skills define *how to execute specific tasks*, complementing rules that define *
261
291
 
262
292
  ### 4. Read the Documentation
263
293
 
264
- - **[AGENTS.md](AGENTS.md)** – AI assistant guide
294
+ - **[AGENTS.MD](AGENTS.MD)** – AI assistant guide
265
295
  - **[agent-docs/ARCHITECTURE.md](agent-docs/ARCHITECTURE.md)** – Project architecture & tech stack guidance
266
296
  - **[agents/skills/README.md](agents/skills/README.md)** – Custom skills guide
267
297
  - **[agents/rules/security.mdc](agents/rules/security.mdc)** – Security patterns (CRITICAL)
@@ -311,7 +341,7 @@ Your AI will follow the enterprise patterns automatically!
311
341
  | **TestAgent** | Unit, integration, E2E, accessibility testing |
312
342
  | **SecurityAgent** | Input validation, authentication, OWASP compliance |
313
343
 
314
- **Reference**: [AGENTS.md](AGENTS.md)
344
+ **Reference**: [AGENTS.MD](AGENTS.MD)
315
345
 
316
346
  ---
317
347
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agents-templated",
3
- "version": "1.2.8",
3
+ "version": "1.2.9",
4
4
  "description": "Technology-agnostic development template with multi-AI agent support (Cursor, Copilot, VSCode, Gemini), security-first patterns, and comprehensive testing guidelines",
5
5
  "main": "index.js",
6
6
  "bin": {
@@ -22,13 +22,21 @@ This project follows enterprise-grade, technology-agnostic development patterns.
22
22
 
23
23
  ## Agent Delegation
24
24
 
25
- When implementing features, follow agent patterns from `agent-docs/AGENTS.md`:
25
+ When implementing features, follow agent patterns from `AGENTS.MD`:
26
26
  - **UI/Design** → FrontendAgent patterns (`agents/rules/frontend.mdc`)
27
27
  - **API/Logic** → BackendAgent patterns (`agents/rules/security.mdc`)
28
28
  - **Database** → DatabaseAgent patterns (`agents/rules/database.mdc`)
29
29
  - **Testing** → TestAgent patterns (`agents/rules/testing.mdc`)
30
30
  - **Security** → SecurityAgent patterns (`agents/rules/security.mdc`)
31
31
 
32
+ ## Deterministic Slash Commands
33
+
34
+ - Slash command protocol is defined in `AGENTS.MD` under `Deterministic Slash Command System Standard`.
35
+ - Modular command contracts are stored in `agents/commands/`.
36
+ - Command mode is strict: unknown or malformed slash commands must return structured error output and stop.
37
+ - No conversational fallback is allowed once slash-command mode is entered.
38
+ - Destructive actions require explicit confirmation token format: `CONFIRM-DESTRUCTIVE:<target>`.
39
+
32
40
  ## Critical Rules
33
41
 
34
42
  - Validate ALL user inputs with schema validation
@@ -41,9 +49,9 @@ When implementing features, follow agent patterns from `agent-docs/AGENTS.md`:
41
49
 
42
50
  ## Reference Files
43
51
 
44
- - `agent-docs/AI_INSTRUCTIONS.md` - Primary AI assistant guide
52
+ - `AGENTS.MD` - Primary AI assistant guide
45
53
  - `agent-docs/ARCHITECTURE.md` - Architecture and technology stack guidance
46
- - `agent-docs/AGENTS.md` - Agent responsibilities and delegation
54
+ - `agents/commands/` - Deterministic slash command contracts
47
55
  - `agents/rules/core.mdc` - Core principles
48
56
  - `agents/rules/security.mdc` - Security patterns (CRITICAL)
49
57
  - `agents/rules/testing.mdc` - Testing strategy (CRITICAL)