# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Repository Overview

This is an Alfred preferences sync repository. It contains Alfred workflows, snippets, and preferences that are version-controlled via git and synced across machines.

**Directory Structure:**
- `Alfred.alfredpreferences/` - Main Alfred preferences package
  - `workflows/` - Alfred workflows (UUID-named directories, each containing `info.plist`)
  - `snippets/` - Text snippet collections (JSON files with Alfred snippet format)
  - `preferences/` - General Alfred preferences (`prefs.plist`, features, etc.)
  - `resources/` - Alfred resources (icons, images)
  - `remote/` - Remote sync data
- `alfred-sync.sh` - Git sync script

## Syncing Changes

To commit and push Alfred preference changes:

```bash
./alfred-sync.sh
```

This script stages all changes, creates a timestamped commit, and pushes to the remote repository.

## Alfred Workflow Structure

Each workflow is stored in `workflows/user.workflow.{UUID}/` and contains:
- `info.plist` - Main workflow configuration (name, objects, connections, script definitions)

Workflows are defined as XML plist files containing:
- Workflow metadata (name, bundleid, createdby)
- Objects (script actions, inputs, outputs, notifications)
- Connections between objects
- UI layout data (uidata)

## Snippet Collections

Snippets are organized in themed collections under `snippets/`:
- `術語速查字典/` - Technical terminology cheat sheets
- `中文輸出速查/` - Chinese text output shortcuts
- `特殊字元輸出集/` - Special character collections
- `topsecret/` - Sensitive credentials (be cautious when committing)

Each snippet is a JSON file with the structure:
```json
{
  "alfredsnippet": {
    "snippet": "expansion text",
    "uid": "UUID",
    "name": "display name",
    "keyword": "trigger keyword"
  }
}
```

## Notes

- The `Alfred.alfredpreferences` directory is macOS package format
- Workflow UUIDs are generated by Alfred and should not be changed
- When editing workflows, ensure plist XML syntax remains valid
- Be mindful of sensitive data in snippets (especially `topsecret/` collection)