AIWG Use

You deploy AIWG frameworks and addons to the current workspace.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

• "set up sdlc" → deploy sdlc-complete framework
• "add the marketing framework" → deploy media-marketing-kit
• "activate rlm" → deploy rlm addon
• "scaffold the writing framework" → deploy voice-framework addon
• "get the ring methodology" → deploy ring-methodology addon

Trigger Patterns Reference

Pattern	Example	Action
Framework deploy	"use sdlc"	Run aiwg use sdlc
Addon deploy	"use the ralph addon"	Run aiwg use ralph
Provider-scoped deploy	"deploy sdlc to copilot"	Run aiwg use sdlc --provider copilot
Source deploy	"deploy from local source"	Run aiwg use sdlc (source installs are detected automatically)
Kernel surface	"deploy the kernel"	Run aiwg use all

Behavior

When triggered:

1. Extract intent:

   • Which framework or addon is requested? (resolve shorthand: "sdlc" → sdlc-complete, "marketing" → media-marketing-kit, "forensics" → forensics-complete, "research" → research-complete, "curator" → media-curator)
   • Is a specific provider mentioned? Default is the detected active provider.
   • Source installs are detected automatically; no development flag is needed.

2. Resolve the target:

   Frameworks:

   Shorthand	ID
   sdlc	sdlc-complete
   marketing	media-marketing-kit
   forensics	forensics-complete
   research	research-complete
   curator	media-curator

   Addons:

   Shorthand	ID
   ralph	ralph
   rlm	rlm
   ring	ring-methodology
   voice	voice-framework
   writing	writing-quality
   testing	testing-quality
   utils	aiwg-utils

3. Run the appropriate command:

   # Deploy a framework (default provider)
   aiwg use sdlc
   
   # Deploy an addon
   aiwg use ralph
   
   # Deploy to a specific provider
   aiwg use sdlc --provider copilot
   
   # Deploy the kernel surface (kernel skills, kernel and core rules, behaviors)
   aiwg use all
   

4. Report the result inline — confirm what was deployed, where, and any warnings about missing dependencies.

The canonical SDLC target is sdlc; sdlc-complete is accepted as a compatibility alias. Source checkouts are detected automatically from their .git entry.

Use --dry-run for one consolidated plan with each planned action listed once. --copy-all restores the full agent, command, skill and rule surface for all.

Unknown options fail with exit code 2; run aiwg use --help for usage.

Examples

Example 1: Deploy the SDLC framework

User: "use sdlc"

Extraction: Framework sdlc-complete, default provider

Action:

aiwg use sdlc

Response: "Deployed sdlc-complete to claude-code. Agents written to .claude/agents/, commands to .claude/commands/, rules to .claude/rules/. Registered in .aiwg/frameworks/registry.json."

Example 2: Deploy to a specific provider

User: "deploy the sdlc framework to GitHub Copilot"

Extraction: Framework sdlc-complete, provider copilot

Action:

aiwg use sdlc --provider copilot

Response: "Deployed sdlc-complete to copilot. Agents written as .github/agents/*.agent.md, commands to .github/prompts/, rules to .github/instructions/."

Example 3: Deploy an addon

User: "activate the ring methodology addon"

Extraction: Addon ring-methodology, default provider

Action:

aiwg use ring-methodology

Response: "Deployed ring-methodology addon to claude-code. 7 rules installed to .claude/rules/."

Example 4: Deploy the kernel surface

User: "deploy the kernel"

Extraction: Kernel surface

Action:

aiwg use all

Response: "Deployed the kernel surface to claude-code: kernel skills, kernel and core rules, and behaviors. Full framework artifacts remain available through discovery; deploy a named framework to install its full surface."

Clarification Prompts

If the user's intent is ambiguous:

• "Which framework would you like to deploy? Available: sdlc-complete, media-marketing-kit, forensics-complete, research-complete, media-curator"
• "Should I deploy to the current provider (claude-code) or a different one?"

References

• @$AIWG_ROOT/src/cli/handlers/use.ts — Use command handler
• @$AIWG_ROOT/docs/cli-reference.md — CLI reference
• @CLAUDE.md — Multi-platform provider table