aod-stack

Stack Pack Management Skill

Activate, list, and manage stack packs that encode technology-specific conventions, security patterns, and agent persona supplements into AOD.

Subcommands

Command	Purpose
/aod.stack use {pack-name}	Activate a stack pack
/aod.stack list	Show available packs and active status
/aod.stack remove	Deactivate the active pack
/aod.stack scaffold	Scaffold project structure from the active pack

---

/aod.stack use {pack-name}

Activate a stack pack by copying its rules, generating a persona loader, and persisting activation state.

Step 1: Validate the pack exists

1. Check that stacks/{pack-name}/ exists as a directory.
2. Check that stacks/{pack-name}/STACK.md exists and is non-empty.
3. If the directory or STACK.md does not exist, display the error:

   Pack not found: {pack-name}
   
   Available packs:
     - {list each directory under stacks/ that contains a STACK.md}
   
   Use: /aod.stack use {pack-name}
   

   Then stop.

Step 2: Handle already-active pack

1. Read .aod/stack-active.json if it exists.
2. If another pack is active (the pack field differs from {pack-name}):
   • Prompt the user: "Pack {current-pack} is currently active. Switch to {pack-name}? This will deactivate {current-pack} first. (y/n)"
   • If the user declines, stop.
   • If the user confirms, execute full deactivation: a. Delete all files in .claude/rules/stack/. b. Delete .aod/stack-active.json.
3. If the same pack is already active (pack field equals {pack-name}):
   • Prompt: "Pack {pack-name} is already active. Re-activate to update rules and persona loader? (y/n)"
   • If the user declines, stop.
   • If the user confirms, proceed (this refreshes rules from the pack source).

Step 3: Detect and resolve inconsistent state

Before proceeding, check for inconsistencies:

• If .aod/stack-active.json exists but is not valid JSON:
  • Warn: "Inconsistent state: .aod/stack-active.json is corrupted. Cleaning up stale state."
  • Delete all files in .claude/rules/stack/.
  • Delete .aod/stack-active.json.
  • Then continue with activation.