Auxiliary Script Management

"Auxiliary scripts help with automation – temporary scripts auto-cleanup after 1 hour."

When to Use This Skill

Use when:

• Creating helper scripts in .claude/session/
• Managing script cleanup and retention
• Understanding script classification

Use proactively:

• Document reusable scripts in AGENT.md
• Use descriptive naming for scripts

Quick Start

Example 2: Reusable script template

# Script: developer-deployment.ps1
# Purpose: Deploy build artifacts to staging
# Created: 2026-01-23
# Used by: developer

param([string]$Environment)

# Script logic here

Example 3: Adding to config

$Script:AuxiliaryScripts.Reusable = @{
    "developer-deployment.ps1" = @{
        Purpose = "Deploy build artifacts"
        Created = "2026-01-23"
        UsedBy = @("developer")
    }
}

Script Classification

Temporary Scripts

Auto-cleaned after 1 hour:

• *-runner.ps1 - Agent runner scripts
• msg-*-*.json - Message files
• *.exit - Agent exit status files
• restart-flag-*.json - Restart signal files
• *.tmp - Temporary files

Do NOT rely on these persisting.

Creating Reusable Scripts

1. Document it in AGENT.md "Reusable Scripts" section
2. Use descriptive naming: {agent}-{purpose}.ps1
3. Add to ralph-config.ps1 under AuxiliaryScripts.Reusable
4. Explain purpose for future sessions

Template:

# Script: {AGENT}-{PURPOSE}.ps1
# Purpose: {Brief description}
# Created: {DATE}
# Used by: {Which agents}

param([string]$SomeParameter)
# Script logic

Documentation in AGENT.md

Update this table when creating new reusable scripts.

Script Permissions

• All scripts in .claude/session/ executable by agents
• Never create scripts that modify source code without task assignment
• Scripts should only update session/state files

Related Skills