aiwg 2024.12.3 → 2024.12.4

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 (61) hide show
  1. package/CLAUDE.md +4 -1
  2. package/README.md +61 -17
  3. package/agentic/code/addons/aiwg-utils/README.md +21 -0
  4. package/agentic/code/addons/aiwg-utils/commands/aiwg-refresh.md +307 -0
  5. package/agentic/code/addons/aiwg-utils/manifest.json +1 -0
  6. package/agentic/code/addons/testing-quality/README.md +142 -0
  7. package/agentic/code/addons/testing-quality/manifest.json +37 -0
  8. package/agentic/code/addons/testing-quality/skills/flaky-detect/SKILL.md +287 -0
  9. package/agentic/code/addons/testing-quality/skills/flaky-fix/SKILL.md +313 -0
  10. package/agentic/code/addons/testing-quality/skills/generate-factory/SKILL.md +331 -0
  11. package/agentic/code/addons/testing-quality/skills/mutation-test/SKILL.md +299 -0
  12. package/agentic/code/addons/testing-quality/skills/tdd-enforce/SKILL.md +261 -0
  13. package/agentic/code/addons/testing-quality/skills/tdd-enforce/scripts/tdd_setup.py +433 -0
  14. package/agentic/code/addons/testing-quality/skills/test-sync/SKILL.md +312 -0
  15. package/agentic/code/frameworks/sdlc-complete/agents/README.md +13 -2
  16. package/agentic/code/frameworks/sdlc-complete/agents/mutation-analyst.md +231 -0
  17. package/agentic/code/frameworks/sdlc-complete/agents/software-implementer.md +115 -22
  18. package/agentic/code/frameworks/sdlc-complete/agents/test-architect.md +144 -22
  19. package/agentic/code/frameworks/sdlc-complete/agents/test-engineer.md +198 -387
  20. package/agentic/code/frameworks/sdlc-complete/commands/setup-tdd.md +254 -0
  21. package/agentic/code/frameworks/sdlc-complete/templates/codex/AGENTS.md.aiwg-template +93 -0
  22. package/agentic/code/frameworks/sdlc-complete/templates/codex/ci-cd/aiwg-codex-review.yml +87 -0
  23. package/agentic/code/frameworks/sdlc-complete/templates/codex/ci-cd/aiwg-codex-security.yml +164 -0
  24. package/agentic/code/frameworks/sdlc-complete/templates/codex/ci-cd/aiwg-codex-tests.yml +126 -0
  25. package/agentic/code/frameworks/sdlc-complete/templates/codex/config.toml.aiwg-template +121 -0
  26. package/agentic/code/frameworks/sdlc-complete/templates/copilot/copilot-instructions.md.aiwg-template +71 -0
  27. package/agentic/code/frameworks/sdlc-complete/templates/cursor/AGENTS.md.aiwg-template +114 -0
  28. package/agentic/code/frameworks/sdlc-complete/templates/cursor/ci-cd/aiwg-cursor-review.yml +70 -0
  29. package/agentic/code/frameworks/sdlc-complete/templates/cursor/ci-cd/aiwg-cursor-security.yml +101 -0
  30. package/agentic/code/frameworks/sdlc-complete/templates/cursor/ci-cd/aiwg-cursor-tests.yml +140 -0
  31. package/agentic/code/frameworks/sdlc-complete/templates/cursor/cli.json.aiwg-template +27 -0
  32. package/agentic/code/frameworks/sdlc-complete/templates/cursor/worktrees.json.aiwg-template +15 -0
  33. package/agentic/code/frameworks/sdlc-complete/templates/intake/project-intake-template.md +47 -0
  34. package/agentic/code/frameworks/sdlc-complete/templates/opencode/AGENTS.md.aiwg-template +73 -0
  35. package/agentic/code/frameworks/sdlc-complete/templates/opencode/ci-cd/opencode-aiwg.yml +73 -0
  36. package/agentic/code/frameworks/sdlc-complete/templates/opencode/instructions.md.aiwg-template +83 -0
  37. package/agentic/code/frameworks/sdlc-complete/templates/opencode/opencode.json.aiwg-template +24 -0
  38. package/agentic/code/frameworks/sdlc-complete/templates/opencode/plugin/aiwg-hooks.ts.aiwg-template +121 -0
  39. package/agentic/code/frameworks/sdlc-complete/templates/opencode/themes/aiwg.json.aiwg-template +221 -0
  40. package/agentic/code/frameworks/sdlc-complete/templates/opencode/tool/aiwg-workflow.ts.aiwg-template +176 -0
  41. package/agentic/code/frameworks/sdlc-complete/test/unit/security/security-validator.test.ts +2 -1
  42. package/docs/commands/development-commands-examples.md +724 -0
  43. package/docs/contributing/testing-requirements.md +142 -0
  44. package/docs/development/file-placement-guide.md +168 -0
  45. package/docs/development/subagents-guide.md +515 -0
  46. package/docs/examples/codex-sdk-examples.ts +321 -0
  47. package/docs/index.md +4 -8
  48. package/docs/integrations/codex-quickstart.md +229 -0
  49. package/docs/integrations/copilot-quickstart.md +232 -0
  50. package/docs/integrations/cross-platform-config.md +18 -0
  51. package/docs/integrations/cursor-quickstart.md +253 -0
  52. package/docs/integrations/opencode-quickstart.md +303 -0
  53. package/package.json +1 -1
  54. package/src/cli/index.mjs +3 -10
  55. package/src/mcp/cli.mjs +152 -4
  56. package/tools/agents/deploy-agents.mjs +767 -20
  57. package/tools/commands/deploy-prompts-codex.mjs +302 -0
  58. package/tools/install/install.sh +4 -0
  59. package/tools/rules/deploy-rules-cursor.mjs +332 -0
  60. package/tools/skills/deploy-skills-codex.mjs +319 -0
  61. package/tools/cli/demo.mjs +0 -204
package/CLAUDE.md CHANGED
@@ -56,9 +56,12 @@ Use `@path/to/file.md` in your message to load specific documentation:
56
56
  | Platform | Agent Location | Command |
57
57
  |----------|----------------|---------|
58
58
  | Claude Code | `.claude/agents/` | `aiwg -deploy-agents` |
59
+ | GitHub Copilot | `.github/agents/` | `aiwg -deploy-agents --provider copilot` |
59
60
  | Warp Terminal | `WARP.md` | Symlinked to CLAUDE.md |
60
61
  | Factory AI | `.factory/droids/` | `aiwg -deploy-agents --provider factory` |
61
- | OpenAI/Codex | `.codex/agents/` | `aiwg -deploy-agents --provider openai` |
62
+ | OpenCode | `.opencode/agent/` | `aiwg -deploy-agents --provider opencode` |
63
+ | Cursor | `.cursor/rules/` | `aiwg -deploy-agents --provider cursor` |
64
+ | OpenAI/Codex | `~/.codex/skills/` | `aiwg -deploy-agents --provider codex` |
62
65
 
63
66
  ## Writing Principles
64
67
 
package/README.md CHANGED
@@ -6,18 +6,18 @@ Modular toolkit for AI-powered SDLC, marketing, and content workflows.
6
6
 
7
7
  ```bash
8
8
  npm i -g aiwg # install globally
9
- aiwg demo # try it in < 2 minutes
9
+ aiwg use sdlc # deploy SDLC framework
10
10
  ```
11
11
 
12
- [![npm version](https://img.shields.io/npm/v/aiwg/latest?label=npm&color=CB3837&logo=npm)](https://www.npmjs.com/package/aiwg)
13
- [![npm downloads](https://img.shields.io/npm/dm/aiwg?color=CB3837&logo=npm)](https://www.npmjs.com/package/aiwg)
14
- [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
15
- [![GitHub Stars](https://img.shields.io/github/stars/jmagly/ai-writing-guide?style=social)](https://github.com/jmagly/ai-writing-guide/stargazers)
12
+ [![npm version](https://img.shields.io/npm/v/aiwg/latest?label=npm&color=CB3837&logo=npm&style=flat-square)](https://www.npmjs.com/package/aiwg)
13
+ [![npm downloads](https://img.shields.io/npm/dm/aiwg?color=CB3837&logo=npm&style=flat-square)](https://www.npmjs.com/package/aiwg)
14
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)
15
+ [![GitHub Stars](https://img.shields.io/github/stars/jmagly/ai-writing-guide?style=flat-square)](https://github.com/jmagly/ai-writing-guide/stargazers)
16
16
 
17
17
  [**Get Started**](#-quick-start) · [**Documentation**](#-documentation) · [**Examples**](examples/) · [**Contributing**](#-contributing) · [**Community**](#-community--support)
18
18
 
19
- [![Discord](https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&logoColor=white)](https://discord.gg/BuAusFMxdA)
20
- [![Telegram](https://img.shields.io/badge/Telegram-Join-26A5E4?logo=telegram&logoColor=white)](https://t.me/+oJg9w2lE6A5lOGFh)
19
+ [![Discord](https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&logoColor=white&style=flat-square)](https://discord.gg/BuAusFMxdA)
20
+ [![Telegram](https://img.shields.io/badge/Telegram-Join-26A5E4?logo=telegram&logoColor=white&style=flat-square)](https://t.me/+oJg9w2lE6A5lOGFh)
21
21
 
22
22
  🌐 **Live demo & docs:** [https://jmagly.github.io/ai-writing-guide](https://jmagly.github.io/ai-writing-guide)
23
23
 
@@ -27,18 +27,18 @@ aiwg demo # try it in < 2 minutes
27
27
 
28
28
  ## 🚀 Quick Start
29
29
 
30
- > **Prerequisites:** Node.js ≥18.0.0 and an AI platform (Claude Code, Warp Terminal, or Factory AI)
30
+ > **Prerequisites:** Node.js ≥18.0.0 and an AI platform (Claude Code, GitHub Copilot, Warp Terminal, or others)
31
31
 
32
32
  ```bash
33
33
  # Install
34
34
  npm install -g aiwg
35
35
 
36
- # Try the demo (creates ~/aiwg-demo with everything set up)
37
- aiwg demo
38
-
39
- # Or activate on your existing project
36
+ # Activate on your project
40
37
  cd your-project
41
38
  aiwg use sdlc
39
+
40
+ # Or scaffold a new project with everything set up
41
+ aiwg -new my-project
42
42
  ```
43
43
 
44
44
  <details>
@@ -82,6 +82,15 @@ aiwg use sdlc --provider warp
82
82
  # Factory AI (creates .factory/droids/ + AGENTS.md)
83
83
  aiwg use sdlc --provider factory
84
84
 
85
+ # OpenCode (creates .opencode/agent/ + AGENTS.md)
86
+ aiwg use sdlc --provider opencode
87
+
88
+ # Cursor (creates .cursor/rules/ + AGENTS.md)
89
+ aiwg use sdlc --provider cursor
90
+
91
+ # GitHub Copilot (creates .github/agents/*.yaml + copilot-instructions.md)
92
+ aiwg use sdlc --provider copilot
93
+
85
94
  # OpenAI/Codex (experimental)
86
95
  aiwg use sdlc --provider openai
87
96
  ```
@@ -188,6 +197,31 @@ cd my-awesome-project
188
197
  </tr>
189
198
  </table>
190
199
 
200
+ ### 🧪 **Testing Quality Addon**
201
+
202
+ **Enforce TDD. Validate quality.** Research-backed testing enforcement, quality metrics, and automation.
203
+
204
+ <table>
205
+ <tr>
206
+ <td width="50%">
207
+
208
+ - ✅ **TDD Enforcement** — Pre-commit hooks + CI coverage gates (80%+ target)
209
+ - ✅ **Mutation Testing** — Validate tests beyond coverage (Stryker/PITest/mutmut)
210
+ - ✅ **Flaky Test Detection** — Identify unreliable tests from CI history
211
+
212
+ </td>
213
+ <td width="50%">
214
+
215
+ - ✅ **Flaky Test Fixes** — Pattern-based auto-repair (timing, async, state)
216
+ - ✅ **Test Data Factories** — Auto-generate factories from schemas (Faker.js)
217
+ - ✅ **Test Sync** — Detect orphaned tests, missing tests, code misalignment
218
+
219
+ </td>
220
+ </tr>
221
+ </table>
222
+
223
+ **Research Foundation:** Kent Beck (TDD), Google Testing Blog (80% coverage), FlaKat (flaky detection), UTRefactor (test maintenance)
224
+
191
225
  ---
192
226
 
193
227
  ## 🎬 See It In Action
@@ -287,9 +321,13 @@ aiwg/
287
321
  │ │ ├── examples/ → Before/after rewrites
288
322
  │ │ └── context/ → Quick-reference for different voices
289
323
  │ │
290
- └── voice-framework/ → Voice profiles for consistent, natural writing
291
- ├── skills/ (4) → voice-apply, voice-create, voice-blend, voice-analyze
292
- └── voices/templates/ → Built-in profiles (technical, friendly, executive, casual)
324
+ ├── voice-framework/ → Voice profiles for consistent, natural writing
325
+ ├── skills/ (4) → voice-apply, voice-create, voice-blend, voice-analyze
326
+ └── voices/templates/ → Built-in profiles (technical, friendly, executive, casual)
327
+ │ │
328
+ │ └── testing-quality/ → Research-backed testing enforcement
329
+ │ ├── skills/ (6) → tdd-enforce, mutation-test, flaky-detect, flaky-fix, generate-factory, test-sync
330
+ │ └── scripts/ → TDD setup automation
293
331
 
294
332
  ├── 🗂️ Workspace Management
295
333
  │ ├── Framework isolation → Run SDLC + MMK + addons simultaneously
@@ -908,12 +946,16 @@ Get the best of all platforms:
908
946
  - **Claude Code:** Multi-agent orchestration, artifact generation
909
947
  - **Warp Terminal:** Command-line workflows, terminal-native AI
910
948
  - **Factory AI:** Custom droid workflows, native Factory format
949
+ - **Cursor:** IDE-native rules, native AGENTS.md support
950
+ - **Codex:** OpenAI's code assistant, prompts format
911
951
 
912
952
  ```bash
913
953
  # Deploy to all platforms
914
954
  aiwg use sdlc # Claude Code (default)
915
955
  aiwg use sdlc --provider warp # Warp Terminal
916
956
  aiwg use sdlc --provider factory # Factory AI
957
+ aiwg use sdlc --provider cursor # Cursor IDE
958
+ aiwg use sdlc --provider openai # OpenAI Codex
917
959
  ```
918
960
 
919
961
  ---
@@ -925,8 +967,8 @@ aiwg use sdlc --provider factory # Factory AI
925
967
  | **Claude Code** | ✅ **Tested & Validated** | Multi-file (.claude/agents/*.md) | Multi-agent orchestration |
926
968
  | **Warp Terminal** | ✅ **Tested & Validated** | Single-file (WARP.md) | Terminal-native workflows |
927
969
  | **Factory AI** | ✅ **Tested & Validated** | Custom droids (.factory/droids/*.md) | Native droid format, AGENTS.md |
928
- | **OpenAI/Codex** | 🟡 Experimental | `--provider openai` | Functional but not fully tested |
929
- | **Cursor** | 🟡 Experimental | Claude-compatible | Should work, not validated |
970
+ | **Cursor** | **Tested & Validated** | MDC rules (.cursor/rules/*.mdc) | Native rules format, AGENTS.md |
971
+ | **OpenAI/Codex** | **Tested & Validated** | `--provider openai` | Native prompts format, AGENTS.md |
930
972
  | **Windsurf** | 🟡 Experimental | Claude-compatible | Should work, not validated |
931
973
  | **Zed** | 🟡 Experimental | Claude-compatible | Should work, not validated |
932
974
 
@@ -1008,6 +1050,8 @@ git --version && echo "✅ Git installed" || echo "ℹ️ Git optional (needed f
1008
1050
  - [**Warp Terminal Quick Start**](docs/integrations/warp-terminal-quickstart.md) — 3-5 minute setup for Warp Terminal
1009
1051
  - [**Warp Terminal Integration Guide**](docs/integrations/warp-terminal.md) — Comprehensive Warp documentation
1010
1052
  - [**Factory AI Quick Start**](docs/integrations/factory-quickstart.md) — 5-10 minute setup for Factory AI
1053
+ - [**Cursor Quick Start**](docs/integrations/cursor-quickstart.md) — 5-10 minute setup for Cursor IDE
1054
+ - [**Codex Quick Start**](docs/integrations/codex-quickstart.md) — 5-10 minute setup for OpenAI Codex
1011
1055
  - [**Cross-Platform Configuration**](docs/integrations/cross-platform-config.md) — Understanding the WARP.md → CLAUDE.md symlink
1012
1056
 
1013
1057
  ### Writing Quality
@@ -4,6 +4,27 @@ Core meta-utilities for AIWG management. This addon is automatically installed w
4
4
 
5
5
  ## Commands
6
6
 
7
+ ### Deployment Management
8
+
9
+ #### `/aiwg-refresh`
10
+
11
+ Update AIWG CLI and redeploy frameworks/tools to current project without leaving the session.
12
+
13
+ ```bash
14
+ /aiwg-refresh # Check status only
15
+ /aiwg-refresh --update-cli --all # Update CLI and redeploy everything
16
+ /aiwg-refresh --sdlc # Redeploy SDLC framework only
17
+ /aiwg-refresh --provider factory # Switch to Factory AI deployment
18
+ /aiwg-refresh --dry-run # Preview without executing
19
+ ```
20
+
21
+ **Use cases:**
22
+
23
+ - Get latest features after AIWG updates
24
+ - Restore canonical content after manual edits
25
+ - Switch deployment platform (Claude → Factory)
26
+ - Ensure consistency after branch switches
27
+
7
28
  ### Context Regeneration
8
29
 
9
30
  #### `/aiwg-regenerate`
@@ -0,0 +1,307 @@
1
+ ---
2
+ name: aiwg-refresh
3
+ description: Update AIWG CLI and redeploy frameworks/tools to current project without leaving the session
4
+ args: "[--update-cli] [--all] [--sdlc] [--marketing] [--utils] [--provider <name>] [--force] [--dry-run]"
5
+ ---
6
+
7
+ # Refresh AIWG Deployment
8
+
9
+ Update the AIWG CLI and/or redeploy frameworks, agents, commands, and tools to the current
10
+ project without leaving the agentic session.
11
+
12
+ ## Use Cases
13
+
14
+ - **After AIWG updates**: Get latest framework features without restarting
15
+ - **After switching branches**: Ensure deployed content matches expectations
16
+ - **After manual edits**: Restore canonical AIWG content
17
+ - **Provider switch**: Redeploy for different platform (Claude → Factory)
18
+
19
+ ## Parameters
20
+
21
+ | Flag | Description |
22
+ |------|-------------|
23
+ | `--update-cli` | Update AIWG CLI to latest version before redeploying |
24
+ | `--all` | Redeploy all installed frameworks |
25
+ | `--sdlc` | Redeploy SDLC framework only |
26
+ | `--marketing` | Redeploy Marketing framework only |
27
+ | `--utils` | Redeploy aiwg-utils addon only |
28
+ | `--provider <name>` | Target platform: claude, factory, openai, cursor, warp (default: auto-detect) |
29
+ | `--force` | Force redeploy even if already up-to-date |
30
+ | `--dry-run` | Show what would be done without executing |
31
+
32
+ ## Execution Steps
33
+
34
+ ### Step 1: Show Current Status
35
+
36
+ Run status check and report current state:
37
+
38
+ ```bash
39
+ aiwg -status
40
+ ```
41
+
42
+ Report:
43
+
44
+ ```text
45
+ AIWG Refresh - Current Status
46
+ ==============================
47
+
48
+ CLI Version: 1.2.3 (stable channel)
49
+ Workspace: /path/to/project/.aiwg
50
+
51
+ Installed Frameworks:
52
+ - sdlc-complete v1.0.0 (58 agents, 48 commands)
53
+ - aiwg-utils v1.0.0 (3 agents, 25 commands)
54
+
55
+ Platform: Claude Code (.claude/)
56
+ - Agents: 61 deployed
57
+ - Commands: 73 deployed
58
+ ```
59
+
60
+ ### Step 2: Update CLI (if --update-cli)
61
+
62
+ If `--update-cli` flag is set:
63
+
64
+ ```bash
65
+ aiwg -update
66
+ ```
67
+
68
+ Report update status:
69
+
70
+ ```text
71
+ Checking for updates...
72
+ Current: 1.2.3
73
+ Latest: 1.2.5
74
+
75
+ Updating AIWG CLI...
76
+ ✓ Updated to v1.2.5
77
+
78
+ Changes in v1.2.5:
79
+ - New mutation-analyst agent
80
+ - Testing-quality addon
81
+ - Bug fixes
82
+ ```
83
+
84
+ If already up-to-date:
85
+
86
+ ```text
87
+ AIWG CLI is up-to-date (v1.2.3)
88
+ ```
89
+
90
+ ### Step 3: Determine What to Redeploy
91
+
92
+ Based on flags, determine scope:
93
+
94
+ | Flags | Action |
95
+ |-------|--------|
96
+ | No flags | Show status only, prompt for action |
97
+ | `--all` | Redeploy all installed frameworks |
98
+ | `--sdlc` | Redeploy sdlc-complete only |
99
+ | `--marketing` | Redeploy media-marketing-kit only |
100
+ | `--utils` | Redeploy aiwg-utils addon only |
101
+ | Multiple | Redeploy specified frameworks |
102
+
103
+ If no framework flags and not `--dry-run`, ask user:
104
+
105
+ ```text
106
+ What would you like to refresh?
107
+
108
+ [1] All frameworks (sdlc-complete, aiwg-utils)
109
+ [2] SDLC framework only
110
+ [3] Utils addon only
111
+ [4] Just show status (no changes)
112
+
113
+ Choice:
114
+ ```
115
+
116
+ ### Step 4: Detect Target Platform
117
+
118
+ If `--provider` not specified, auto-detect:
119
+
120
+ 1. Check existing deployments:
121
+ - `.claude/agents/` exists → claude
122
+ - `.factory/droids/` exists → factory
123
+ - `.codex/agents/` exists → openai
124
+ - `.cursor/rules/` exists → cursor
125
+
126
+ 2. If multiple detected, ask user:
127
+
128
+ ```text
129
+ Multiple platforms detected:
130
+ [1] Claude Code (.claude/)
131
+ [2] Factory AI (.factory/)
132
+
133
+ Which platform to refresh?
134
+ ```
135
+
136
+ 3. If none detected, default to claude
137
+
138
+ Report:
139
+
140
+ ```text
141
+ Target platform: Claude Code
142
+ Deployment paths:
143
+ - Agents: .claude/agents/
144
+ - Commands: .claude/commands/
145
+ ```
146
+
147
+ ### Step 5: Execute Redeploy
148
+
149
+ For each framework to deploy:
150
+
151
+ ```bash
152
+ # SDLC Framework
153
+ aiwg use sdlc --provider <platform> --force
154
+
155
+ # Marketing Framework
156
+ aiwg use marketing --provider <platform> --force
157
+
158
+ # Utils (included with sdlc)
159
+ # No separate command needed
160
+ ```
161
+
162
+ **If `--dry-run`:**
163
+ Show commands without executing:
164
+
165
+ ```text
166
+ Dry Run - Would execute:
167
+ ========================
168
+
169
+ 1. aiwg use sdlc --provider claude --force
170
+ → Deploy 58 agents to .claude/agents/
171
+ → Deploy 48 commands to .claude/commands/
172
+
173
+ 2. aiwg use marketing --provider claude --force
174
+ → Deploy 37 agents to .claude/agents/
175
+ → Deploy 20 commands to .claude/commands/
176
+
177
+ No changes made (dry run mode)
178
+ ```
179
+
180
+ **Progress Reporting:**
181
+
182
+ ```text
183
+ Refreshing AIWG Deployment
184
+ ==========================
185
+
186
+ [1/2] Deploying sdlc-complete...
187
+ → Copying 58 agents...
188
+ → Copying 48 commands...
189
+ → Copying 12 templates...
190
+ ✓ sdlc-complete deployed
191
+
192
+ [2/2] Deploying aiwg-utils...
193
+ → Copying 3 agents...
194
+ → Copying 25 commands...
195
+ ✓ aiwg-utils deployed
196
+ ```
197
+
198
+ ### Step 6: Verify Deployment
199
+
200
+ After deployment, verify:
201
+
202
+ ```bash
203
+ # Count deployed assets
204
+ ls .claude/agents/*.md 2>/dev/null | wc -l
205
+ ls .claude/commands/*.md 2>/dev/null | wc -l
206
+ ```
207
+
208
+ Report:
209
+
210
+ ```text
211
+ Verification
212
+ ============
213
+
214
+ Deployed Assets:
215
+ - Agents: 95 files
216
+ - Commands: 93 files
217
+
218
+ Platform Files:
219
+ - CLAUDE.md: Present
220
+ - .claude/settings.local.json: Present
221
+
222
+ All assets deployed successfully!
223
+ ```
224
+
225
+ ### Step 7: Summary Report
226
+
227
+ ```text
228
+ AIWG Refresh Complete
229
+ =====================
230
+
231
+ CLI:
232
+ Version: 1.2.5 (updated from 1.2.3)
233
+
234
+ Frameworks Deployed:
235
+ ✓ sdlc-complete v1.0.0 (58 agents, 48 commands)
236
+ ✓ aiwg-utils v1.0.0 (3 agents, 25 commands)
237
+
238
+ Platform: Claude Code
239
+ - .claude/agents/: 61 files
240
+ - .claude/commands/: 73 files
241
+
242
+ New capabilities available:
243
+ - /setup-tdd - TDD enforcement setup
244
+ - /flow-test-strategy-execution - Test execution workflow
245
+ - mutation-analyst agent - Test quality analysis
246
+
247
+ Session ready - new features are now available!
248
+ ```
249
+
250
+ ## Examples
251
+
252
+ ```bash
253
+ # Check status only
254
+ /aiwg-refresh
255
+
256
+ # Update CLI and redeploy everything
257
+ /aiwg-refresh --update-cli --all
258
+
259
+ # Just redeploy SDLC framework
260
+ /aiwg-refresh --sdlc
261
+
262
+ # Switch to Factory AI deployment
263
+ /aiwg-refresh --all --provider factory
264
+
265
+ # Preview what would happen
266
+ /aiwg-refresh --all --dry-run
267
+
268
+ # Force refresh even if up-to-date
269
+ /aiwg-refresh --all --force
270
+ ```
271
+
272
+ ## Natural Language Triggers
273
+
274
+ This command should activate when user says:
275
+
276
+ - "refresh aiwg" / "update aiwg"
277
+ - "redeploy frameworks" / "redeploy agents"
278
+ - "get latest aiwg features"
279
+ - "update my aiwg tools"
280
+ - "sync aiwg deployment"
281
+
282
+ ## Error Handling
283
+
284
+ | Condition | Action |
285
+ |-----------|--------|
286
+ | AIWG CLI not found | Error: "AIWG CLI not installed. Run: curl -fsSL ... \| bash" |
287
+ | Network error on update | Warn and continue with existing version |
288
+ | Framework not installed | Offer to install: "SDLC not installed. Install now? [y/N]" |
289
+ | Permission denied | Error with specific file/directory that failed |
290
+ | Invalid provider | Error listing valid providers |
291
+
292
+ ## Post-Refresh Recommendations
293
+
294
+ After refresh, suggest:
295
+
296
+ ```text
297
+ Recommended next steps:
298
+ 1. Review new features: aiwg -help
299
+ 2. Check framework docs: /aiwg-kb sdlc
300
+ 3. Run health check: aiwg doctor
301
+ ```
302
+
303
+ ## References
304
+
305
+ - @docs/development/file-placement-guide.md - Correct file placement workflow
306
+ - @agentic/code/addons/aiwg-utils/commands/aiwg-regenerate.md - Context file regeneration
307
+ - @docs/CLI_USAGE.md - Full CLI documentation
@@ -34,6 +34,7 @@
34
34
  "prompts": "prompts/"
35
35
  },
36
36
  "commands": [
37
+ "aiwg-refresh",
37
38
  "aiwg-regenerate",
38
39
  "aiwg-regenerate-claude",
39
40
  "aiwg-regenerate-warp",
@@ -0,0 +1,142 @@
1
+ # Testing Quality Addon
2
+
3
+ Advanced testing enforcement, quality metrics, and automation skills for AIWG.
4
+
5
+ ## Overview
6
+
7
+ This addon provides skills for enforcing test-driven development, validating test quality beyond coverage, and maintaining healthy test suites. All recommendations are grounded in academic research and industry best practices.
8
+
9
+ ## Research Foundation
10
+
11
+ | Capability | Source | Reference |
12
+ |------------|--------|-----------|
13
+ | TDD Methodology | Kent Beck (2002) | "Test-Driven Development by Example" |
14
+ | 80% Coverage | Google (2010) | [Testing Blog](https://testing.googleblog.com/2010/07/code-coverage-goal-80-and-no-less.html) |
15
+ | Mutation Testing | ICST Workshop | [IEEE Conference](https://conf.researchr.org/home/icst-2024/mutation-2024) |
16
+ | Flaky Detection | FlaKat (2024) | [arXiv:2403.01003](https://arxiv.org/abs/2403.01003) |
17
+ | Test Refactoring | UTRefactor (ACM 2024) | [89% smell reduction](https://dl.acm.org/doi/10.1145/3715750) |
18
+ | Factory Pattern | ThoughtBot | [FactoryBot](https://github.com/thoughtbot/factory_bot) |
19
+
20
+ ## Skills
21
+
22
+ ### Phase 1: Enforcement & Quality (Critical)
23
+
24
+ | Skill | Purpose | Trigger |
25
+ |-------|---------|---------|
26
+ | `tdd-enforce` | Pre-commit hooks + CI coverage gates | "set up TDD", "add coverage gates" |
27
+ | `mutation-test` | Run mutation testing analysis | "validate test quality", "mutation score" |
28
+ | `flaky-detect` | Identify flaky tests from CI history | "find flaky tests", "CI is unstable" |
29
+ | `flaky-fix` | Suggest/apply fixes for flaky tests | "fix flaky test", "make test reliable" |
30
+
31
+ ### Phase 2: Automation & Efficiency
32
+
33
+ | Skill | Purpose | Trigger |
34
+ |-------|---------|---------|
35
+ | `generate-factory` | Auto-generate test data factories | "generate factory", "create test data" |
36
+ | `test-sync` | Detect orphaned/missing tests | "find orphaned tests", "sync tests" |
37
+
38
+ ## Installation
39
+
40
+ ```bash
41
+ # Via AIWG CLI
42
+ aiwg addon install testing-quality
43
+
44
+ # Or copy to project
45
+ cp -r agentic/code/addons/testing-quality/ .aiwg/addons/
46
+ ```
47
+
48
+ ## Usage Examples
49
+
50
+ ### Set Up TDD Enforcement
51
+
52
+ ```
53
+ "Set up TDD enforcement for this project"
54
+
55
+ → Installs pre-commit hooks
56
+ → Creates CI coverage gates
57
+ → Generates TDD workflow documentation
58
+ ```
59
+
60
+ ### Validate Test Quality
61
+
62
+ ```
63
+ "Run mutation testing on src/auth/"
64
+
65
+ → Runs Stryker/PITest/mutmut
66
+ → Generates mutation score report
67
+ → Identifies weak tests with specific fixes
68
+ ```
69
+
70
+ ### Fix Flaky Tests
71
+
72
+ ```
73
+ "Find and fix flaky tests"
74
+
75
+ → Analyzes CI history for intermittent failures
76
+ → Categorizes by root cause (timing, async, etc.)
77
+ → Suggests deterministic replacements
78
+ ```
79
+
80
+ ### Generate Test Factories
81
+
82
+ ```
83
+ "Generate factory for User model"
84
+
85
+ → Analyzes User interface/schema
86
+ → Creates factory with Faker.js
87
+ → Includes traits and relationships
88
+ ```
89
+
90
+ ## Related Components
91
+
92
+ ### Command
93
+
94
+ - `/setup-tdd` - One-command TDD infrastructure setup
95
+
96
+ ### Agent
97
+
98
+ - `mutation-analyst` - Deep analysis of mutation testing results
99
+
100
+ ### NFR Module
101
+
102
+ - `@.aiwg/requirements/nfr-modules/testing.md` - Testing requirements
103
+
104
+ ## Success Metrics
105
+
106
+ | Metric | Target | Measurement |
107
+ |--------|--------|-------------|
108
+ | Coverage | ≥80% | CI gate |
109
+ | Mutation Score | ≥80% | Stryker/PITest report |
110
+ | Flaky Rate | <2% | CI history analysis |
111
+ | Test Data Setup Time | -60% | Factory adoption |
112
+
113
+ ## Directory Structure
114
+
115
+ ```
116
+ testing-quality/
117
+ ├── manifest.json
118
+ ├── README.md
119
+ └── skills/
120
+ ├── tdd-enforce/
121
+ │ ├── SKILL.md
122
+ │ └── scripts/
123
+ │ └── tdd_setup.py
124
+ ├── mutation-test/
125
+ │ └── SKILL.md
126
+ ├── flaky-detect/
127
+ │ └── SKILL.md
128
+ ├── flaky-fix/
129
+ │ └── SKILL.md
130
+ ├── generate-factory/
131
+ │ └── SKILL.md
132
+ └── test-sync/
133
+ └── SKILL.md
134
+ ```
135
+
136
+ ## References
137
+
138
+ - @.aiwg/planning/testing-tools-recommendations-referenced.md
139
+ - @.aiwg/requirements/nfr-modules/testing.md
140
+ - @agentic/code/frameworks/sdlc-complete/agents/test-engineer.md
141
+ - @agentic/code/frameworks/sdlc-complete/agents/test-architect.md
142
+ - @agentic/code/frameworks/sdlc-complete/agents/mutation-analyst.md
@@ -0,0 +1,37 @@
1
+ {
2
+ "name": "testing-quality",
3
+ "version": "1.0.0",
4
+ "description": "Testing enforcement, quality metrics, and automation skills",
5
+ "category": "sdlc",
6
+ "skills": [
7
+ "tdd-enforce",
8
+ "mutation-test",
9
+ "flaky-detect",
10
+ "flaky-fix",
11
+ "generate-factory",
12
+ "test-sync"
13
+ ],
14
+ "dependencies": [],
15
+ "research_basis": {
16
+ "tdd": {
17
+ "source": "Kent Beck (2002)",
18
+ "reference": "Test-Driven Development by Example"
19
+ },
20
+ "coverage": {
21
+ "source": "Google Testing Blog (2010)",
22
+ "reference": "https://testing.googleblog.com/2010/07/code-coverage-goal-80-and-no-less.html"
23
+ },
24
+ "mutation": {
25
+ "source": "ICST Mutation Workshop",
26
+ "reference": "https://conf.researchr.org/home/icst-2024/mutation-2024"
27
+ },
28
+ "flaky": {
29
+ "source": "Google (2016) + FlaKat (2024)",
30
+ "reference": "https://arxiv.org/abs/2403.01003"
31
+ },
32
+ "factories": {
33
+ "source": "ThoughtBot FactoryBot + Faker.js",
34
+ "reference": "https://fakerjs.dev/"
35
+ }
36
+ }
37
+ }