aiwg 2026.7.2 → 2026.7.3

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 (84) hide show
  1. package/CLAUDE.md +5 -4
  2. package/README.md +7 -6
  3. package/agentic/code/addons/aiwg-utils/agents/aiwg-steward.md +2 -2
  4. package/agentic/code/addons/aiwg-utils/skills/aiwg-language-map/SKILL.md +2 -2
  5. package/agentic/code/addons/aiwg-utils/skills/aiwg-status/SKILL.md +1 -1
  6. package/agentic/code/addons/aiwg-utils/skills/aiwg-utils-quickref/SKILL.md +1 -1
  7. package/agentic/code/addons/aiwg-utils/skills/index/SKILL.md +12 -13
  8. package/agentic/code/addons/aiwg-utils/skills/install-plugin/SKILL.md +7 -7
  9. package/agentic/code/addons/aiwg-utils/skills/package-all-plugins/SKILL.md +4 -4
  10. package/agentic/code/addons/aiwg-utils/skills/package-plugin/SKILL.md +7 -7
  11. package/agentic/code/addons/aiwg-utils/skills/plugin-status/SKILL.md +4 -4
  12. package/agentic/code/addons/aiwg-utils/skills/steward/SKILL.md +2 -2
  13. package/agentic/code/addons/aiwg-utils/skills/uninstall-plugin/SKILL.md +7 -7
  14. package/agentic/code/agents/personas/aiwg-steward.md +2 -2
  15. package/agentic/code/frameworks/knowledge-base/skills/kb-ingest/SKILL.md +3 -3
  16. package/agentic/code/frameworks/knowledge-base/skills/knowledge-base-quickref/SKILL.md +3 -3
  17. package/agentic/code/frameworks/media-curator/docs/type-flexible-curation.md +3 -2
  18. package/agentic/code/frameworks/research-complete/skills/research-query/SKILL.md +6 -5
  19. package/agentic/code/frameworks/sdlc-complete/skills/artifact-lookup/SKILL.md +9 -9
  20. package/agentic/code/frameworks/sdlc-complete/skills/build-artifact-index/SKILL.md +5 -4
  21. package/agentic/code/frameworks/sdlc-complete/skills/flow-release/SKILL.md +9 -0
  22. package/agentic/code/frameworks/sdlc-complete/templates/project/AIWG-codex.md +1 -1
  23. package/agentic/code/frameworks/sdlc-complete/templates/project/AIWG-copilot.md +1 -1
  24. package/agentic/code/frameworks/sdlc-complete/templates/project/AIWG-cursor.md +1 -1
  25. package/agentic/code/frameworks/sdlc-complete/templates/project/AIWG-factory.md +1 -1
  26. package/agentic/code/frameworks/sdlc-complete/templates/project/AIWG-opencode.md +1 -1
  27. package/agentic/code/frameworks/sdlc-complete/templates/project/AIWG-sdlc-fragment.md +1 -2
  28. package/agentic/code/frameworks/sdlc-complete/templates/project/AIWG-warp.md +1 -1
  29. package/agentic/code/frameworks/sdlc-complete/templates/project/AIWG-windsurf.md +1 -1
  30. package/agentic/code/frameworks/sdlc-complete/templates/project/AIWG.md +1 -2
  31. package/agentic/code/plugins/codex-sdlc/skills/artifact-lookup/SKILL.md +9 -9
  32. package/agentic/code/plugins/codex-sdlc/skills/build-artifact-index/SKILL.md +5 -4
  33. package/agentic/code/plugins/codex-sdlc/skills/flow-release/SKILL.md +9 -0
  34. package/agentic/code/plugins/knowledge-base/skills/kb-ingest/SKILL.md +3 -3
  35. package/agentic/code/plugins/knowledge-base/skills/knowledge-base-quickref/SKILL.md +3 -3
  36. package/agentic/code/plugins/research/skills/research-query/SKILL.md +6 -5
  37. package/agentic/code/plugins/sdlc/skills/artifact-lookup/SKILL.md +9 -9
  38. package/agentic/code/plugins/sdlc/skills/build-artifact-index/SKILL.md +5 -4
  39. package/agentic/code/plugins/sdlc/skills/flow-release/SKILL.md +9 -0
  40. package/agentic/code/plugins/utils/agents/aiwg-steward.md +2 -2
  41. package/agentic/code/plugins/utils/skills/aiwg-language-map/SKILL.md +2 -2
  42. package/agentic/code/plugins/utils/skills/aiwg-status/SKILL.md +1 -1
  43. package/agentic/code/plugins/utils/skills/aiwg-utils-quickref/SKILL.md +1 -1
  44. package/agentic/code/plugins/utils/skills/index/SKILL.md +12 -13
  45. package/agentic/code/plugins/utils/skills/install-plugin/SKILL.md +7 -7
  46. package/agentic/code/plugins/utils/skills/package-all-plugins/SKILL.md +4 -4
  47. package/agentic/code/plugins/utils/skills/package-plugin/SKILL.md +7 -7
  48. package/agentic/code/plugins/utils/skills/plugin-status/SKILL.md +4 -4
  49. package/agentic/code/plugins/utils/skills/steward/SKILL.md +2 -2
  50. package/agentic/code/plugins/utils/skills/uninstall-plugin/SKILL.md +7 -7
  51. package/dist/src/artifacts/browser-export.js +3 -1
  52. package/dist/src/artifacts/cli.js +22 -19
  53. package/dist/src/artifacts/dep-graph.js +2 -2
  54. package/dist/src/artifacts/fortemi-core-query-adapter.js +45 -3
  55. package/dist/src/artifacts/graph-query.js +4 -4
  56. package/dist/src/artifacts/query-engine.js +91 -26
  57. package/dist/src/research/query-cli.js +4 -4
  58. package/docs/.public/blog/2026-6-aiwg-june-2026-report.png +0 -0
  59. package/docs/_manifest.json +8 -0
  60. package/docs/architecture/index-and-manifest-loading.md +2 -2
  61. package/docs/blog/2026-6-aiwg-june-2026-report.md +24 -10
  62. package/docs/cli-reference.md +39 -39
  63. package/docs/config.json +1 -0
  64. package/docs/configuration/aiwg-config.md +1 -1
  65. package/docs/customization/from-fork-to-project-local.md +3 -2
  66. package/docs/customization/project-local-lifecycle.md +4 -3
  67. package/docs/fortemi-core-prebuilt-indices.md +2 -2
  68. package/docs/frameworks/media-curator/type-flexible-curation.md +3 -2
  69. package/docs/getting-started/README.md +1 -1
  70. package/docs/integrations/claude-code-quickstart.md +2 -2
  71. package/docs/integrations/fortemi-index-export.md +66 -65
  72. package/docs/plugin-marketplace-guide.md +5 -5
  73. package/docs/project-local/overview.md +3 -2
  74. package/docs/quickstart-mmk.md +1 -1
  75. package/docs/quickstart-sdlc.md +1 -1
  76. package/docs/releases/v2026.7.1-announcement.md +38 -42
  77. package/docs/releases/v2026.7.3-announcement.md +33 -0
  78. package/docs/repo-layout-plugin-sources.md +19 -16
  79. package/docs/storage/backends/fortemi.md +8 -6
  80. package/docs/storage/migration.md +1 -1
  81. package/docs/storage/overview.md +1 -1
  82. package/package.json +3 -2
  83. package/prebuilt/fortemi-core/framework/aiwg-fortemi-index-v2.json +1 -1
  84. package/prebuilt/fortemi-core/framework/manifest.json +2 -2
package/CLAUDE.md CHANGED
@@ -111,13 +111,13 @@ All 10 providers receive all 4 artifact types (agents, commands, skills, rules).
111
111
 
112
112
  ## Installation
113
113
 
114
- ### Claude Code Plugin (Recommended)
114
+ ### Claude Code Marketplace (Recommended)
115
115
 
116
116
  ```bash
117
117
  # Add AIWG marketplace (one-time)
118
118
  /plugin marketplace add jmagly/ai-writing-guide
119
119
 
120
- # Install plugins (13 published in marketplace.json)
120
+ # Install marketplace packages (13 published in marketplace.json)
121
121
  /plugin install sdlc@aiwg # Full SDLC framework
122
122
  /plugin install marketing@aiwg # Marketing operations framework
123
123
  /plugin install forensics@aiwg # Digital forensics & incident response
@@ -221,7 +221,7 @@ AIWG uses a unified extension system for all extension types:
221
221
  | **Catalog** (1) | catalog (list, info, search) |
222
222
  | **Toolsmith** (1) | runtime-info |
223
223
  | **Utility** (3) | prefill-cards, contribute-start, validate-metadata |
224
- | **Plugin** (5) | install-plugin, uninstall-plugin, plugin-status, package-plugin, package-all-plugins |
224
+ | **Marketplace packaging** (5) | install-plugin, uninstall-plugin, plugin-status, package-plugin, package-all-plugins |
225
225
  | **Scaffolding** (7) | add-agent, add-command, add-skill, add-template, scaffold-addon, scaffold-extension, scaffold-framework |
226
226
  | **Orchestration** (1) | mc (start, dispatch, status, watch, abort, pause, resume, stop, list) |
227
227
  | **Ralph** (8) | ralph, ralph-status, ralph-abort, ralph-resume, ralph-attach, agent-loop-ext, ralph-memory, ralph-config |
@@ -249,10 +249,11 @@ aiwg list # List installed frameworks
249
249
  aiwg remove sdlc # Remove framework
250
250
  aiwg remove my-bundle # Remove project-local bundle (source preserved; --force, --dry-run supported)
251
251
 
252
- # Project-local bundles (.aiwg/{extensions,addons,frameworks,plugins}/<name>/)
252
+ # Project-local content bundles (.aiwg/{extensions,addons,frameworks}/<name>/)
253
253
  aiwg new-bundle my-rules --type extension --starter rule # Scaffold project-local bundle
254
254
  aiwg new-extension my-ext # Alias: --type extension implied
255
255
  aiwg new-addon my-pack # Alias: --type addon implied
256
+ aiwg new-plugin my-wrapper # Marketplace delivery wrapper only
256
257
  aiwg use my-rules # Deploy a single project-local bundle
257
258
  aiwg list --project-local # Show project-local inventory
258
259
  aiwg doctor --project-local # Health check (counts, validation, drift, matrix)
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  **Multi-agent AI framework for Claude Code, Copilot, Cursor, Warp, and 6 more platforms**
8
8
 
9
- 200+ agents, 67+ CLI commands, 400+ deployable agent/skill/command/rule artifacts, 8 core frameworks + training marketplace plugin, 27 addons. SDLC workflows, digital forensics, research management, marketing operations, media curation, ops infrastructure, knowledge base, and fine-tuning dataset curation — all deployable with one command.
9
+ 200+ agents, 67+ CLI commands, 400+ deployable agent/skill/command/rule artifacts, 8 core frameworks, 27 addons, and a training marketplace package. SDLC workflows, digital forensics, research management, marketing operations, media curation, ops infrastructure, knowledge base, and fine-tuning dataset curation — all deployable with one command.
10
10
 
11
11
  ```bash
12
12
  npm i -g aiwg # install globally
@@ -453,7 +453,7 @@ The orchestration pattern: **Primary Author → Parallel Reviewers → Synthesiz
453
453
  - **35 enforcement rules** — anti-laziness detection, token security, citation integrity, executable feedback, failure mitigation across 6 LLM archetypes
454
454
  - **334 artifact templates** — progressive disclosure templates for requirements, architecture, testing, security, deployment, and more
455
455
  - **8 platform support** — deploy to Claude Code, Copilot, Cursor, Warp, Factory AI, OpenCode, Codex, and Windsurf
456
- - **8 core frameworks + training marketplace plugin** — SDLC, Digital Forensics, Marketing Operations, Research Management, Media Curation, Ops Infrastructure, Knowledge Base, Security Engineering, plus [`aiwg-training`](https://github.com/jmagly/aiwg-training) for fine-tuning dataset curation (corpus-to-dataset pipeline with DPO/KTO/ORPO/SimPO export)
456
+ - **8 core frameworks + training marketplace package** — SDLC, Digital Forensics, Marketing Operations, Research Management, Media Curation, Ops Infrastructure, Knowledge Base, Security Engineering, plus [`aiwg-training`](https://github.com/jmagly/aiwg-training) for fine-tuning dataset curation (corpus-to-dataset pipeline with DPO/KTO/ORPO/SimPO export)
457
457
  - **27 addons** — semantic-memory kernel, llm-wiki (Obsidian-native knowledge base), RLM recursive decomposition, voice profiles, testing quality, mutation testing, UAT automation, and more
458
458
  - **Agent Loop** — iterative task execution with automatic error recovery and crash resilience (6-8 hour sessions)
459
459
  - **RLM addon** — recursive context decomposition for processing 10M+ tokens via sub-agent delegation
@@ -503,8 +503,9 @@ aiwg doctor
503
503
  ### Customize Without Forking
504
504
 
505
505
  Author project-specific rules, skills, agents, addons, or frameworks
506
- directly under `.aiwg/{extensions,addons,frameworks,plugins}/<name>/`.
507
- No fork, no rebuild. Discovered automatically by `aiwg use`.
506
+ directly under `.aiwg/{extensions,addons,frameworks}/<name>/`. Use
507
+ `.aiwg/plugins/<name>/` only when you are wrapping a bundle for marketplace
508
+ delivery. No fork, no rebuild. Discovered automatically by `aiwg use`.
508
509
 
509
510
  ```bash
510
511
  aiwg new-bundle my-team-rules --type extension --starter rule
@@ -519,7 +520,7 @@ The bundle is **byte-identical** in shape to its upstream form, so
519
520
  [customization guide](docs/customization/README.md) for the three paths
520
521
  (project-local, fork, corpus).
521
522
 
522
- ### Claude Code Plugin (Alternative)
523
+ ### Claude Code Marketplace (Alternative)
523
524
 
524
525
  ```bash
525
526
  /plugin marketplace add jmagly/ai-writing-guide
@@ -1275,7 +1276,7 @@ All 8 platforms receive agents, commands, skills, and rules. Deployment adapts t
1275
1276
  | **Workspace** | `status`, `migrate-workspace`, `rollback-workspace` | Workspace health and migration |
1276
1277
  | **MCP** | `mcp serve`, `mcp install`, `mcp info` | Model Context Protocol server |
1277
1278
  | **Catalog** | `catalog list`, `catalog info`, `catalog search` | Browse available extensions |
1278
- | **Plugins** | `install-plugin`, `uninstall-plugin`, `plugin-status`, `package-plugin`, `package-all-plugins` | Plugin management |
1279
+ | **Marketplace packaging** | `install-plugin`, `uninstall-plugin`, `plugin-status`, `package-plugin`, `package-all-plugins` | Install and package delivery wrappers |
1279
1280
  | **Scaffolding** | `add-agent`, `add-command`, `add-skill`, `add-template`, `scaffold-addon`, `scaffold-extension`, `scaffold-framework` | Create new extensions |
1280
1281
  | **Ralph** | `ralph`, `ralph-status`, `ralph-abort`, `ralph-resume`, `ralph-external`, `ralph-memory`, `ralph-config` | Iterative execution engine |
1281
1282
  | **Metrics** | `cost-report`, `cost-history`, `metrics-tokens` | Token usage and cost tracking |
@@ -58,9 +58,9 @@ Route these intents directly:
58
58
 
59
59
  | User intent | Primary route | Notes |
60
60
  |---|---|---|
61
- | Create a repo/project-level skill | `aiwg new-bundle <name> --starter skill` or `aiwg new-extension <name> --starter skill` | Creates source under `.aiwg/{extensions,addons,frameworks,plugins}/<name>/`; deploy with `aiwg use <name>`. |
61
+ | Create a repo/project-level skill | `aiwg new-bundle <name> --starter skill` or `aiwg new-extension <name> --starter skill` | Creates content source under `.aiwg/{extensions,addons,frameworks}/<name>/`; deploy with `aiwg use <name>`. |
62
62
  | Create a project-level agent | `aiwg new-bundle <name> --starter agent` or SkillSmith/AgentSmith when generating from a prompt | Use project-local bundle layout so the artifact is versioned with the repo. |
63
- | Choose extension/addon/framework/plugin shape | `aiwg discover "project-local customization"` and docs/customization quickstart | Extensions are the usual smallest local customization; addons/frameworks are heavier. |
63
+ | Choose extension/addon/framework shape | `aiwg discover "project-local customization"` and docs/customization quickstart | Extensions are the usual smallest local customization; addons/frameworks are heavier. Plugins are marketplace delivery wrappers. |
64
64
  | Make an agent invoke a custom skill | Create the skill in a project-local bundle, run `aiwg use <name>`, then reload the provider session | Session reload rules still apply. |
65
65
 
66
66
  Canonical docs: `docs/customization/project-local-quickstart.md`, `docs/project-local/overview.md`, and `docs/project-local/manifest-reference.md`. Mention that project-local artifacts are trusted repo code and should be reviewed before deploy.
@@ -305,14 +305,14 @@ When you don't know which domain a need falls into:
305
305
 
306
306
  ## Project-local extensions (pilot → promote)
307
307
 
308
- Addons and extensions don't all have to come from upstream. Users can pilot their own bundles per-project under `.aiwg/{extensions,addons,frameworks,plugins}/<name>/`, validate them, then promote to upstream when mature. Curated phrases:
308
+ Addons, extensions, and frameworks don't all have to come from upstream. Users can pilot content bundles per-project under `.aiwg/{extensions,addons,frameworks}/<name>/`, validate them, then promote to upstream when mature. Use `.aiwg/plugins/<name>/` only when wrapping a bundle for marketplace delivery. Curated phrases:
309
309
 
310
310
  ```bash
311
311
  aiwg new-bundle <name> # scaffold; auto-builds project graph
312
312
  aiwg new-extension <name> --starter rule # extension with starter rule
313
313
  aiwg new-addon <name> # addon
314
314
  aiwg new-framework <name> # framework
315
- aiwg new-plugin <name> # plugin
315
+ aiwg new-plugin <name> # marketplace delivery wrapper
316
316
  aiwg new-bundle <name> --dry-run # preview without writing
317
317
  aiwg list --project-local # inventory + validation status
318
318
  aiwg doctor --project-local # health check (counts, drift, shadows)
@@ -52,7 +52,7 @@ When triggered:
52
52
  3. **What the dashboard shows**:
53
53
  - Installed frameworks and addons from `.aiwg/frameworks/registry.json` (name, version, install date)
54
54
  - Deployed provider artifact directories (e.g., `.claude/`, `.github/`, `.cursor/`)
55
- - Project-local bundles under `.aiwg/{extensions,addons,frameworks,plugins}/`
55
+ - Project-local content bundles under `.aiwg/{extensions,addons,frameworks}/` and delivery wrappers under `.aiwg/plugins/`
56
56
  - `.aiwg/` artifact counts per subdirectory (`requirements/`: 4 files, `architecture/`: 2 files, etc.)
57
57
  - Last sync timestamp
58
58
  - Overall health indicator (OK / WARN / ERROR)
@@ -204,7 +204,7 @@ aiwg discover "scaffold a project" # → new-project (+ new-bundle f
204
204
 
205
205
  ### Project-local extensions (pilot → promote)
206
206
 
207
- AIWG supports authoring rules/skills/agents per-project under `.aiwg/{extensions,addons,frameworks,plugins}/<name>/` — pilot here, promote upstream when mature.
207
+ AIWG supports authoring rules/skills/agents per-project under `.aiwg/{extensions,addons,frameworks}/<name>/` — pilot here, promote upstream when mature. Use `.aiwg/plugins/<name>/` only for marketplace delivery wrappers.
208
208
 
209
209
  ```bash
210
210
  aiwg new-bundle <name> # scaffold; auto-builds project graph
@@ -23,7 +23,7 @@ Alternate expressions and non-obvious activations (primary phrases are matched a
23
23
  - "how many artifacts are indexed" → stats
24
24
  - "is the index healthy" → status
25
25
  - "export the index for Fortemi" → export --format fortemi
26
- - "sync the Fortemi cache" → sync --backend fortemi-core
26
+ - "sync the Fortemi cache" → sync
27
27
  - "refresh the index" → build --force
28
28
 
29
29
  ## Trigger Patterns Reference
@@ -41,7 +41,7 @@ Alternate expressions and non-obvious activations (primary phrases are matched a
41
41
  | Health/status | "is the index stale?" | Run `aiwg index status --json` |
42
42
  | JSON output | "get index stats as JSON" | Run `aiwg index stats --json` |
43
43
  | Fortemi export | "export this index for Fortemi" | Run `aiwg index export --format fortemi --schema-version v2` |
44
- | Fortemi cache | "sync the Fortemi Core index" | Run `aiwg index sync --backend fortemi-core` |
44
+ | Fortemi cache | "sync the Fortemi Core index" | Run `aiwg index sync` |
45
45
 
46
46
  > **`.aiwg/.index/` is a regenerable build artifact, not committed.** It is gitignored by default (`aiwg use` / `aiwg regenerate` / scaffolding add it to `.gitignore`), so a fresh clone has no index — `aiwg index build --all` is the standard bootstrap. `aiwg doctor` flags a missing index (`info`, when an `index` block is declared in `.aiwg/aiwg.config` — the canonical home as of #1491 — or legacy `.aiwg/config.yaml`) or a stale one (`warn`, when recorded source files changed) and points back to `aiwg index build`.
47
47
 
@@ -69,12 +69,12 @@ When triggered:
69
69
  # Machine-readable search results
70
70
  aiwg index query "<text>" --json
71
71
 
72
- # Opt-in Fortemi Core static-cache query
73
- aiwg index query "<text>" --backend fortemi-core --json
72
+ # default Fortemi Core static-cache query
73
+ aiwg index query "<text>" --json
74
74
 
75
75
  # Fortemi static semantic and filtered hybrid query modes
76
- aiwg index query "<text>" --semantic --backend fortemi-core --json
77
- aiwg index query "<text>" --hybrid --backend fortemi-core --type adr --tags search --json
76
+ aiwg index query "<text>" --semantic --json
77
+ aiwg index query "<text>" --hybrid --type adr --tags search --json
78
78
 
79
79
  # Show dependency graph for an artifact
80
80
  aiwg index deps <artifact-path>
@@ -95,20 +95,19 @@ When triggered:
95
95
  # Health/status, including optional Fortemi Core cache state
96
96
  aiwg index status --json
97
97
 
98
- # Export and sync the opt-in Fortemi Core static cache
98
+ # Export and sync the default Fortemi Core static cache
99
99
  aiwg index export --format fortemi --schema-version v2
100
- aiwg index sync --backend fortemi-core
100
+ aiwg index sync
101
101
  ```
102
102
 
103
103
  3. **Report the result** — surface the relevant matches, dependencies, or counts.
104
104
 
105
105
  ### Fortemi Core Backend
106
106
 
107
- The local `.aiwg/.index` backend remains the default. Use
108
- `--backend fortemi-core` only when the project has already run
109
- `aiwg index sync --backend fortemi-core`. If the Fortemi cache is missing or
110
- stale, rerun the same command without `--backend fortemi-core` to fall back to
111
- the local index. A valid synced Fortemi cache with zero items is not stale:
107
+ Fortemi Core is the default artifact search backend after `aiwg index sync`.
108
+ Use `--backend local` only for the legacy local fallback during the phase-out
109
+ window. If the Fortemi cache is missing or stale, run `aiwg index sync`.
110
+ A valid synced Fortemi cache with zero items is not stale:
112
111
  query/fulltext return empty results, discover reports a Fortemi static-cache
113
112
  no-match hint, and show does not fall back to the local AIWG corpus when the
114
113
  Fortemi backend was explicit.
@@ -2,12 +2,12 @@
2
2
  namespace: aiwg
3
3
  name: install-plugin
4
4
  platforms: [all]
5
- description: Install plugins into Claude Code from the AIWG marketplace with registry lookup, download, and local deployment
5
+ description: Install Claude Code marketplace plugins with registry lookup, download, and local deployment
6
6
  ---
7
7
 
8
8
  # Install Plugin
9
9
 
10
- You install a plugin into Claude Code from the AIWG marketplace. Plugins are pre-packaged bundles of agents, skills, commands, and rules. You handle registry lookup, download, and local deployment.
10
+ You install a Claude Code marketplace plugin. In AIWG vocabulary, a plugin is a delivery wrapper around an extension, addon, or framework, not a separate content type. You handle registry lookup, download, and local deployment.
11
11
 
12
12
  ## Triggers
13
13
 
@@ -57,11 +57,11 @@ When triggered:
57
57
  aiwg install-plugin sdlc@aiwg --force
58
58
  ```
59
59
 
60
- 3. **Report the result** — confirm which agents, skills, commands, and rules were installed and where.
60
+ 3. **Report the result** — name the installed marketplace wrapper and confirm which agents, skills, commands, and rules were deployed and where.
61
61
 
62
- ## Available Plugins (AIWG Marketplace)
62
+ ## Available Marketplace Packages
63
63
 
64
- | Plugin | Contents | Use Case |
64
+ | Package | Payload | Use Case |
65
65
  |--------|----------|----------|
66
66
  | `sdlc@aiwg` | 58 agents, 42 commands, SDLC workflows | Full software development lifecycle |
67
67
  | `voice@aiwg` | Voice profiles, soul system | Content style and persona management |
@@ -70,12 +70,12 @@ When triggered:
70
70
 
71
71
  ## What Happens on Install
72
72
 
73
- 1. Plugin manifest fetched from marketplace
73
+ 1. Delivery manifest fetched from marketplace
74
74
  2. Agents deployed to `.claude/agents/`
75
75
  3. Commands deployed to `.claude/commands/`
76
76
  4. Skills deployed to `.claude/skills/`
77
77
  5. Rules deployed to `.claude/rules/`
78
- 6. Plugin registered in local plugin registry
78
+ 6. Delivery wrapper registered in local plugin registry
79
79
 
80
80
  ## Examples
81
81
 
@@ -2,12 +2,12 @@
2
2
  namespace: aiwg
3
3
  name: package-all-plugins
4
4
  platforms: [all]
5
- description: Batch package every AIWG/Codex plugin in the workspace into distributable plugin archives — runs package-plugin for all plugins at once
5
+ description: Batch package every AIWG/Codex marketplace wrapper in the workspace into distributable plugin archives — runs package-plugin for all wrappers at once
6
6
  ---
7
7
 
8
8
  # Package All Plugins
9
9
 
10
- You run `package-plugin` for every plugin in the workspace in a single batch operation. This is **plugin packaging** — it produces AIWG/Codex plugin archives. It is **not** native/language-toolchain release packaging (Rust crates, `.deb`/`.rpm`, container images, GHCR, or release-asset checksums). For native or full release-pipeline work use `flow-release` / `release-publication-verify`, not this skill.
10
+ You run `package-plugin` for every marketplace wrapper in the workspace in a single batch operation. This is **plugin packaging** — it produces AIWG/Codex plugin archives that wrap extension, addon, or framework payloads. It is **not** native/language-toolchain release packaging (Rust crates, `.deb`/`.rpm`, container images, GHCR, or release-asset checksums). For native or full release-pipeline work use `flow-release` / `release-publication-verify`, not this skill.
11
11
 
12
12
  ## Triggers
13
13
 
@@ -61,7 +61,7 @@ When triggered:
61
61
  aiwg package-all-plugins --bump patch
62
62
  ```
63
63
 
64
- 3. **Report the result** — list each plugin with its status (packaged, failed, skipped), total count, and any errors.
64
+ 3. **Report the result** — list each marketplace wrapper with its status (packaged, failed, skipped), total count, and any errors.
65
65
 
66
66
  ## Output Format
67
67
 
@@ -83,7 +83,7 @@ By default (`--abort-on-error`), the batch stops at the first failure and report
83
83
 
84
84
  ## Relationship to `package-plugin`
85
85
 
86
- `package-all-plugins` is a thin loop over `package-plugin`. Each plugin runs through the same validation and packaging logic as a single `package-plugin` call. Flags like `--dry-run`, `--publish`, and `--bump` are forwarded to each plugin invocation.
86
+ `package-all-plugins` is a thin loop over `package-plugin`. Each marketplace wrapper runs through the same validation and packaging logic as a single `package-plugin` call. Flags like `--dry-run`, `--publish`, and `--bump` are forwarded to each invocation.
87
87
 
88
88
  ## Examples
89
89
 
@@ -2,12 +2,12 @@
2
2
  namespace: aiwg
3
3
  name: package-plugin
4
4
  platforms: [all]
5
- description: Bundle a single plugin into a distributable marketplace archive, validating metadata and optionally publishing
5
+ description: Bundle a single marketplace delivery wrapper into a distributable archive, validating metadata and optionally publishing
6
6
  ---
7
7
 
8
8
  # Package Plugin
9
9
 
10
- You bundle a single plugin into a distributable package for the AIWG marketplace. You validate metadata, create the package archive, and optionally publish to the registry.
10
+ You bundle a single marketplace delivery wrapper for the AIWG marketplace. In AIWG vocabulary, the plugin layer packages an extension, addon, or framework payload for distribution. You validate metadata, create the package archive, and optionally publish to the registry.
11
11
 
12
12
  ## Triggers
13
13
 
@@ -34,7 +34,7 @@ Alternate expressions and non-obvious activations (primary phrases are matched a
34
34
  When triggered:
35
35
 
36
36
  1. **Extract intent**:
37
- - Which plugin is being packaged?
37
+ - Which delivery wrapper is being packaged?
38
38
  - Should it be published after packaging, or just archived locally?
39
39
  - Is a version bump needed?
40
40
  - Is this a validation dry run?
@@ -42,7 +42,7 @@ When triggered:
42
42
  2. **Run the appropriate command**:
43
43
 
44
44
  ```bash
45
- # Package a plugin (creates archive, no publish)
45
+ # Package a marketplace wrapper (creates archive, no publish)
46
46
  aiwg package-plugin sdlc
47
47
  aiwg package-plugin voice
48
48
  aiwg package-plugin marketing
@@ -65,7 +65,7 @@ When triggered:
65
65
 
66
66
  ## What the Package Contains
67
67
 
68
- A plugin package archive (`.aiwg-plugin.tar.gz`) includes:
68
+ A plugin package archive (`.aiwg-plugin.tar.gz`) is a delivery wrapper. It includes the manifest plus the payload files being distributed:
69
69
 
70
70
  | Contents | Path in Archive |
71
71
  |----------|----------------|
@@ -73,7 +73,7 @@ A plugin package archive (`.aiwg-plugin.tar.gz`) includes:
73
73
  | Command definitions | `commands/` |
74
74
  | Skill definitions | `skills/` |
75
75
  | Rule definitions | `rules/` |
76
- | Plugin manifest | `plugin.json` |
76
+ | Delivery manifest | `plugin.json` |
77
77
  | Changelog | `CHANGELOG.md` (if present) |
78
78
 
79
79
  Files excluded from packages: `.aiwg/working/`, test fixtures, development-only configs.
@@ -84,7 +84,7 @@ Before creating the archive, the command automatically runs:
84
84
 
85
85
  1. `aiwg validate-metadata` — all extension definitions must pass
86
86
  2. Version format check — must be valid CalVer
87
- 3. Manifest completeness — `id`, `name`, `description`, `version` required
87
+ 3. Delivery manifest completeness — `id`, `name`, `description`, `version` required
88
88
 
89
89
  Packaging fails if any validation step fails.
90
90
 
@@ -2,12 +2,12 @@
2
2
  namespace: aiwg
3
3
  name: plugin-status
4
4
  platforms: [all]
5
- description: List installed Claude Code plugins with version, install date, and enabled status
5
+ description: List installed Claude Code marketplace plugins with version, install date, and enabled status
6
6
  ---
7
7
 
8
8
  # Plugin Status
9
9
 
10
- You list all installed Claude Code plugins with their version, install date, and enabled status.
10
+ You list installed Claude Code marketplace plugins with their version, install date, and enabled status. In AIWG vocabulary, these are delivery wrappers around extension, addon, or framework payloads.
11
11
 
12
12
  ## Triggers
13
13
 
@@ -55,12 +55,12 @@ When triggered:
55
55
  aiwg plugin-status --json
56
56
  ```
57
57
 
58
- 3. **Report the result** — show plugin name, version, install date, enabled status, and update availability.
58
+ 3. **Report the result** — show package name, version, install date, enabled status, and update availability.
59
59
 
60
60
  ## Output Format
61
61
 
62
62
  ```
63
- Installed Plugins (2)
63
+ Installed Marketplace Packages (2)
64
64
 
65
65
  sdlc@aiwg
66
66
  Version: 2026.3.15
@@ -80,9 +80,9 @@ Route these intents directly:
80
80
 
81
81
  | User intent | Primary route | Notes |
82
82
  |---|---|---|
83
- | Create a repo/project-level skill | `aiwg new-bundle <name> --starter skill` or `aiwg new-extension <name> --starter skill` | Creates source under `.aiwg/{extensions,addons,frameworks,plugins}/<name>/`; deploy with `aiwg use <name>`. |
83
+ | Create a repo/project-level skill | `aiwg new-bundle <name> --starter skill` or `aiwg new-extension <name> --starter skill` | Creates content source under `.aiwg/{extensions,addons,frameworks}/<name>/`; deploy with `aiwg use <name>`. |
84
84
  | Create a project-level agent | `aiwg new-bundle <name> --starter agent` or SkillSmith/AgentSmith when generating from a prompt | Use project-local bundle layout so the artifact is versioned with the repo. |
85
- | Choose extension/addon/framework/plugin shape | `aiwg discover "project-local customization"` and docs/customization quickstart | Extensions are the usual smallest local customization; addons/frameworks are heavier. |
85
+ | Choose extension/addon/framework shape | `aiwg discover "project-local customization"` and docs/customization quickstart | Extensions are the usual smallest local customization; addons/frameworks are heavier. Plugins are marketplace delivery wrappers. |
86
86
  | Make an agent invoke a custom skill | Create the skill in a project-local bundle, run `aiwg use <name>`, then reload the provider session | Session reload rules still apply. |
87
87
 
88
88
  Canonical docs: `docs/customization/project-local-quickstart.md`, `docs/project-local/overview.md`, and `docs/project-local/manifest-reference.md`. Mention that project-local artifacts are trusted repo code and should be reviewed before deploy.
@@ -2,12 +2,12 @@
2
2
  namespace: aiwg
3
3
  name: uninstall-plugin
4
4
  platforms: [all]
5
- description: Remove a previously installed Claude Code plugin and unregister it from the local plugin registry
5
+ description: Remove a previously installed Claude Code marketplace plugin and unregister it from the local plugin registry
6
6
  ---
7
7
 
8
8
  # Uninstall Plugin
9
9
 
10
- You remove a previously installed Claude Code plugin. You remove deployed plugin files and unregister the plugin from the local plugin registry.
10
+ You remove a previously installed Claude Code marketplace plugin. In AIWG vocabulary, the plugin is the delivery wrapper; the deployed files are its extension, addon, or framework payload. You remove deployed files and unregister the wrapper from the local plugin registry.
11
11
 
12
12
  ## Triggers
13
13
 
@@ -52,7 +52,7 @@ When triggered:
52
52
  aiwg uninstall-plugin sdlc@aiwg --keep-artifacts
53
53
  ```
54
54
 
55
- 3. **Report the result** — list what was removed (agents, commands, skills, rules) and confirm the plugin is deregistered.
55
+ 3. **Report the result** — list what was removed (agents, commands, skills, rules) and confirm the marketplace wrapper is deregistered.
56
56
 
57
57
  ## What Gets Removed
58
58
 
@@ -62,15 +62,15 @@ When triggered:
62
62
  | Command files | Files in `.claude/commands/` that belong to the plugin |
63
63
  | Skill files | Files in `.claude/skills/` that belong to the plugin |
64
64
  | Rule files | Files in `.claude/rules/` that belong to the plugin |
65
- | Registry entry | Plugin entry removed from local plugin registry |
65
+ | Registry entry | Delivery-wrapper entry removed from local plugin registry |
66
66
 
67
67
  ## What Is NOT Removed
68
68
 
69
69
  | Preserved | Reason |
70
70
  |-----------|--------|
71
- | `.aiwg/` project artifacts | These are your project output, not plugin files |
72
- | Shared skills used by other plugins | Removed only when last dependent plugin is removed |
73
- | Custom modifications to plugin files | Files modified after install are flagged, not deleted |
71
+ | `.aiwg/` project artifacts | These are your project output, not marketplace package files |
72
+ | Shared skills used by other packages | Removed only when the last dependent package is removed |
73
+ | Custom modifications to deployed package files | Files modified after install are flagged, not deleted |
74
74
 
75
75
  ## Examples
76
76
 
@@ -65,9 +65,9 @@ Route these intents directly:
65
65
 
66
66
  | User intent | Primary route | Notes |
67
67
  |---|---|---|
68
- | Create a repo/project-level skill | `aiwg new-bundle <name> --starter skill` or `aiwg new-extension <name> --starter skill` | Creates source under `.aiwg/{extensions,addons,frameworks,plugins}/<name>/`; deploy with `aiwg use <name>`. |
68
+ | Create a repo/project-level skill | `aiwg new-bundle <name> --starter skill` or `aiwg new-extension <name> --starter skill` | Creates content source under `.aiwg/{extensions,addons,frameworks}/<name>/`; deploy with `aiwg use <name>`. |
69
69
  | Create a project-level agent | `aiwg new-bundle <name> --starter agent` or SkillSmith/AgentSmith when generating from a prompt | Use project-local bundle layout so the artifact is versioned with the repo. |
70
- | Choose extension/addon/framework/plugin shape | `aiwg discover "project-local customization"` and docs/customization quickstart | Extensions are the usual smallest local customization; addons/frameworks are heavier. |
70
+ | Choose extension/addon/framework shape | `aiwg discover "project-local customization"` and docs/customization quickstart | Extensions are the usual smallest local customization; addons/frameworks are heavier. Plugins are marketplace delivery wrappers. |
71
71
  | Make an agent invoke a custom skill | Create the skill in a project-local bundle, run `aiwg use <name>`, then reload the provider session | Session reload rules still apply. |
72
72
 
73
73
  Canonical docs: `docs/customization/project-local-quickstart.md`, `docs/project-local/overview.md`, and `docs/project-local/manifest-reference.md`. Mention that project-local artifacts are trusted repo code and should be reviewed before deploy.
@@ -48,9 +48,9 @@ echo "# Foo" > "$KB_ROOT/entities/foo.md"
48
48
  ```
49
49
 
50
50
  Fortemi storage routing here is only a persistence backend choice. It is not the
51
- Fortemi Core index/search backend used by `aiwg index ... --backend
52
- fortemi-core`; KB pages join that preview only after the artifact graph has been
53
- built and synced with `aiwg index sync --backend fortemi-core`.
51
+ Fortemi Core index/search backend used by `aiwg index ...` by default;
52
+ `--backend local` selects the legacy fallback. KB pages join that search cache
53
+ only after the artifact graph has been built and synced with `aiwg index sync`.
54
54
 
55
55
  ### `--dry-run` (optional)
56
56
  Show what would be created or updated without writing files.
@@ -81,10 +81,10 @@ aiwg index neighbors --graph kb --node <slug> # traverse the KB graph
81
81
 
82
82
  KB ingest and health operations continue to use `resolveStorage('kb')` and the
83
83
  semantic-memory topology. Fortemi storage routing, when configured through
84
- `.aiwg/storage.config`, is separate from the opt-in Fortemi Core index/search
85
- backend. During the migration preview, use `--backend fortemi-core` only on
84
+ `.aiwg/storage.config`, is separate from the default Fortemi Core index/search
85
+ backend. During the migration preview, use `--backend local` for legacy fallback only on
86
86
  artifact graph commands such as `aiwg index neighbors --graph kb` after
87
- `aiwg index sync --backend fortemi-core`; do not treat `kb-ingest` or
87
+ `aiwg index sync`; do not treat `kb-ingest` or
88
88
  `kb-health` as Fortemi Core ingest commands.
89
89
 
90
90
  ## How knowledge-base composes with semantic-memory
@@ -44,10 +44,11 @@ tooling that fits the observed need:
44
44
  3. Wrap the tool as a skill or small helper that preserves the generic contract:
45
45
  input discovery/acquisition, quality assessment, metadata/provenance,
46
46
  integrity, and export or handoff.
47
- 4. Keep type-specific fields in that specialized skill or plugin. Do not move
47
+ 4. Keep type-specific fields in that specialized skill or bundle. Do not move
48
48
  them into the generic intake unless they apply across asset classes.
49
49
  5. If the workflow is project-specific or experimental, author it as a
50
- project-local bundle under `.aiwg/{extensions,addons,frameworks,plugins}/`
50
+ project-local content bundle under `.aiwg/{extensions,addons,frameworks}/`
51
+ or as a marketplace delivery wrapper under `.aiwg/plugins/`
51
52
  and promote upstream only after the contract stabilizes.
52
53
 
53
54
  ## Consequences
@@ -32,10 +32,11 @@ A natural language question to answer from the corpus.
32
32
  Search depth: `quick` (tag + title matching only) or `thorough` (full-text content search). Default: `thorough`.
33
33
 
34
34
  ### `--backend` (optional)
35
- Retrieval backend for the executable source-selection wrapper: `local` or `fortemi-core`. Default: `local`.
36
- When `fortemi-core` is explicit, the Fortemi static cache must already be
37
- synced with `aiwg index sync --backend fortemi-core`; missing, stale, or
38
- malformed caches fail with recovery guidance instead of falling back silently.
35
+ Retrieval backend for the executable source-selection wrapper: `fortemi-core` or `local`. Default: `fortemi-core`.
36
+ By default, research-query uses the Fortemi static cache after it is synced
37
+ with `aiwg index sync`; missing, stale, or malformed caches fail with recovery guidance
38
+ instead of falling back silently. Use `--backend local` only for the legacy
39
+ local corpus fallback.
39
40
 
40
41
  ### `--save` (optional)
41
42
  Save the synthesized answer as a new artifact in `.aiwg/research/synthesis/`.
@@ -174,7 +175,7 @@ confidence: moderate
174
175
  /research-query "prompt injection defenses" --depth quick
175
176
 
176
177
  # Use the Fortemi Core static cache for source selection
177
- aiwg research-query "prompt injection defenses" --backend fortemi-core --sources-only --json
178
+ aiwg research-query "prompt injection defenses" --sources-only --json
178
179
 
179
180
  # Just list matching sources
180
181
  /research-query "multi-agent orchestration" --sources-only
@@ -44,12 +44,12 @@ aiwg index query --tags security,auth --json
44
44
  # Combined filters
45
45
  aiwg index query "login" --type use-case --phase requirements --json
46
46
 
47
- # Opt-in Fortemi Core static cache
48
- aiwg index query "login" --backend fortemi-core --json
47
+ # default Fortemi Core static cache
48
+ aiwg index query "login" --json
49
49
 
50
50
  # Fortemi static semantic and filtered hybrid modes
51
- aiwg index query "login architecture" --semantic --backend fortemi-core --json
52
- aiwg index query "login architecture" --hybrid --backend fortemi-core --type adr --tags auth --json
51
+ aiwg index query "login architecture" --semantic --json
52
+ aiwg index query "login architecture" --hybrid --type adr --tags auth --json
53
53
  ```
54
54
 
55
55
  Parse the JSON output and present results in a readable summary:
@@ -72,9 +72,9 @@ aiwg index deps .aiwg/requirements/UC-001.md --direction upstream --json
72
72
  aiwg index deps .aiwg/requirements/UC-001.md --direction downstream --json
73
73
 
74
74
  # Fortemi Core static-cache traversal, when synced
75
- aiwg index deps .aiwg/requirements/UC-001.md --backend fortemi-core --json
76
- aiwg index neighbors --graph project --node UC-001 --backend fortemi-core --json
77
- aiwg index set --graph project --op intersection --node-a UC-001 --node-b ADR-001 --backend fortemi-core --json
75
+ aiwg index deps .aiwg/requirements/UC-001.md --json
76
+ aiwg index neighbors --graph project --node UC-001 --json
77
+ aiwg index set --graph project --op intersection --node-a UC-001 --node-b ADR-001 --json
78
78
  ```
79
79
 
80
80
  Present the dependency tree in a readable format:
@@ -152,8 +152,8 @@ Found 3 artifacts about "authentication":
152
152
 
153
153
  - Artifact index must exist (`aiwg index build` must have been run)
154
154
  - If index doesn't exist, offer to build it first
155
- - Fortemi Core lookups require `aiwg index sync --backend fortemi-core`; if the
156
- static cache is missing or stale, omit `--backend fortemi-core` and use the
155
+ - Fortemi Core lookups require `aiwg index sync`; if the
156
+ static cache is missing or stale, omit the legacy backend and use the
157
157
  local index
158
158
 
159
159
  ## References
@@ -36,16 +36,17 @@ aiwg index build --all
36
36
 
37
37
  Report what changed: new artifacts indexed, updated, unchanged, and removed counts.
38
38
 
39
- If the operator explicitly asks for Fortemi Core preview cache refresh after a
39
+ If the operator explicitly asks for Fortemi Core cache refresh after a
40
40
  successful build, run:
41
41
 
42
42
  ```bash
43
- aiwg index sync --backend fortemi-core
43
+ aiwg index sync
44
44
  aiwg index status --json
45
45
  ```
46
46
 
47
- Do not switch default behavior to Fortemi Core; the synced cache is opt-in and
48
- read only when commands pass `--backend fortemi-core`.
47
+ Fortemi Core is the default artifact search backend after sync. Keep the
48
+ legacy local backend available behind `--backend local` during the phase-out
49
+ window.
49
50
 
50
51
  ### Archived Query Answers
51
52
 
@@ -8,6 +8,11 @@ triggers:
8
8
  - "help me make the build or deployment path safer"
9
9
  - "start with pipeline safety or release readiness"
10
10
  - "pipeline safety ci"
11
+ - "release flow"
12
+ - "flow release"
13
+ - "flow-release"
14
+ - "run the release flow"
15
+ - "run release flow"
11
16
  commandHint:
12
17
  argumentHint: '<version> [--channel <stable|rc|beta|alpha|nightly>] [--dry-run] [--skip-uat] [--no-mirror] [--config <path>] [--guidance "text"]'
13
18
  allowedTools: 'Task, Read, Write, Edit, Bash, Glob, Grep, mcp__git-gitea__*'
@@ -47,6 +52,10 @@ When the user requests a release:
47
52
  ## Natural language triggers
48
53
 
49
54
  - "release v2026.5.2"
55
+ - "release flow"
56
+ - "flow release"
57
+ - "flow-release"
58
+ - "run the release flow"
50
59
  - "cut a release"
51
60
  - "promote to stable"
52
61
  - "ship it"
@@ -16,7 +16,7 @@ SDLC Complete — agents, commands, skills, and rules for full lifecycle coverag
16
16
 
17
17
  ## Customize Per Project
18
18
 
19
- Author project-specific rules, skills, agents, addons, or frameworks under `.aiwg/{extensions,addons,frameworks,plugins}/<name>/`. Discovered automatically by `aiwg use`.
19
+ Author project-specific content bundles under `.aiwg/{extensions,addons,frameworks}/<name>/`. Use `.aiwg/plugins/<name>/` only for marketplace delivery wrappers. Discovered automatically by `aiwg use`.
20
20
 
21
21
  ```bash
22
22
  aiwg new-bundle my-rules --type extension --starter rule
@@ -16,7 +16,7 @@ SDLC Complete — agents, commands, skills, and rules for full lifecycle coverag
16
16
 
17
17
  ## Customize Per Project
18
18
 
19
- Author project-specific rules, skills, agents, addons, or frameworks under `.aiwg/{extensions,addons,frameworks,plugins}/<name>/`. Discovered automatically by `aiwg use`.
19
+ Author project-specific content bundles under `.aiwg/{extensions,addons,frameworks}/<name>/`. Use `.aiwg/plugins/<name>/` only for marketplace delivery wrappers. Discovered automatically by `aiwg use`.
20
20
 
21
21
  ```bash
22
22
  aiwg new-bundle my-rules --type extension --starter rule