Initial commit

commands/ace-clear.md

@@ -0,0 +1,87 @@
+---
+description: Clear ACE playbook (reset all learned bullets)
+argument-hint: [--confirm]
+---
+
+# ACE Clear
+
+Reset the ACE playbook by clearing all learned bullets.
+
+⚠️ **WARNING**: This will delete ALL learned bullets across all 4 sections!
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+
+if ! command -v ce-ace >/dev/null 2>&1; then
+  echo "❌ ce-ace 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
+
+ce-ace --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.
+
+## See Also
+
+- `/ace:ace-export-patterns` - Backup before clearing
+- `/ace:ace-import-patterns` - Restore from backup
+- `/ace:ace-status` - Verify playbook is cleared