Generate a corpus snapshot report — computes dimensions, topology, degree distribution, delta from previous. Helps with cluster, chain, and gap analysis sections.

2026-07-12161

agent-loop

jmagly/aiwg

Detect requests for iterative autonomous agent loops and route to the appropriate loop executor

2026-07-11161

mission-control

jmagly/aiwg

Orchestrate multi-loop background operations via the Mission Control dashboard — start sessions, dispatch missions, monitor, and stop

2026-07-10161

aiwg-mission

jmagly/aiwg

Launch an AIWG Mission — durable, audited dynamic agent orchestration toward a completion criterion. AIWG owns the conductor (activity-log, gates, best-output, checkpoint/resume, cost); native primitives drive worker mechanism. Surfaces as /aiwg-mission in Codex (AIWG-owned, no plugin dependency).

2026-07-10161

flow-release

jmagly/aiwg

Config-driven release orchestration — reads .aiwg/release.config plus optional .aiwg/releases/<plan-id> sidecars and walks the selected release plan's gates

2026-07-10161

aiwg-steward-routing-reference

jmagly/aiwg

Tier-3 steward routing reference lookup for full CLI tables, deploy paths, issue/project-local routing, orchestration routes, diagnostics, and provider capability examples

2026-07-09161

namespace	aiwg
name	aiwg-refresh
platforms	["all"]
kernel	true
description	Update AIWG CLI and redeploy frameworks/tools to current project without leaving the session
script	{"entrypoint":"run.sh","runtime":"bash","cwd":"project-root","argsHint":"[--update-cli] [--all] [--provider <name>] [--dry-run] [--channel <name>]"}

Deterministic execution (#1267): this skill has a script: entrypoint that shells out to aiwg refresh "$@". Prefer aiwg run skill aiwg-refresh -- <flags> when a platform supports it; on platforms without a deployed command stub (e.g. hermes) invoke the CLI directly. The CLI owns the deterministic execution step: version/channel resolution, CLI update, framework redeploy, provider detection, and exit codes. The skill owns the agentic layer around that step: intent alignment, output formatting, workspace-state reconciliation, summary, next actions, gates, and recovery. Do not reimplement the refresh manually or add redundant permission prompts before calling the CLI for execution.

Refresh AIWG Deployment

Update the AIWG CLI and/or redeploy frameworks, agents, commands, and tools to the current project without leaving the agentic session.

Use Cases

After AIWG updates: Get latest framework features without restarting
After switching branches: Ensure deployed content matches expectations
After manual edits: Restore canonical AIWG content
Provider switch: Redeploy for different platform (Claude → Factory)
Model selection: Redeploy with different AI models for each tier

Parameters

Flag	Description
`--update-cli`	Update AIWG CLI to latest version before redeploying
`--all`	Redeploy all installed frameworks
`--sdlc`	Redeploy SDLC framework only
`--marketing`	Redeploy Marketing framework only
`--utils`	Redeploy aiwg-utils addon only
`--provider <name>`	Target platform: claude, factory, openai, cursor, warp (default: auto-detect)
`--reasoning-model <name>`	Override model for reasoning agents (opus tier)
`--coding-model <name>`	Override model for coding agents (sonnet tier)
`--efficiency-model <name>`	Override model for efficiency agents (haiku tier)
`--filter <pattern>`	Only deploy agents matching glob pattern (e.g., `architect`)
`--filter-role <role>`	Only deploy agents of specified role: reasoning, coding, efficiency
`--save`	Persist model selection to project models.json
`--force`	Force redeploy even if already up-to-date
`--dry-run`	Show what would be done without executing

Execution Steps

Step 1: Show Current Status

Run status check and report current state:

aiwg -status

Report:

AIWG Refresh - Current Status
==============================

CLI Version: 1.2.3 (stable channel)
Workspace: /path/to/project/.aiwg

Installed Frameworks:
  - sdlc-complete v1.0.0 (58 agents, 48 commands)
  - aiwg-utils v1.0.0 (3 agents, 25 commands)

Platform: Claude Code (.claude/)
  - Agents: 61 deployed
  - Commands: 73 deployed

Step 2: Update CLI (if --update-cli)

If --update-cli flag is set:

aiwg -update

Report update status:

Checking for updates...
  Current: 1.2.3
  Latest:  1.2.5

Updating AIWG CLI...
✓ Updated to v1.2.5

Changes in v1.2.5:
  - New mutation-analyst agent
  - Testing-quality addon
  - Bug fixes

If already up-to-date:

AIWG CLI is up-to-date (v1.2.3)

Step 3: Determine What to Redeploy

Based on flags, determine scope:

Flags	Action
No flags	Show status only, prompt for action
`--all`	Redeploy all installed frameworks
`--sdlc`	Redeploy sdlc-complete only
`--marketing`	Redeploy media-marketing-kit only
`--utils`	Redeploy aiwg-utils addon only
Multiple	Redeploy specified frameworks

If no framework flags and not --dry-run, ask user:

What would you like to refresh?

[1] All frameworks (sdlc-complete, aiwg-utils)
[2] SDLC framework only
[3] Utils addon only
[4] Just show status (no changes)

Choice:

Step 4: Detect Target Platform

If --provider not specified, auto-detect:

Check existing deployments:
- .claude/agents/ exists → claude
- .factory/droids/ exists → factory
- .codex/agents/ exists → openai
- .cursor/rules/ exists → cursor

If multiple detected, ask user:

Multiple platforms detected:
[1] Claude Code (.claude/)
[2] Factory AI (.factory/)

Which platform to refresh?

If none detected, default to claude

Report:

Target platform: Claude Code
Deployment paths:
  - Agents: .claude/agents/
  - Commands: .claude/commands/

Step 5: Execute Redeploy

For each framework to deploy:

# SDLC Framework
aiwg use sdlc --provider <platform> --force [model-flags] [filter-flags]

# Marketing Framework
aiwg use marketing --provider <platform> --force [model-flags] [filter-flags]

# Utils (included with sdlc)
# No separate command needed

Model flags (if specified):

--reasoning-model <name> - applies to all opus-tier agents
--coding-model <name> - applies to all sonnet-tier agents
--efficiency-model <name> - applies to all haiku-tier agents

Filter flags (if specified):

--filter <pattern> - only deploys matching agents
--filter-role <role> - only deploys agents of specified role

If --dry-run: Show commands without executing:

Dry Run - Would execute:
========================

1. aiwg use sdlc --provider claude --force --reasoning-model opus-4-2
   → Deploy 58 agents to .claude/agents/ (reasoning tier with opus-4-2)
   → Deploy 48 commands to .claude/commands/

2. aiwg use marketing --provider claude --force --reasoning-model opus-4-2
   → Deploy 37 agents to .claude/agents/ (reasoning tier with opus-4-2)
   → Deploy 20 commands to .claude/commands/

No changes made (dry run mode)

Progress Reporting:

Refreshing AIWG Deployment
==========================

[1/2] Deploying sdlc-complete...
  → Copying 58 agents...
  → Copying 48 commands...
  → Copying 12 templates...
  ✓ sdlc-complete deployed

[2/2] Deploying aiwg-utils...
  → Copying 3 agents...
  → Copying 25 commands...
  ✓ aiwg-utils deployed

Step 6: Verify Deployment

After deployment, verify:

# Count deployed assets
ls .claude/agents/*.md 2>/dev/null | wc -l
ls .claude/commands/*.md 2>/dev/null | wc -l

Report:

Verification
============

Deployed Assets:
  - Agents: 95 files
  - Commands: 93 files

Platform Files:
  - CLAUDE.md: Present
  - .claude/settings.local.json: Present

All assets deployed successfully!

Step 7: Summary Report

AIWG Refresh Complete
=====================

CLI:
  Version: 1.2.5 (updated from 1.2.3)

Frameworks Deployed:
  ✓ sdlc-complete v1.0.0 (58 agents, 48 commands)
  ✓ aiwg-utils v1.0.0 (3 agents, 25 commands)

Platform: Claude Code
  - .claude/agents/: 61 files
  - .claude/commands/: 73 files

New capabilities available:
  - /setup-tdd - TDD enforcement setup
  - /flow-test-strategy-execution - Test execution workflow
  - mutation-analyst agent - Test quality analysis

Session ready - new features are now available!

Examples

# Check status only
/aiwg-refresh

# Update CLI and redeploy everything
/aiwg-refresh --update-cli --all

# Just redeploy SDLC framework
/aiwg-refresh --sdlc

# Switch to Factory AI deployment
/aiwg-refresh --all --provider factory

# Preview what would happen
/aiwg-refresh --all --dry-run

# Force refresh even if up-to-date
/aiwg-refresh --all --force

# Redeploy with custom reasoning model
/aiwg-refresh --all --reasoning-model claude-opus-4-2

# Redeploy with custom models for all tiers
/aiwg-refresh --all --reasoning-model opus-4-2 --coding-model sonnet-5 --efficiency-model haiku-4

# Redeploy and save model selection for future deploys
/aiwg-refresh --all --coding-model claude-sonnet-5-0 --save

# Only update architect agents with new reasoning model
/aiwg-refresh --sdlc --filter "*architect*" --reasoning-model opus-4-2

# Only update reasoning-tier agents
/aiwg-refresh --all --filter-role reasoning --reasoning-model custom-reasoning

Natural Language Triggers

This command should activate when user says:

"refresh aiwg" / "update aiwg"
"redeploy frameworks" / "redeploy agents"
"get latest aiwg features"
"update my aiwg tools"
"sync aiwg deployment"
"change agent models" / "switch to opus" / "use different model"
"redeploy with custom models"
"update reasoning agents" / "update architect agents"

Error Handling

Condition	Action
AIWG CLI not found	Error: "AIWG CLI not installed. Run: curl -fsSL ... \| bash"
Network error on update	Warn and continue with existing version
Framework not installed	Offer to install: "SDLC not installed. Install now? [y/N]"
Permission denied	Error with specific file/directory that failed
Invalid provider	Error listing valid providers

Post-Refresh Recommendations

After refresh, suggest:

Recommended next steps:
1. Review new features: aiwg -help
2. Check framework docs: /aiwg-kb sdlc
3. Run health check: aiwg doctor

References

@$AIWG_ROOT/docs/development/file-placement-guide.md - Correct file placement workflow
@$AIWG_ROOT/agentic/code/addons/aiwg-utils/commands/aiwg-regenerate.md - Context file regeneration
@$AIWG_ROOT/docs/CLI_USAGE.md - Full CLI documentation