Figloops go plan ack
Plan-ack phase — render plan frame in Figma, anchor comment threads, refresh on subsequent runsFrom its SKILL.md
npx -y skills add tyburrowbridge/figloops --skill figloops-go-plan-ackAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.5 KB, as published. Nobody here has run it
Setup
Resolve FIGLOOPS_PLUGIN_DIR from env or .env. If unset, abort. Resolve FIGMA_TOKEN from env or .env. Scripts: cd "<CONSUMING_REPO>" && "<PLUGIN_DIR>/node_modules/.bin/tsx" "<PLUGIN_DIR>/scripts/<name>.ts" <args>. Always double-quote paths.
Style
Status table per round. AskUserQuestion options carry no descriptions.
Errors
TS exits non-zero → relay stderr verbatim, don't advance. MCP failure → prompt user to retry; don't advance.
Handler
-
Mark
[FIGLOOPS] Ack plan in Figmaasin_progress. -
Read
feedback/state.jsonandfigloops.config.jsonto getfigma.fileKeyand current round. -
Mode detection. If
state.rounds[currentRound].planFrameis unset → render+anchor mode (step 4). Else → refresh mode (step 7).
Render + anchor mode
-
Render frame. Run:
PAYLOAD=$("<PLUGIN_DIR>/node_modules/.bin/tsx" "<PLUGIN_DIR>/scripts/render-plan-frame.ts" "feedback/state.json" <round>)Then invoke
use_figmawithfileKey: <fileKey>,code: "$PAYLOAD",description: "Render Round <N> plan frame". Capture the returned JSON:{pageId, frameId, frameName, rows: [{itemId, index, nodeId}]}. -
Persist frame result + assign rowIndex. Read state.json, set
rounds[round].planFrame = {pageId, frameId, frameName}, setrowIndexon each plan item fromrows. Write back. -
Anchor threads. Run:
"<PLUGIN_DIR>/node_modules/.bin/tsx" "<PLUGIN_DIR>/scripts/anchor-plan-threads.ts" "feedback/state.json" <round> "<fileKey>" "$FIGMA_TOKEN"Regenerate snapshot.
Print:
📋 Round <N> plan rendered in Figma — <count> items anchored. Open the Figma file and act on each item: - ✓ resolve the thread when you've shipped it - reply `/skip` to mark won't do - leave it open to discuss When you're done (or want to check in), re-run `/figloops:go`.Exit. Do not advance.
Refresh mode
-
Pull thread states. Run:
DELTA=$("<PLUGIN_DIR>/node_modules/.bin/tsx" "<PLUGIN_DIR>/scripts/pull-plan-states.ts" "feedback/state.json" <round> "<fileKey>" "$FIGMA_TOKEN")Parse the JSON:
{statuses: {itemId → status}, delta: {shipped: [], wontdo: [], pending: [], removed: []}}. The script has already written the new statuses back to state.json. -
Recovery check — plan frame deleted. If any item now has
status: 'removed'AND it was previously not'removed', runget_metadataonplanFrame.frameIdto confirm. If frame is missing too, useAskUserQuestion:question: "Plan frame for Round <N> is missing. Re-render?" header: "Recovery" options: - label: "Re-render frame and threads (Recommended)" - label: "Cancel — leave state as-is"- Re-render: clear
planFrameand clearcommentId/botReplyIdon every item, then re-enter render+anchor mode (step 4). - Cancel: print the delta and exit.
- Re-render: clear
-
Print delta.
🔄 Refreshed Round <N> plan + <N> newly shipped (<#list>) + <N> newly skipped (<#list>) = <N> still pendingRegenerate snapshot.
-
Advance check. Count items by status from the new state.
- If any item is
pending→ exit. Tell user to keep working in Figma. - Else (all
shipped/wontdo/removed) → mark taskcompleted, runadvance-phase.ts close, invoke skillfigloops-go-close.
- If any item is