aiwg 2026.1.4 → 2026.1.6

package/CLAUDE.md

@@ -190,7 +190,9 @@ Before pushing a version tag:
 
 ### Version Format
 
-- **CalVer**: `YYYY.MM.PATCH` (e.g., `2026.01.3`)
+- **CalVer**: `YYYY.M.PATCH` (e.g., `2026.1.5`, `2026.12.0`)
+- **CRITICAL**: No leading zeros! npm semver rejects `01`, `02`, etc.
 - PATCH resets each month
-- Tag format: `vYYYY.MM.PATCH` (e.g., `v2026.01.3`)
+- Tag format: `vYYYY.M.PATCH` (e.g., `v2026.1.5`)
+- See `@docs/contributing/versioning.md` for full details
 

package/docs/contributing/ci-cd-secrets.md

@@ -0,0 +1,188 @@
+# CI/CD Secrets Configuration
+
+**Version:** 1.0
+**Last Updated:** 2026-01-14
+**Target Audience:** Repository maintainers and administrators
+
+## Overview
+
+This document describes the secrets required for CI/CD workflows in the AIWG repository. Secrets are used for authentication with package registries and external services.
+
+## Required Secrets
+
+### NPM_TOKEN
+
+**Purpose:** Authenticate with Gitea's npm package registry for publishing.
+
+**Required Scopes:**
+- `package:write` - Required to publish packages
+- `package:read` - Required to verify published packages
+
+**Used In:**
+- `.gitea/workflows/npm-publish.yml` - Publishing to Gitea npm registry
+- Creating Gitea releases via API
+
+### Setting Up NPM_TOKEN
+
+#### Step 1: Create a Gitea Access Token
+
+1. Log in to [git.integrolabs.net](https://git.integrolabs.net)
+2. Navigate to **Settings** → **Applications** → **Access Tokens**
+   - Direct URL: https://git.integrolabs.net/user/settings/applications
+3. Create a new token with:
+   - **Token Name:** `ci-npm-publish` (or descriptive name)
+   - **Select Scopes:**
+     - ✅ `write:package` (includes read:package)
+     - ✅ `read:repository` (for checkout operations)
+   - **Expiration:** Set according to your security policy (recommend 1 year max)
+4. Click **Generate Token**
+5. **IMPORTANT:** Copy the token immediately - it won't be shown again
+
+#### Step 2: Add Secret to Gitea Repository
+
+1. Navigate to the repository: https://git.integrolabs.net/roctinam/ai-writing-guide
+2. Go to **Settings** → **Actions** → **Secrets**
+3. Click **Add Secret**
+4. Configure:
+   - **Name:** `NPM_TOKEN`
+   - **Value:** Paste the token from Step 1
+5. Click **Add Secret**
+
+#### Step 3: Verify Configuration
+
+Trigger a manual workflow run to verify:
+
+```bash
+# Push a test tag (can be deleted after)
+git tag v9999.99.99-test
+git push origin v9999.99.99-test
+
+# Watch the workflow at:
+# https://git.integrolabs.net/roctinam/ai-writing-guide/actions
+
+# Clean up test tag
+git tag -d v9999.99.99-test
+git push origin :refs/tags/v9999.99.99-test
+```
+
+Or use the workflow dispatch with dry_run enabled.
+
+## Troubleshooting
+
+### Error: 401 Unauthorized
+
+```
+npm error code E401
+npm error 401 Unauthorized - PUT https://git.integrolabs.net/api/packages/roctinam/npm/aiwg
+```
+
+**Causes:**
+1. **Token expired** - Create a new token and update the secret
+2. **Token missing** - Verify NPM_TOKEN secret exists in repository settings
+3. **Wrong scopes** - Token must have `write:package` scope
+4. **Token revoked** - Check if token still exists in user settings
+
+**Resolution:**
+1. Go to https://git.integrolabs.net/user/settings/applications
+2. Check if the token exists and hasn't expired
+3. If expired/missing, create a new token with `write:package` scope
+4. Update the repository secret with the new token
+
+### Error: 403 Forbidden
+
+**Causes:**
+1. Token belongs to user without package write permissions
+2. Repository doesn't allow package publishing
+
+**Resolution:**
+1. Ensure token owner has write access to the repository
+2. Check organization/repository package settings
+
+### Token Not Being Used
+
+If the workflow isn't picking up the secret:
+
+1. Verify secret name is exactly `NPM_TOKEN` (case-sensitive)
+2. Check workflow file references `${{ secrets.NPM_TOKEN }}`
+3. Ensure workflow has appropriate permissions in `permissions:` block
+
+## Security Best Practices
+
+### Token Management
+
+- **Rotation:** Rotate tokens annually or when team members leave
+- **Scope:** Use minimum required scopes (write:package, read:repository)
+- **Naming:** Use descriptive names like `ci-npm-publish-2026`
+- **Audit:** Periodically review active tokens
+
+### Secret Storage
+
+- Never commit tokens to the repository
+- Use repository/organization secrets, not environment variables in code
+- Don't echo or log token values in workflows
+
+### Workflow Security
+
+```yaml
+# Good: Token passed via secrets
+env:
+  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+# Bad: Token hardcoded or echoed
+run: echo ${{ secrets.NPM_TOKEN }}  # NEVER do this
+```
+
+## Workflow Architecture
+
+### npm-publish.yml Flow
+
+```
+[Tag Push v*] → [Checkout] → [Configure npm] → [Build] → [Publish to Gitea] → [Verify]
+                                   ↓
+                            Uses NPM_TOKEN for:
+                            - .npmrc authentication
+                            - npm publish command
+                            - Gitea release API
+```
+
+### Secret Usage in Workflow
+
+```yaml
+# .npmrc configuration (line 55-56)
+//git.integrolabs.net/api/packages/roctinam/npm/:_authToken=${{ secrets.NPM_TOKEN }}
+
+# Publish command (line 107-109)
+npm publish --registry=${{ env.GITEA_NPM_REGISTRY }}
+env:
+  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+# Release creation (line 137)
+-H "Authorization: token ${{ secrets.NPM_TOKEN }}"
+```
+
+## Additional Secrets (Optional)
+
+### NPMJS_TOKEN (for public npm)
+
+If publishing to public npmjs.org:
+
+1. Create token at https://www.npmjs.com/settings/tokens
+2. Select "Automation" token type
+3. Add as secret named `NPMJS_TOKEN`
+4. Update workflow to use separate token for public registry
+
+### GITHUB_TOKEN (for GitHub mirror)
+
+For GitHub Actions (`.github/workflows/`):
+
+- Automatically provided by GitHub Actions
+- No manual configuration needed
+- Used for GitHub Releases and npm publish to GitHub Packages
+
+## References
+
+- [Gitea Package Registry Documentation](https://docs.gitea.com/usage/packages/npm)
+- [Gitea Actions Secrets](https://docs.gitea.com/usage/actions/secrets)
+- [npm Authentication](https://docs.npmjs.com/using-private-packages-in-a-ci-cd-workflow)
+- @.gitea/workflows/npm-publish.yml - Main publish workflow
+- @.claude/rules/token-security.md - Token security rules

package/docs/contributing/versioning.md

@@ -0,0 +1,196 @@
+# Versioning Guide
+
+**Version:** 1.0
+**Last Updated:** 2026-01-14
+**Target Audience:** All contributors and AI agents
+
+## Overview
+
+AIWG uses **Calendar Versioning (CalVer)** with npm-compatible format. This document explains the versioning scheme and critical rules to avoid npm publishing failures.
+
+## Version Format
+
+```
+YYYY.M.PATCH
+```
+
+| Component | Description | Example |
+|-----------|-------------|---------|
+| `YYYY` | Four-digit year | `2026` |
+| `M` | Month (1-12, **NO leading zeros**) | `1`, `12` |
+| `PATCH` | Patch number within month (resets each month) | `0`, `1`, `5` |
+
+### Examples
+
+| Correct | Incorrect | Why |
+|---------|-----------|-----|
+| `2026.1.0` | `2026.01.0` | Leading zero in month |
+| `2026.1.5` | `2026.01.05` | Leading zeros in month and patch |
+| `2026.12.0` | `2026.12.00` | Leading zero in patch |
+
+## Critical Rule: No Leading Zeros
+
+**npm's semver parser rejects leading zeros.** This is per the [Semantic Versioning spec](https://semver.org/):
+
+> A normal version number MUST take the form X.Y.Z where X, Y, and Z are non-negative integers, and **MUST NOT contain leading zeroes**.
+
+### What Happens With Leading Zeros
+
+```bash
+# This FAILS
+$ npm -g update aiwg
+npm error Invalid Version: 2026.01.4
+
+# This WORKS (same package, different command)
+$ npm -g install aiwg
+# Installs successfully but update is broken
+```
+
+The `npm install` command is more lenient than `npm update`. Users will be able to install but not update, causing confusion and support issues.
+
+## Tag Format
+
+Git tags should match the version with a `v` prefix:
+
+```bash
+# Correct
+git tag -a v2026.1.5 -m "v2026.1.5 - Feature Name"
+
+# Incorrect
+git tag -a v2026.01.5 -m "v2026.01.5 - Feature Name"
+```
+
+## Release Workflow
+
+### 1. Update package.json
+
+```json
+{
+  "version": "2026.1.5"
+}
+```
+
+**Validation**: Run this to check for leading zeros:
+
+```bash
+grep '"version"' package.json | grep -E '\.[0-9]{2}\.' && echo "ERROR: Leading zero detected!" || echo "OK: No leading zeros"
+```
+
+### 2. Update CHANGELOG.md
+
+```markdown
+## [2026.1.5] - 2026-01-14 – "Release Name"
+```
+
+### 3. Create and Push Tag
+
+```bash
+# Create annotated tag
+git tag -a v2026.1.5 -m "v2026.1.5 - Release Name"
+
+# Push to both remotes
+git push origin main --tags
+git push github main --tags
+```
+
+### 4. Verify Published Version
+
+After CI/CD completes:
+
+```bash
+npm view aiwg version
+# Should show: 2026.1.5
+```
+
+## Version Progression Examples
+
+### Within a Month
+
+```
+2026.1.0  → First release in January 2026
+2026.1.1  → Bug fix
+2026.1.2  → Another fix
+2026.1.3  → Feature addition
+```
+
+### Month Transitions
+
+```
+2026.1.5  → Last release in January
+2026.2.0  → First release in February (PATCH resets)
+2026.2.1  → Next release in February
+```
+
+### Year Transitions
+
+```
+2026.12.3 → December release
+2027.1.0  → January of next year
+```
+
+## Automated Validation
+
+### Pre-commit Hook (Optional)
+
+Add to `.git/hooks/pre-commit`:
+
+```bash
+#!/bin/bash
+VERSION=$(grep '"version"' package.json | head -1)
+if echo "$VERSION" | grep -qE '\.[0-9]{2}\.'; then
+  echo "ERROR: package.json version has leading zeros!"
+  echo "Found: $VERSION"
+  echo "Fix: Remove leading zeros (e.g., 2026.01.5 → 2026.1.5)"
+  exit 1
+fi
+```
+
+### CI Validation
+
+The npm publish workflow will fail if the version has leading zeros, but it's better to catch this before pushing.
+
+## Common Mistakes
+
+### Mistake 1: Copy-Paste from Dates
+
+```bash
+# Today is January 5, 2026
+# WRONG: Using date format
+2026.01.05
+
+# RIGHT: Using CalVer format
+2026.1.5
+```
+
+### Mistake 2: Assuming Two-Digit Month
+
+```bash
+# WRONG: Padding single-digit months
+2026.01.0, 2026.02.0, ..., 2026.09.0
+
+# RIGHT: No padding
+2026.1.0, 2026.2.0, ..., 2026.9.0
+```
+
+### Mistake 3: Incrementing Without Checking Format
+
+When bumping versions, always verify the format:
+
+```bash
+# Before: 2026.1.4
+# Bumping patch...
+
+# WRONG (if you typed it manually)
+"version": "2026.01.5"
+
+# RIGHT
+"version": "2026.1.5"
+```
+
+## References
+
+- [Semantic Versioning 2.0.0](https://semver.org/)
+- [Calendar Versioning](https://calver.org/)
+- [npm semver](https://docs.npmjs.com/cli/v6/using-npm/semver)
+- @CLAUDE.md - Release Documentation Requirements
+- @docs/contributing/ci-cd-secrets.md - CI/CD configuration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiwg",
-  "version": "2026.01.4",
+  "version": "2026.1.6",
   "description": "Modular agentic framework for AI-powered SDLC, marketing automation, and workflow orchestration",
   "type": "module",
   "bin": {

package/tools/agents/deploy-windsurf.mjs

@@ -606,17 +606,24 @@ async function main() {
   // Collect agent files based on mode
   const agentFiles = [];
 
-  // Writing/General agents
-  if (mode === 'general' || mode === 'writing' || mode === 'both' || mode === 'all') {
-    const writingAddonAgentsRoot = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'agents');
-    const legacyAgentsRoot = path.join(srcRoot, 'agents');
-    const agentsRoot = fs.existsSync(writingAddonAgentsRoot) ? writingAddonAgentsRoot : legacyAgentsRoot;
-
-    if (fs.existsSync(agentsRoot)) {
-      const files = listMdFiles(agentsRoot);
-      if (files.length > 0) {
-        console.log(`Found ${files.length} writing/general agents`);
-        agentFiles.push(...files);
+  // All addons (dynamically discovered)
+  if (mode === 'general' || mode === 'writing' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+    const addonsRoot = path.join(srcRoot, 'agentic', 'code', 'addons');
+    if (fs.existsSync(addonsRoot)) {
+      let addonAgentCount = 0;
+      const addonDirs = fs.readdirSync(addonsRoot, { withFileTypes: true })
+        .filter(e => e.isDirectory())
+        .map(e => path.join(addonsRoot, e.name, 'agents'));
+
+      for (const addonAgentsDir of addonDirs) {
+        if (fs.existsSync(addonAgentsDir)) {
+          const files = listMdFiles(addonAgentsDir);
+          agentFiles.push(...files);
+          addonAgentCount += files.length;
+        }
+      }
+      if (addonAgentCount > 0) {
+        console.log(`Found ${addonAgentCount} addon agents`);
       }
     }
   }
@@ -693,6 +700,20 @@ async function main() {
   // Collect skills count for .windsurfrules
   let skillCount = 0;
   if (deploySkills) {
+    // Addon skills (dynamically discovered)
+    const addonsRoot = path.join(srcRoot, 'agentic', 'code', 'addons');
+    if (fs.existsSync(addonsRoot)) {
+      const addonDirs = fs.readdirSync(addonsRoot, { withFileTypes: true })
+        .filter(e => e.isDirectory())
+        .map(e => path.join(addonsRoot, e.name, 'skills'));
+
+      for (const addonSkillsDir of addonDirs) {
+        if (fs.existsSync(addonSkillsDir)) {
+          skillCount += listSkillDirs(addonSkillsDir).length;
+        }
+      }
+    }
+
     // SDLC skills
     if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
       const sdlcSkillsRoot = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'skills');
@@ -701,16 +722,9 @@ async function main() {
       }
     }
 
-    // Utils addon skills
-    const utilsSkillsRoot = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'skills');
-    if (fs.existsSync(utilsSkillsRoot)) {
-      skillCount += listSkillDirs(utilsSkillsRoot).length;
-    }
-
     if (skillCount > 0) {
       console.log(`\n[NOTE] Skills (${skillCount} found) are not directly deployed to Windsurf.`);
-      console.log('Reference skill files in prompts using @-mentions:');
-      console.log('  @~/.local/share/ai-writing-guide/agentic/code/addons/aiwg-utils/skills/<skill>/SKILL.md');
+      console.log('Reference skill files in prompts using @-mentions.');
     }
   }
 

package/tools/agents/providers/base.mjs

@@ -568,6 +568,136 @@ export function filterAgentFiles(files, opts) {
   });
 }
 
+// ============================================================================
+// Addon Discovery
+// ============================================================================
+
+/**
+ * Discover all addons in the agentic/code/addons directory
+ * @param {string} srcRoot - Source root directory
+ * @returns {Array<{name: string, path: string, manifest: object}>} - Array of addon info
+ */
+export function discoverAddons(srcRoot) {
+  const addonsDir = path.join(srcRoot, 'agentic', 'code', 'addons');
+  if (!fs.existsSync(addonsDir)) return [];
+
+  const addons = [];
+  for (const entry of fs.readdirSync(addonsDir, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+
+    const addonPath = path.join(addonsDir, entry.name);
+    const manifestPath = path.join(addonPath, 'manifest.json');
+
+    let manifest = {};
+    if (fs.existsSync(manifestPath)) {
+      try {
+        manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+      } catch (e) {
+        console.warn(`Warning: Could not parse manifest for addon ${entry.name}: ${e.message}`);
+      }
+    }
+
+    addons.push({
+      name: entry.name,
+      path: addonPath,
+      manifest
+    });
+  }
+
+  return addons;
+}
+
+/**
+ * Get all agent files from all addons
+ * @param {string} srcRoot - Source root directory
+ * @param {string[]} excludeAddons - Addon names to exclude (default: none)
+ * @returns {string[]} - Array of agent file paths
+ */
+export function getAddonAgentFiles(srcRoot, excludeAddons = []) {
+  const addons = discoverAddons(srcRoot);
+  const files = [];
+
+  for (const addon of addons) {
+    if (excludeAddons.includes(addon.name)) continue;
+
+    const agentsDir = path.join(addon.path, 'agents');
+    if (fs.existsSync(agentsDir)) {
+      files.push(...listMdFiles(agentsDir));
+    }
+  }
+
+  return files;
+}
+
+/**
+ * Get all command files from all addons
+ * @param {string} srcRoot - Source root directory
+ * @param {string[]} excludeAddons - Addon names to exclude (default: none)
+ * @returns {string[]} - Array of command file paths
+ */
+export function getAddonCommandFiles(srcRoot, excludeAddons = []) {
+  const addons = discoverAddons(srcRoot);
+  const files = [];
+
+  for (const addon of addons) {
+    if (excludeAddons.includes(addon.name)) continue;
+
+    const commandsDir = path.join(addon.path, 'commands');
+    if (fs.existsSync(commandsDir)) {
+      files.push(...listMdFiles(commandsDir));
+    }
+  }
+
+  return files;
+}
+
+/**
+ * Get all skill directories from all addons
+ * @param {string} srcRoot - Source root directory
+ * @param {string[]} excludeAddons - Addon names to exclude (default: none)
+ * @returns {string[]} - Array of skill directory paths
+ */
+export function getAddonSkillDirs(srcRoot, excludeAddons = []) {
+  const addons = discoverAddons(srcRoot);
+  const dirs = [];
+
+  for (const addon of addons) {
+    if (excludeAddons.includes(addon.name)) continue;
+
+    const skillsDir = path.join(addon.path, 'skills');
+    if (fs.existsSync(skillsDir)) {
+      dirs.push(...listSkillDirs(skillsDir));
+    }
+  }
+
+  return dirs;
+}
+
+/**
+ * Get addon files by category (agents, commands, skills)
+ * @param {string} srcRoot - Source root directory
+ * @param {object} options - Options
+ * @param {string[]} options.excludeAddons - Addon names to exclude
+ * @param {boolean} options.includeAgents - Include agent files (default: true)
+ * @param {boolean} options.includeCommands - Include command files (default: true)
+ * @param {boolean} options.includeSkills - Include skill directories (default: true)
+ * @returns {{agents: string[], commands: string[], skills: string[]}}
+ */
+export function getAddonFiles(srcRoot, options = {}) {
+  const {
+    excludeAddons = [],
+    includeAgents = true,
+    includeCommands = true,
+    includeSkills = true
+  } = options;
+
+  return {
+    agents: includeAgents ? getAddonAgentFiles(srcRoot, excludeAddons) : [],
+    commands: includeCommands ? getAddonCommandFiles(srcRoot, excludeAddons) : [],
+    skills: includeSkills ? getAddonSkillDirs(srcRoot, excludeAddons) : []
+  };
+}
+
 // ============================================================================
 // Provider Interface
 // ============================================================================

package/tools/agents/providers/claude.mjs

@@ -23,7 +23,10 @@ import {
   deploySkillDir,
   parseFrontmatter,
   initializeFrameworkWorkspace,
-  filterAgentFiles
+  filterAgentFiles,
+  getAddonAgentFiles,
+  getAddonCommandFiles,
+  getAddonSkillDirs
 } from './base.mjs';
 
 // ============================================================================
@@ -281,19 +284,16 @@ export async function deploy(opts) {
     }
   }
 
-  // Writing/general agents
-  if (mode === 'general' || mode === 'writing' || mode === 'both' || mode === 'all') {
-    const writingAgentsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'agents');
-    agentFiles.push(...listMdFiles(writingAgentsDir));
+  // All addons (dynamically discovered)
+  if (mode === 'general' || mode === 'writing' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+    agentFiles.push(...getAddonAgentFiles(srcRoot));
 
     if (shouldDeployCommands || commandsOnly) {
-      const writingCommandsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'commands');
-      commandFiles.push(...listMdFiles(writingCommandsDir));
+      commandFiles.push(...getAddonCommandFiles(srcRoot));
     }
 
     if (shouldDeploySkills || skillsOnly) {
-      const writingSkillsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'skills');
-      skillDirs.push(...listSkillDirs(writingSkillsDir));
+      skillDirs.push(...getAddonSkillDirs(srcRoot));
     }
   }
 
@@ -329,28 +329,6 @@ export async function deploy(opts) {
     }
   }
 
-  // Utils addon (always deployed with sdlc or all)
-  if (mode === 'sdlc' || mode === 'all') {
-    const utilsAgentsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'agents');
-    agentFiles.push(...listMdFiles(utilsAgentsDir));
-
-    if (shouldDeployCommands || commandsOnly) {
-      const utilsCommandsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'commands');
-      commandFiles.push(...listMdFiles(utilsCommandsDir));
-    }
-
-    if (shouldDeploySkills || skillsOnly) {
-      const utilsSkillsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'skills');
-      skillDirs.push(...listSkillDirs(utilsSkillsDir));
-    }
-  }
-
-  // Voice framework skills (always deployed)
-  if (shouldDeploySkills || skillsOnly) {
-    const voiceSkillsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'voice-framework', 'skills');
-    skillDirs.push(...listSkillDirs(voiceSkillsDir));
-  }
-
   // Deploy based on flags
   if (!commandsOnly && !skillsOnly) {
     // Apply filters if specified

package/tools/agents/providers/codex.mjs

@@ -26,7 +26,10 @@ import {
   writeFile,
   deployFiles,
   createAgentsMdFromTemplate,
-  initializeFrameworkWorkspace
+  initializeFrameworkWorkspace,
+  getAddonAgentFiles,
+  getAddonCommandFiles,
+  getAddonSkillDirs
 } from './base.mjs';
 
 // ============================================================================
@@ -298,28 +301,20 @@ export async function deploy(opts) {
   // Collect source files based on mode
   const agentFiles = [];
 
-  // Writing/general agents
-  if (mode === 'general' || mode === 'writing' || mode === 'both' || mode === 'all') {
-    const writingAgentsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'agents');
-    agentFiles.push(...listMdFiles(writingAgentsDir));
-  }
-
-  // SDLC framework
+  // Frameworks
   if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
     const sdlcAgentsDir = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'agents');
     agentFiles.push(...listMdFiles(sdlcAgentsDir));
   }
 
-  // Marketing framework
   if (mode === 'marketing' || mode === 'all') {
     const marketingAgentsDir = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'media-marketing-kit', 'agents');
     agentFiles.push(...listMdFiles(marketingAgentsDir));
   }
 
-  // Utils addon
-  if (mode === 'sdlc' || mode === 'all') {
-    const utilsAgentsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'agents');
-    agentFiles.push(...listMdFiles(utilsAgentsDir));
+  // All addons (dynamically discovered)
+  if (mode === 'general' || mode === 'writing' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+    agentFiles.push(...getAddonAgentFiles(srcRoot));
   }
 
   // Deploy based on flags

package/tools/agents/providers/copilot.mjs

@@ -24,7 +24,9 @@ import {
   deployFiles,
   inferAgentCategory,
   toKebabCase,
-  initializeFrameworkWorkspace
+  initializeFrameworkWorkspace,
+  getAddonAgentFiles,
+  getAddonCommandFiles
 } from './base.mjs';
 
 // ============================================================================
@@ -348,17 +350,16 @@ export async function deploy(opts) {
   const agentFiles = [];
   const commandFiles = [];
 
-  // Collect files based on mode
-  if (mode === 'general' || mode === 'writing' || mode === 'both' || mode === 'all') {
-    const writingAgentsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'agents');
-    agentFiles.push(...listMdFiles(writingAgentsDir));
+  // All addons (dynamically discovered)
+  if (mode === 'general' || mode === 'writing' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+    agentFiles.push(...getAddonAgentFiles(srcRoot));
 
     if (shouldDeployCommands || commandsOnly) {
-      const writingCommandsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'commands');
-      commandFiles.push(...listMdFiles(writingCommandsDir));
+      commandFiles.push(...getAddonCommandFiles(srcRoot));
     }
   }
 
+  // Frameworks
   if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
     const sdlcAgentsDir = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'agents');
     agentFiles.push(...listMdFiles(sdlcAgentsDir));
@@ -379,16 +380,6 @@ export async function deploy(opts) {
     }
   }
 
-  if (mode === 'sdlc' || mode === 'all') {
-    const utilsAgentsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'agents');
-    agentFiles.push(...listMdFiles(utilsAgentsDir));
-
-    if (shouldDeployCommands || commandsOnly) {
-      const utilsCommandsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'commands');
-      commandFiles.push(...listMdFiles(utilsCommandsDir));
-    }
-  }
-
   // Deploy
   if (!commandsOnly) {
     console.log(`\nDeploying ${agentFiles.length} agents (YAML format)...`);

package/tools/agents/providers/factory.mjs

@@ -26,7 +26,9 @@ import {
   toKebabCase,
   stripJsonComments,
   createAgentsMdFromTemplate,
-  initializeFrameworkWorkspace
+  initializeFrameworkWorkspace,
+  getAddonAgentFiles,
+  getAddonCommandFiles
 } from './base.mjs';
 
 // ============================================================================
@@ -455,14 +457,12 @@ export async function deploy(opts) {
   const agentFiles = [];
   const commandFiles = [];
 
-  // Writing/general agents
-  if (mode === 'general' || mode === 'writing' || mode === 'both' || mode === 'all') {
-    const writingAgentsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'agents');
-    agentFiles.push(...listMdFiles(writingAgentsDir));
+  // All addons (dynamically discovered)
+  if (mode === 'general' || mode === 'writing' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+    agentFiles.push(...getAddonAgentFiles(srcRoot));
 
     if (shouldDeployCommands || commandsOnly) {
-      const writingCommandsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'commands');
-      commandFiles.push(...listMdFiles(writingCommandsDir));
+      commandFiles.push(...getAddonCommandFiles(srcRoot));
     }
   }
 
@@ -488,17 +488,6 @@ export async function deploy(opts) {
     }
   }
 
-  // Utils addon
-  if (mode === 'sdlc' || mode === 'all') {
-    const utilsAgentsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'agents');
-    agentFiles.push(...listMdFiles(utilsAgentsDir));
-
-    if (shouldDeployCommands || commandsOnly) {
-      const utilsCommandsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'commands');
-      commandFiles.push(...listMdFiles(utilsCommandsDir));
-    }
-  }
-
   // Deploy based on flags
   if (!commandsOnly) {
     console.log(`\nDeploying ${agentFiles.length} agents as droids...`);

package/tools/agents/providers/opencode.mjs

@@ -23,7 +23,9 @@ import {
   deployFiles,
   inferAgentCategory,
   createAgentsMdFromTemplate,
-  initializeFrameworkWorkspace
+  initializeFrameworkWorkspace,
+  getAddonAgentFiles,
+  getAddonCommandFiles
 } from './base.mjs';
 
 // ============================================================================
@@ -317,17 +319,16 @@ export async function deploy(opts) {
   const agentFiles = [];
   const commandFiles = [];
 
-  // Collect files based on mode
-  if (mode === 'general' || mode === 'writing' || mode === 'both' || mode === 'all') {
-    const writingAgentsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'agents');
-    agentFiles.push(...listMdFiles(writingAgentsDir));
+  // All addons (dynamically discovered)
+  if (mode === 'general' || mode === 'writing' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+    agentFiles.push(...getAddonAgentFiles(srcRoot));
 
     if (shouldDeployCommands || commandsOnly) {
-      const writingCommandsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'commands');
-      commandFiles.push(...listMdFiles(writingCommandsDir));
+      commandFiles.push(...getAddonCommandFiles(srcRoot));
     }
   }
 
+  // Frameworks
   if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
     const sdlcAgentsDir = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'agents');
     agentFiles.push(...listMdFiles(sdlcAgentsDir));
@@ -348,16 +349,6 @@ export async function deploy(opts) {
     }
   }
 
-  if (mode === 'sdlc' || mode === 'all') {
-    const utilsAgentsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'agents');
-    agentFiles.push(...listMdFiles(utilsAgentsDir));
-
-    if (shouldDeployCommands || commandsOnly) {
-      const utilsCommandsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'commands');
-      commandFiles.push(...listMdFiles(utilsCommandsDir));
-    }
-  }
-
   // Deploy
   if (!commandsOnly) {
     console.log(`\nDeploying ${agentFiles.length} agents...`);

package/tools/agents/providers/windsurf.mjs

@@ -22,7 +22,9 @@ import {
   ensureDir,
   listMdFiles,
   listMdFilesRecursive,
-  initializeFrameworkWorkspace
+  initializeFrameworkWorkspace,
+  getAddonAgentFiles,
+  getAddonCommandFiles
 } from './base.mjs';
 
 // ============================================================================
@@ -400,30 +402,22 @@ export async function deploy(opts) {
   // Collect all agent files based on mode
   const allAgentFiles = [];
 
-  // Writing agents
-  if (mode === 'general' || mode === 'writing' || mode === 'both' || mode === 'all') {
-    const writingAgentsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'agents');
-    allAgentFiles.push(...listMdFiles(writingAgentsDir));
+  // All addons (dynamically discovered)
+  if (mode === 'general' || mode === 'writing' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+    allAgentFiles.push(...getAddonAgentFiles(srcRoot));
   }
 
-  // SDLC agents
+  // Frameworks
   if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
     const sdlcAgentsDir = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'agents');
     allAgentFiles.push(...listMdFiles(sdlcAgentsDir));
   }
 
-  // Marketing agents
   if (mode === 'marketing' || mode === 'all') {
     const marketingAgentsDir = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'media-marketing-kit', 'agents');
     allAgentFiles.push(...listMdFiles(marketingAgentsDir));
   }
 
-  // Utils addon agents
-  if (mode === 'sdlc' || mode === 'all') {
-    const utilsAgentsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'aiwg-utils', 'agents');
-    allAgentFiles.push(...listMdFiles(utilsAgentsDir));
-  }
-
   // Generate aggregated AGENTS.md
   if (allAgentFiles.length > 0 && !commandsOnly && !skillsOnly) {
     const agentsMdPath = path.join(target, 'AGENTS.md');
@@ -442,11 +436,12 @@ export async function deploy(opts) {
     // Collect command files based on mode
     const commandFiles = [];
 
-    if (mode === 'general' || mode === 'both' || mode === 'all') {
-      const writingCommandsDir = path.join(srcRoot, 'agentic', 'code', 'addons', 'writing-quality', 'commands');
-      commandFiles.push(...listMdFiles(writingCommandsDir));
+    // All addons (dynamically discovered)
+    if (mode === 'general' || mode === 'writing' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+      commandFiles.push(...getAddonCommandFiles(srcRoot));
     }
 
+    // Frameworks
     if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
       const sdlcCommandsDir = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'commands');
       commandFiles.push(...listMdFilesRecursive(sdlcCommandsDir));

package/tools/commands/deploy-prompts-codex.mjs

@@ -201,6 +201,22 @@ function getCommandDirectories(srcRoot, mode) {
     }
   }
 
+  // Addon commands (dynamically discovered)
+  if (mode === 'general' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+    const addonsRoot = path.join(srcRoot, 'agentic', 'code', 'addons');
+    if (fs.existsSync(addonsRoot)) {
+      const addonDirs = fs.readdirSync(addonsRoot, { withFileTypes: true })
+        .filter(e => e.isDirectory())
+        .map(e => path.join(addonsRoot, e.name, 'commands'));
+
+      for (const addonCommandsDir of addonDirs) {
+        if (fs.existsSync(addonCommandsDir)) {
+          dirs.push({ dir: addonCommandsDir, label: path.basename(path.dirname(addonCommandsDir)) });
+        }
+      }
+    }
+  }
+
   // SDLC framework commands
   if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
     const sdlcCommandsDir = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'commands');

package/tools/rules/deploy-rules-cursor.mjs

@@ -241,6 +241,22 @@ function getCommandDirectories(srcRoot, mode) {
     }
   }
 
+  // Addon commands (dynamically discovered)
+  if (mode === 'general' || mode === 'sdlc' || mode === 'both' || mode === 'all') {
+    const addonsRoot = path.join(srcRoot, 'agentic', 'code', 'addons');
+    if (fs.existsSync(addonsRoot)) {
+      const addonDirs = fs.readdirSync(addonsRoot, { withFileTypes: true })
+        .filter(e => e.isDirectory())
+        .map(e => path.join(addonsRoot, e.name, 'commands'));
+
+      for (const addonCommandsDir of addonDirs) {
+        if (fs.existsSync(addonCommandsDir)) {
+          dirs.push({ dir: addonCommandsDir, label: path.basename(path.dirname(addonCommandsDir)) });
+        }
+      }
+    }
+  }
+
   // SDLC framework commands
   if (mode === 'sdlc' || mode === 'both' || mode === 'all') {
     const sdlcCommandsDir = path.join(srcRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'commands');

package/tools/warp/setup-warp.mjs

@@ -279,6 +279,21 @@ function generateAIWGContent(aiwgRoot, mode) {
       agentPaths.push(...listMdFiles(generalAgents));
     }
   }
+
+  // Addon agents (dynamically discovered)
+  const addonsRoot = path.join(aiwgRoot, 'agentic', 'code', 'addons');
+  if (fs.existsSync(addonsRoot)) {
+    const addonDirs = fs.readdirSync(addonsRoot, { withFileTypes: true })
+      .filter(e => e.isDirectory())
+      .map(e => path.join(addonsRoot, e.name, 'agents'));
+
+    for (const addonAgentsDir of addonDirs) {
+      if (fs.existsSync(addonAgentsDir)) {
+        agentPaths.push(...listMdFiles(addonAgentsDir));
+      }
+    }
+  }
+
   if (mode === 'sdlc' || mode === 'both') {
     const sdlcAgents = path.join(aiwgRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'agents');
     if (fs.existsSync(sdlcAgents)) {
@@ -304,6 +319,20 @@ function generateAIWGContent(aiwgRoot, mode) {
       commandPaths.push(...listMdFiles(generalCommands));
     }
   }
+
+  // Addon commands (dynamically discovered)
+  if (fs.existsSync(addonsRoot)) {
+    const addonCommandDirs = fs.readdirSync(addonsRoot, { withFileTypes: true })
+      .filter(e => e.isDirectory())
+      .map(e => path.join(addonsRoot, e.name, 'commands'));
+
+    for (const addonCommandsDir of addonCommandDirs) {
+      if (fs.existsSync(addonCommandsDir)) {
+        commandPaths.push(...listMdFiles(addonCommandsDir));
+      }
+    }
+  }
+
   if (mode === 'sdlc' || mode === 'both') {
     const sdlcCommands = path.join(aiwgRoot, 'agentic', 'code', 'frameworks', 'sdlc-complete', 'commands');
     if (fs.existsSync(sdlcCommands)) {