/aiwg-refresh

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

Any removal list requires explicit human review of the listed removals before execution. Authorization lookup must never bypass that review, even with a receipt for other effects.

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:

1. Check existing deployments:

• `.claude/agents/` exists → claude
• `.factory/droids/` exists → factory
• `.codex/agents/` exists → openai
• `.cursor/rules/` exists → cursor

2. If multiple detected, ask user:

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

   Which platform to refresh?

3. 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-mode