ACE Clear

Reset the ACE playbook by clearing all learned bullets.

⚠️ WARNING: This will delete ALL learned bullets across all 4 sections!

#!/usr/bin/env bash
set -euo pipefail

if ! command -v ace-cli >/dev/null 2>&1; then
  echo "❌ ace-cli not found - Install: npm install -g @ace-sdk/cli"
  exit 1
fi

ORG_ID=$(jq -r '.orgId // .env.ACE_ORG_ID // empty' .claude/settings.json 2>/dev/null || echo "")
PROJECT_ID=$(jq -r '.projectId // .env.ACE_PROJECT_ID // empty' .claude/settings.json 2>/dev/null || echo "")

if [ -z "$ORG_ID" ] || [ -z "$PROJECT_ID" ]; then
  echo "❌ Run /ace-configure first"
  exit 1
fi

echo "⚠️ WARNING: This will delete ALL learned patterns!"
read -p "Are you sure? Type 'yes' to confirm: " CONFIRMATION

if [ "$CONFIRMATION" != "yes" ]; then
  echo "❌ Aborted"
  exit 1
fi

ace-cli --org "$ORG_ID" --project "$PROJECT_ID" clear --confirm

What Gets Deleted

All playbook sections:

strategies_and_hard_rules - All strategies cleared
useful_code_snippets - All code snippets cleared
troubleshooting_and_pitfalls - All troubleshooting cleared
apis_to_use - All API patterns cleared

All metadata:

Helpful/harmful counters reset to 0
Confidence scores lost
Evidence trails removed
Timestamps cleared

Storage Impact

Clears from:

Remote server: ACE Storage Server (ChromaDB)
Project-specific: Only YOUR project's playbook
Multi-tenant safe: Other projects/orgs unaffected

When to Use

Fresh start: Reset learning for new project phase
Bad patterns: Clear after accumulating misleading bullets
Testing: Clean state for testing ACE learning

After Clearing

ACE will start learning from scratch:

Execute tasks → ACE learns from outcomes
Successful tasks → adds helpful bullets
Failed tasks → adds troubleshooting bullets

Backup First!

Before clearing, export your playbook:

/ace:ace-export-patterns

This saves a JSON backup you can re-import later.

/ace-clear