# Pm Asana Sync

> Sync the assignee's Asana tasks to a local offline mirror. For the current project, runs the studio sync script to update asana-mirror.md, then reads and summarises the result. Use at the start of any work session or when asked to sync.

- Skill: `markbaindesign/pm-asana-sync-2` (Agent Skill)
- Install (CLI): `npx get-skill add markbaindesign/pm-asana-sync-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/markbaindesign/pm-asana-sync-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: markbaindesign (https://skillmd.com/u/markbaindesign)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/markbaindesign/pm-asana-sync-2

---


# 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 own `CLAUDE.md`. A project inside the public bain-studio repo carries no GID in its `CLAUDE.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

```bash
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`

