Analyze Official Asana MCP

Analyze Official Asana MCP Gap

When to use

• GitHub issue labeled mcp-gap-analysis or titled chore: official Asana MCP catalog changed
• Maintainer asks for "MCP gap analysis" or "official catalog changed"
• After adding or removing cyber-asana MCP tools (run pnpm --filter @cyberuni/gap-analysis run catalog first)

Prerequisites

• Repo dependencies installed (pnpm install)
• Committed baselines present under data/

Workflow

1. Refresh cyber-asana catalog if MCP source changed

pnpm --filter @cyberuni/gap-analysis run catalog
pnpm --filter @cyberuni/gap-analysis run check

2. Generate gap report

pnpm --filter @cyberuni/gap-analysis run report -- --json

Read the four buckets:

3. Classify catalog deltas

For each added official tool:

• Official-only — no sensible cyber-asana REST equivalent (e.g. previews, search_objects)
• New overlap — add entry to tools/gap-analysis/src/overlap-map.ts
• cyber-asana gap — official added capability we should implement via REST

For each removed official tool:

• Note deprecation in maintainer summary
• Remove stale entries from overlap-map.ts

4. Update routing, overlap map, and web docs

• Edit tools/gap-analysis/src/overlap-map.ts for new or changed pairs
• When dual-MCP readme routing exists, update the routing table there
• Update apps/web/src/content/docs/reference/mcp-comparison.md: its tool totals, overlap/official-only/cyber-only summary, routing tables, and capability descriptions must match the report
• Update affected skills under skills/ if they reference MCP tool choice

5. Implementation handoff

If cyber-asana should gain tools:

• Follow update-asana-sdk — gateway, api, cli, mcp, tests
• Regenerate catalog: pnpm --filter @cyberuni/gap-analysis run catalog

If docs-only:

• Routing/readme/web-docs/skills changes suffice

6. Refresh official baseline (separate commit)

After analysis is complete:

pnpm --filter @cyberuni/gap-analysis run fetch-official -- --write

Verify:

# should exit 0 (unchanged vs itself — use a temp fetch instead)
pnpm --filter @cyberuni/gap-analysis run fetch-official -- --json > /tmp/official.json
pnpm --filter @cyberuni/gap-analysis run diff-official -- /tmp/official.json
# should exit 0 after baseline refresh

7. Maintainer summary

Post or include in PR:

• Added/removed official tools
• Overlap map edits
• Routing and web-doc edits
• Recommended follow-up PRs (implement vs docs-only)

Commands reference

Commit discipline

1. Analysis + overlap-map + docs (one commit)
2. Baseline JSON refresh (separate commit)

Never commit with red tests. Run pnpm --filter @cyberuni/gap-analysis run test before pushing.