Asana Sync Skill
Sync the current project's Asana tasks to its local mirror and summarise the result.
Step 1 — Identify the current project
Read CLAUDE.md in the current working directory. Extract:
ASANA_TASK_PREFIX— e.g.MCF- The Asana project GID — resolve from the registry first (
python3 /media/data/dev/bain-studio/studio/registry.py --prefix {PREFIX} --field gid), falling back to the project's ownCLAUDE.md. A project inside the public bain-studio repo carries no GID in itsCLAUDE.md; a client project's does, in its own private repo. ASANA_PROJECT_NAME— for the summary header
If neither the registry nor CLAUDE.md yields a GID, report: "No Asana project configured for this directory. Register it (/register-project) or add ASANA_PROJECT_GID to CLAUDE.md to enable sync."
Step 2 — Run the sync
python3 ~/dev/bain-studio/studio/sync.py --project {PREFIX}
This updates asana-mirror.md and asana-ids.json in the project root.
Step 3 — Read the updated mirror
Read asana-mirror.md. Report:
- Total tasks assigned to the configured assignee
- New tasks since last sync
- Removed tasks (likely completed)
- Any overdue tasks
- Immediate priorities table
Notes
- The sync script handles ID assignment, progress-note diffing, and posting changed notes to Asana as comments.
- Local IDs (e.g. MCF-001) are assigned sequentially and stored in
asana-ids.json. - Progress notes are preserved across syncs — only updated when meaningfully changed.
- To sync all studio projects at once:
python3 ~/dev/bain-studio/studio/sync.py - Sync log:
~/dev/bain-studio/studio/sync.log