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.
- package/README.md +39 -9
- package/package.json +1 -1
- package/templates/.github/copilot-instructions.md +11 -3
- package/templates/AGENTS.MD +579 -2
- package/templates/CLAUDE.md +13 -4
- package/templates/GEMINI.md +15 -6
- package/templates/README.md +12 -4
- package/templates/agent-docs/ARCHITECTURE.md +1 -1
- package/templates/agent-docs/README.md +2 -2
- package/templates/agents/commands/README.md +24 -0
- package/templates/agents/commands/SCHEMA.md +22 -0
- package/templates/agents/commands/audit.md +38 -0
- package/templates/agents/commands/docs.md +34 -0
- package/templates/agents/commands/fix.md +34 -0
- package/templates/agents/commands/perf.md +34 -0
- package/templates/agents/commands/plan.md +34 -0
- package/templates/agents/commands/pr.md +35 -0
- package/templates/agents/commands/refactor.md +34 -0
- package/templates/agents/commands/release.md +39 -0
- package/templates/agents/commands/scaffold.md +34 -0
- package/templates/agents/commands/task.md +35 -0
- package/templates/agents/commands/test.md +34 -0
- package/templates/agents/rules/hardening.mdc +52 -0
- package/templates/agents/rules/intent-routing.mdc +45 -0
- package/templates/agents/rules/security.mdc +9 -1
- package/templates/agents/rules/system-workflow.mdc +63 -0
- package/templates/agents/rules/testing.mdc +14 -1
- package/templates/agents/rules/workflows.mdc +7 -0
- package/templates/agents/skills/README.md +13 -1
- package/templates/agents/skills/app-hardening/SKILL.md +45 -0
- package/templates/agents/skills/bug-triage/SKILL.md +36 -0
- 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
|
|
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.
|
|
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
|
-
│ │
|
|
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.
|
|
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.
|
|
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.
|
|
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 `
|
|
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
|
-
- `
|
|
52
|
+
- `AGENTS.MD` - Primary AI assistant guide
|
|
45
53
|
- `agent-docs/ARCHITECTURE.md` - Architecture and technology stack guidance
|
|
46
|
-
- `
|
|
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)
|