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.
- package/CLAUDE.md +4 -1
- package/README.md +61 -17
- package/agentic/code/addons/aiwg-utils/README.md +21 -0
- package/agentic/code/addons/aiwg-utils/commands/aiwg-refresh.md +307 -0
- package/agentic/code/addons/aiwg-utils/manifest.json +1 -0
- package/agentic/code/addons/testing-quality/README.md +142 -0
- package/agentic/code/addons/testing-quality/manifest.json +37 -0
- package/agentic/code/addons/testing-quality/skills/flaky-detect/SKILL.md +287 -0
- package/agentic/code/addons/testing-quality/skills/flaky-fix/SKILL.md +313 -0
- package/agentic/code/addons/testing-quality/skills/generate-factory/SKILL.md +331 -0
- package/agentic/code/addons/testing-quality/skills/mutation-test/SKILL.md +299 -0
- package/agentic/code/addons/testing-quality/skills/tdd-enforce/SKILL.md +261 -0
- package/agentic/code/addons/testing-quality/skills/tdd-enforce/scripts/tdd_setup.py +433 -0
- package/agentic/code/addons/testing-quality/skills/test-sync/SKILL.md +312 -0
- package/agentic/code/frameworks/sdlc-complete/agents/README.md +13 -2
- package/agentic/code/frameworks/sdlc-complete/agents/mutation-analyst.md +231 -0
- package/agentic/code/frameworks/sdlc-complete/agents/software-implementer.md +115 -22
- package/agentic/code/frameworks/sdlc-complete/agents/test-architect.md +144 -22
- package/agentic/code/frameworks/sdlc-complete/agents/test-engineer.md +198 -387
- package/agentic/code/frameworks/sdlc-complete/commands/setup-tdd.md +254 -0
- package/agentic/code/frameworks/sdlc-complete/templates/codex/AGENTS.md.aiwg-template +93 -0
- package/agentic/code/frameworks/sdlc-complete/templates/codex/ci-cd/aiwg-codex-review.yml +87 -0
- package/agentic/code/frameworks/sdlc-complete/templates/codex/ci-cd/aiwg-codex-security.yml +164 -0
- package/agentic/code/frameworks/sdlc-complete/templates/codex/ci-cd/aiwg-codex-tests.yml +126 -0
- package/agentic/code/frameworks/sdlc-complete/templates/codex/config.toml.aiwg-template +121 -0
- package/agentic/code/frameworks/sdlc-complete/templates/copilot/copilot-instructions.md.aiwg-template +71 -0
- package/agentic/code/frameworks/sdlc-complete/templates/cursor/AGENTS.md.aiwg-template +114 -0
- package/agentic/code/frameworks/sdlc-complete/templates/cursor/ci-cd/aiwg-cursor-review.yml +70 -0
- package/agentic/code/frameworks/sdlc-complete/templates/cursor/ci-cd/aiwg-cursor-security.yml +101 -0
- package/agentic/code/frameworks/sdlc-complete/templates/cursor/ci-cd/aiwg-cursor-tests.yml +140 -0
- package/agentic/code/frameworks/sdlc-complete/templates/cursor/cli.json.aiwg-template +27 -0
- package/agentic/code/frameworks/sdlc-complete/templates/cursor/worktrees.json.aiwg-template +15 -0
- package/agentic/code/frameworks/sdlc-complete/templates/intake/project-intake-template.md +47 -0
- package/agentic/code/frameworks/sdlc-complete/templates/opencode/AGENTS.md.aiwg-template +73 -0
- package/agentic/code/frameworks/sdlc-complete/templates/opencode/ci-cd/opencode-aiwg.yml +73 -0
- package/agentic/code/frameworks/sdlc-complete/templates/opencode/instructions.md.aiwg-template +83 -0
- package/agentic/code/frameworks/sdlc-complete/templates/opencode/opencode.json.aiwg-template +24 -0
- package/agentic/code/frameworks/sdlc-complete/templates/opencode/plugin/aiwg-hooks.ts.aiwg-template +121 -0
- package/agentic/code/frameworks/sdlc-complete/templates/opencode/themes/aiwg.json.aiwg-template +221 -0
- package/agentic/code/frameworks/sdlc-complete/templates/opencode/tool/aiwg-workflow.ts.aiwg-template +176 -0
- package/agentic/code/frameworks/sdlc-complete/test/unit/security/security-validator.test.ts +2 -1
- package/docs/commands/development-commands-examples.md +724 -0
- package/docs/contributing/testing-requirements.md +142 -0
- package/docs/development/file-placement-guide.md +168 -0
- package/docs/development/subagents-guide.md +515 -0
- package/docs/examples/codex-sdk-examples.ts +321 -0
- package/docs/index.md +4 -8
- package/docs/integrations/codex-quickstart.md +229 -0
- package/docs/integrations/copilot-quickstart.md +232 -0
- package/docs/integrations/cross-platform-config.md +18 -0
- package/docs/integrations/cursor-quickstart.md +253 -0
- package/docs/integrations/opencode-quickstart.md +303 -0
- package/package.json +1 -1
- package/src/cli/index.mjs +3 -10
- package/src/mcp/cli.mjs +152 -4
- package/tools/agents/deploy-agents.mjs +767 -20
- package/tools/commands/deploy-prompts-codex.mjs +302 -0
- package/tools/install/install.sh +4 -0
- package/tools/rules/deploy-rules-cursor.mjs +332 -0
- package/tools/skills/deploy-skills-codex.mjs +319 -0
- 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
|
-
|
|
|
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
|
|
9
|
+
aiwg use sdlc # deploy SDLC framework
|
|
10
10
|
```
|
|
11
11
|
|
|
12
|
-
[](https://www.npmjs.com/package/aiwg)
|
|
13
|
-
[](https://www.npmjs.com/package/aiwg)
|
|
14
|
-
[](LICENSE)
|
|
15
|
-
[](https://www.npmjs.com/package/aiwg)
|
|
13
|
+
[](https://www.npmjs.com/package/aiwg)
|
|
14
|
+
[](LICENSE)
|
|
15
|
+
[](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
|
-
[](https://discord.gg/BuAusFMxdA)
|
|
20
|
-
[](https://t.me/+oJg9w2lE6A5lOGFh)
|
|
19
|
+
[](https://discord.gg/BuAusFMxdA)
|
|
20
|
+
[](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
|
|
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
|
-
#
|
|
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
|
-
│
|
|
291
|
-
│
|
|
292
|
-
│
|
|
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
|
-
| **
|
|
929
|
-
| **
|
|
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
|
|
@@ -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
|
+
}
|