ACE Export Playbook

Export your ACE playbook to JSON for backup or cross-project sharing.

Instructions for Claude

When the user runs /ace:export-patterns, use ace-cli to export the playbook:

#!/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

# Read context
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 "")

# Try env wrapper format
if [ -z "$ORG_ID" ] || [ -z "$PROJECT_ID" ]; then
  ORG_ID=$(jq -r '.env.ACE_ORG_ID // empty' .claude/settings.json 2>/dev/null || echo "")
  PROJECT_ID=$(jq -r '.env.ACE_PROJECT_ID // empty' .claude/settings.json 2>/dev/null || echo "")
fi

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

# Export playbook
OUTPUT_FILE="${1:-ace-playbook-export.json}"

echo "📦 Exporting ACE playbook..."

if [ -n "$ORG_ID" ]; then
  ace-cli --json --org "$ORG_ID" --project "$PROJECT_ID" export > "$OUTPUT_FILE"
else
  ace-cli --json --project "$PROJECT_ID" export > "$OUTPUT_FILE"
fi

if [ $? -eq 0 ]; then
  PATTERN_COUNT=$(jq '.playbook | to_entries | map(.value | length) | add' "$OUTPUT_FILE" 2>/dev/null || echo "unknown")
  FILE_SIZE=$(du -h "$OUTPUT_FILE" | cut -f1)

  echo "✅ Playbook exported successfully!"
  echo "   File: $OUTPUT_FILE"
  echo "   Size: $FILE_SIZE"
  echo "   Patterns: $PATTERN_COUNT"
else
  echo "❌ Export failed"
  exit 1
fi

What Gets Exported

The exported JSON contains:

{
  "playbook": {
    "strategies_and_hard_rules": [
      {
        "id": "ctx-xxx",
        "content": "Pattern content...",
        "helpful": 5,
        "harmful": 0,
        "confidence": 1.0,
        "evidence": [...],
        "observations": 10
      }
    ],
    "useful_code_snippets": [...],
    "troubleshooting_and_pitfalls": [...],
    "apis_to_use": [...]
  }
}

Use Cases

Backup:

/ace:export-patterns ace-backup-2025-01-20.json

Cross-project sharing:

1. Export from project A: /ace:export-patterns project-a-patterns.json
2. Import to project B: /ace:import-patterns project-a-patterns.json

Version control (optional):

• Export periodically to track playbook evolution
• Commit to git for team sharing (careful with sensitive patterns!)

See Also

• /ace:import-patterns - Import playbook from JSON
• /ace:status - View current playbook stats
• /ace:clear - Clear playbook before importing