aiwg 2026.2.6 → 2026.2.8

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 (54) hide show
  1. package/CLAUDE.md +5 -1
  2. package/README.md +7 -2
  3. package/USAGE_GUIDE.md +6 -6
  4. package/agentic/code/frameworks/media-curator/README.md +138 -0
  5. package/agentic/code/frameworks/media-curator/agents/acquisition-manager.md +725 -0
  6. package/agentic/code/frameworks/media-curator/agents/completeness-tracker.md +519 -0
  7. package/agentic/code/frameworks/media-curator/agents/discography-analyst.md +419 -0
  8. package/agentic/code/frameworks/media-curator/agents/metadata-curator.md +333 -0
  9. package/agentic/code/frameworks/media-curator/agents/quality-assessor.md +338 -0
  10. package/agentic/code/frameworks/media-curator/agents/source-discoverer.md +441 -0
  11. package/agentic/code/frameworks/media-curator/commands/acquire.md +688 -0
  12. package/agentic/code/frameworks/media-curator/commands/analyze-artist.md +569 -0
  13. package/agentic/code/frameworks/media-curator/commands/assemble.md +390 -0
  14. package/agentic/code/frameworks/media-curator/commands/check-completeness.md +586 -0
  15. package/agentic/code/frameworks/media-curator/commands/curate.md +633 -0
  16. package/agentic/code/frameworks/media-curator/commands/export.md +497 -0
  17. package/agentic/code/frameworks/media-curator/commands/find-sources.md +544 -0
  18. package/agentic/code/frameworks/media-curator/commands/tag-collection.md +457 -0
  19. package/agentic/code/frameworks/media-curator/commands/verify-archive.md +427 -0
  20. package/agentic/code/frameworks/media-curator/config/defaults.yaml +77 -0
  21. package/agentic/code/frameworks/media-curator/docs/overview.md +119 -0
  22. package/agentic/code/frameworks/media-curator/docs/standards-reference.md +109 -0
  23. package/agentic/code/frameworks/media-curator/docs/user-guide.md +226 -0
  24. package/agentic/code/frameworks/media-curator/manifest.json +18 -0
  25. package/agentic/code/frameworks/media-curator/plan-act-curator.md +60 -0
  26. package/agentic/code/frameworks/media-curator/skills/archive-acquisition.md +942 -0
  27. package/agentic/code/frameworks/media-curator/skills/audio-extraction.md +149 -0
  28. package/agentic/code/frameworks/media-curator/skills/cover-art-embedding.md +643 -0
  29. package/agentic/code/frameworks/media-curator/skills/gap-documentation.md +487 -0
  30. package/agentic/code/frameworks/media-curator/skills/integrity-verification.md +673 -0
  31. package/agentic/code/frameworks/media-curator/skills/metadata-tagging.md +521 -0
  32. package/agentic/code/frameworks/media-curator/skills/provenance-tracking.md +174 -0
  33. package/agentic/code/frameworks/media-curator/skills/quality-filtering.md +544 -0
  34. package/agentic/code/frameworks/media-curator/skills/youtube-acquisition.md +829 -0
  35. package/agentic/code/frameworks/sdlc-complete/README.md +14 -9
  36. package/docs/development/aiwg-development-guide.md +1 -1
  37. package/docs/extensions/overview.md +1 -1
  38. package/docs/releases/v2026.2.7-announcement.md +144 -0
  39. package/docs/releases/v2026.2.8-announcement.md +82 -0
  40. package/package.json +1 -1
  41. package/src/cli/handlers/help.ts +14 -7
  42. package/src/cli/handlers/use.ts +4 -2
  43. package/src/cli/help-generator.ts +9 -5
  44. package/tools/agents/deploy-agents.mjs +18 -14
  45. package/tools/agents/providers/base.mjs +14 -0
  46. package/tools/agents/providers/claude.mjs +58 -0
  47. package/tools/agents/providers/codex.mjs +26 -0
  48. package/tools/agents/providers/copilot.mjs +58 -0
  49. package/tools/agents/providers/cursor.mjs +58 -0
  50. package/tools/agents/providers/factory.mjs +58 -0
  51. package/tools/agents/providers/opencode.mjs +58 -0
  52. package/tools/agents/providers/warp.mjs +58 -0
  53. package/tools/agents/providers/windsurf.mjs +64 -0
  54. /package/docs/releases/{v2026.01.3-announcement.md → v2026.1.3-announcement.md} +0 -0
package/CLAUDE.md CHANGED
@@ -23,7 +23,9 @@ aiwg use sdlc
23
23
  agentic/code/
24
24
  ├── frameworks/
25
25
  │ ├── sdlc-complete/ # Complete SDLC coverage
26
- └── media-marketing-kit/ # Full marketing operations
26
+ ├── media-marketing-kit/ # Full marketing operations
27
+ │ ├── media-curator/ # Media archive management
28
+ │ └── research-complete/ # Research workflow automation
27
29
  ├── addons/
28
30
  │ └── voice-framework/ # Voice profiles
29
31
  └── agents/ # Writing quality agents
@@ -260,6 +262,8 @@ aiwg reproducibility-validate # Validate workflow reproducibility
260
262
  | **Creating Extensions** | `@docs/extensions/creating-extensions.md` |
261
263
  | **Extension Types** | `@docs/extensions/extension-types.md` |
262
264
  | **SDLC Framework** | `@agentic/code/frameworks/sdlc-complete/README.md` |
265
+ | **Media Curator** | `@agentic/code/frameworks/media-curator/README.md` |
266
+ | **Research Complete** | `@agentic/code/frameworks/research-complete/README.md` |
263
267
  | **RLM Addon** | `@agentic/code/addons/rlm/README.md` |
264
268
  | **Daemon Mode** | `@docs/daemon-guide.md` |
265
269
  | **Messaging Integration** | `@docs/messaging-guide.md` |
package/README.md CHANGED
@@ -95,6 +95,7 @@ npm install -g aiwg
95
95
  cd your-project
96
96
  aiwg use sdlc # Full SDLC framework
97
97
  aiwg use marketing # Marketing framework
98
+ aiwg use media-curator # Media archive management
98
99
  aiwg use rlm # RLM addon (recursive context decomposition)
99
100
  aiwg use all # All frameworks
100
101
 
@@ -119,8 +120,10 @@ aiwg new my-project
119
120
 
120
121
  | Framework | What it does |
121
122
  |-----------|--------------|
122
- | **[SDLC Complete](agentic/code/frameworks/sdlc-complete/)** | Full software development lifecycle with agents, commands, templates, and multi-agent orchestration |
123
+ | **[SDLC Complete](agentic/code/frameworks/sdlc-complete/)** | Full software development lifecycle with 70+ agents, commands, templates, and multi-agent orchestration |
123
124
  | **[Media/Marketing Kit](agentic/code/frameworks/media-marketing-kit/)** | Complete marketing campaign management from strategy to analytics |
125
+ | **[Media Curator](agentic/code/frameworks/media-curator/)** | Intelligent media archive management — discography analysis, acquisition, quality filtering, metadata curation, and multi-platform export |
126
+ | **[Research Complete](agentic/code/frameworks/research-complete/)** | Academic research workflow — discovery, acquisition, RAG-based documentation, and citation management |
124
127
 
125
128
  ### Addons
126
129
 
@@ -228,6 +231,8 @@ See [Platform Integration Guides](docs/integrations/) for setup instructions.
228
231
 
229
232
  - **[SDLC Framework](agentic/code/frameworks/sdlc-complete/README.md)** — Agents, commands, templates, flows
230
233
  - **[Marketing Kit](agentic/code/frameworks/media-marketing-kit/README.md)** — Campaign lifecycle guide
234
+ - **[Media Curator](agentic/code/frameworks/media-curator/README.md)** — Media archive management
235
+ - **[Research Complete](agentic/code/frameworks/research-complete/README.md)** — Research workflows
231
236
  - **[Voice Framework](agentic/code/addons/voice-framework/)** — Voice profiles and skills
232
237
 
233
238
  ### Extension System
@@ -239,7 +244,7 @@ AIWG's unified extension system enables dynamic discovery, semantic search, and
239
244
  - **[Extension Types Reference](docs/extensions/extension-types.md)** — Complete type definitions
240
245
 
241
246
  **Extension types:**
242
- - **Agents** (35+): Specialized AI personas (API Designer, Test Engineer, Security Auditor)
247
+ - **Agents** (70+): Specialized AI personas (API Designer, Test Engineer, Security Auditor)
243
248
  - **Commands** (31): CLI and slash commands (`aiwg use sdlc`, `/mention-wire`)
244
249
  - **Skills**: Natural language workflows (project awareness, voice application)
245
250
  - **Hooks**: Lifecycle event handlers (pre-session, post-write)
package/USAGE_GUIDE.md CHANGED
@@ -11,7 +11,7 @@ Native Claude Code integration via the plugin marketplace:
11
11
  /plugin marketplace add jmagly/ai-writing-guide
12
12
 
13
13
  # Install plugins
14
- /plugin install sdlc@aiwg # 58 SDLC agents
14
+ /plugin install sdlc@aiwg # 70+ SDLC agents
15
15
  /plugin install marketing@aiwg # 37 marketing agents
16
16
  /plugin install utils@aiwg # Core utilities
17
17
  /plugin install voice@aiwg # Voice profiles
@@ -359,11 +359,11 @@ For complex writing tasks, leverage specialized agents:
359
359
  **Quick Start**:
360
360
 
361
361
  ```bash
362
- # Deploy general-purpose writing agents to your project
363
- aiwg -deploy-agents --mode general
362
+ # Deploy SDLC framework to your project
363
+ aiwg use sdlc
364
364
 
365
- # Or deploy all agents (general + SDLC)
366
- aiwg -deploy-agents --mode both
365
+ # Or deploy all frameworks
366
+ aiwg use all
367
367
  ```
368
368
 
369
369
  **Agent Invocation**:
@@ -389,7 +389,7 @@ aiwg -deploy-agents --mode both
389
389
 
390
390
  #### SDLC Framework Agents (`/agentic/code/frameworks/sdlc-complete/agents/`)
391
391
 
392
- 51 specialized agents covering all development lifecycle phases:
392
+ 70+ specialized agents covering all development lifecycle phases:
393
393
 
394
394
  - **Development**: code-reviewer, test-engineer, architecture-designer, debugger, performance-engineer
395
395
  - **Requirements**: requirements-analyst, requirements-reviewer, business-process-analyst
@@ -0,0 +1,138 @@
1
+ # Media Curator Framework
2
+
3
+ Intelligent media archive management for building, curating, and maintaining comprehensive media collections. Handles discography analysis, source discovery, acquisition, quality assessment, metadata curation, and multi-platform export.
4
+
5
+ ## Quick Start
6
+
7
+ ```bash
8
+ # Deploy the framework
9
+ aiwg use media-curator
10
+
11
+ # Analyze an artist's discography
12
+ /analyze-artist "Twenty One Pilots"
13
+
14
+ # Discover sources for specific content
15
+ /find-sources "Twenty One Pilots" --scope "complete"
16
+
17
+ # Acquire content from discovered sources
18
+ /acquire --plan sources.yaml
19
+
20
+ # Tag and organize the collection
21
+ /tag-collection /path/to/collection
22
+
23
+ # Check collection completeness
24
+ /check-completeness "Twenty One Pilots"
25
+
26
+ # Verify archive integrity
27
+ /verify-archive /path/to/collection
28
+
29
+ # Export for a specific platform
30
+ /export --profile plex /path/to/collection /path/to/output
31
+ ```
32
+
33
+ ## Capabilities
34
+
35
+ | Capability | Agent | Command |
36
+ |-----------|-------|---------|
37
+ | Discography research and era identification | `discography-analyst` | `/analyze-artist` |
38
+ | Multi-platform source discovery | `source-discoverer` | `/find-sources` |
39
+ | Download orchestration with format selection | `acquisition-manager` | `/acquire` |
40
+ | Audio/video quality scoring and filtering | `quality-assessor` | (integrated) |
41
+ | Metadata tagging and artwork embedding | `metadata-curator` | `/tag-collection` |
42
+ | Gap analysis and completeness tracking | `completeness-tracker` | `/check-completeness` |
43
+ | Narrative and playlist assembly | (integrated) | `/assemble` |
44
+ | Multi-platform format export | (integrated) | `/export` |
45
+ | SHA-256 integrity verification | (integrated) | `/verify-archive` |
46
+
47
+ ## Architecture
48
+
49
+ ```
50
+ media-curator/
51
+ ├── agents/
52
+ │ ├── discography-analyst.md # Era/project identification
53
+ │ ├── source-discoverer.md # Finding content across platforms
54
+ │ ├── acquisition-manager.md # Download orchestration
55
+ │ ├── quality-assessor.md # Accept/reject criteria
56
+ │ ├── metadata-curator.md # Tagging and organization
57
+ │ └── completeness-tracker.md # Gap analysis
58
+ ├── commands/
59
+ │ ├── curate.md # Main orchestration entry point
60
+ │ ├── analyze-artist.md # Discography analysis
61
+ │ ├── find-sources.md # Source discovery
62
+ │ ├── acquire.md # Download management
63
+ │ ├── tag-collection.md # Metadata application
64
+ │ ├── check-completeness.md # Gap analysis
65
+ │ ├── assemble.md # Narrative/playlist assembly
66
+ │ ├── export.md # Multi-platform output
67
+ │ └── verify-archive.md # Integrity verification
68
+ ├── skills/
69
+ │ ├── youtube-acquisition.md # yt-dlp patterns
70
+ │ ├── archive-acquisition.md # Internet Archive patterns
71
+ │ ├── audio-extraction.md # ffmpeg audio extraction
72
+ │ ├── metadata-tagging.md # opustags/ffmpeg tagging
73
+ │ ├── quality-filtering.md # Accept/reject logic
74
+ │ ├── cover-art-embedding.md # Artwork embedding
75
+ │ ├── integrity-verification.md # SHA-256 manifests
76
+ │ ├── gap-documentation.md # GAP-NOTE.md pattern
77
+ │ └── provenance-tracking.md # W3C PROV-O for media
78
+ ├── config/
79
+ │ └── defaults.yaml # Default configuration
80
+ └── docs/
81
+ ├── overview.md # Framework overview
82
+ ├── user-guide.md # User guide
83
+ └── standards-reference.md # Standards (PREMIS, PROV, ID3)
84
+ ```
85
+
86
+ ## User Interaction Patterns
87
+
88
+ ### Complete Collection
89
+ ```
90
+ User: "My favorite band is Radiohead - build me the complete collection"
91
+ → Analyzes eras, discovers sources, acquires systematically, delivers organized collection
92
+ ```
93
+
94
+ ### Targeted Extraction
95
+ ```
96
+ User: "I love early Metallica - Master of Puppets era"
97
+ → Identifies 1983-1988, finds era-specific content, delivers focused collection
98
+ ```
99
+
100
+ ### Event/Tour Focus
101
+ ```
102
+ User: "Twenty One Pilots Bandito Tour - everything from that tour"
103
+ → Identifies tour dates/venues, finds pro-shot performances, delivers tour archive
104
+ ```
105
+
106
+ ## Quality Tiers
107
+
108
+ | Tier | Sources | Action |
109
+ |------|---------|--------|
110
+ | 1: Official/Lossless | Bandcamp FLAC, official YouTube | Always accept |
111
+ | 2: High Quality | YouTube Music AAC 256, SoundCloud 320 | Accept |
112
+ | 3: Standard | YouTube AAC 128-256 | Accept if unique |
113
+ | 4: Avoid | Phone recordings, heavy compression | Reject (unless legendary) |
114
+
115
+ ## Standards
116
+
117
+ | Standard | Usage |
118
+ |----------|-------|
119
+ | ID3v2.4 / Vorbis Comments | Audio metadata |
120
+ | SHA-256 (NIST FIPS 180-4) | Integrity verification |
121
+ | PREMIS 3.0 | Preservation fixity metadata |
122
+ | W3C PROV-O | Provenance tracking |
123
+ | ISO 8601 | Timestamps (UTC, nanosecond precision) |
124
+ | MusicBrainz | Canonical discography data |
125
+
126
+ ## Tools Required
127
+
128
+ | Tool | Purpose | Install |
129
+ |------|---------|---------|
130
+ | `yt-dlp` | Video/audio acquisition | `pip install yt-dlp` |
131
+ | `ffmpeg` | Transcoding, extraction | System package |
132
+ | `opustags` | Opus metadata tagging | System package |
133
+ | `sha256sum` | Integrity checksums | GNU coreutils |
134
+
135
+ ## Related Issues
136
+
137
+ - Epic: [#75](https://git.integrolabs.net/roctinam/ai-writing-guide/issues/75)
138
+ - Child issues: #76-#83, #253