{"id":"7b5d6fdb-7630-45ce-b41f-102d3d9d8905","shortId":"PgM4Ya","kind":"skill","title":"workflow-routing","tagline":"Use at the start of any task to route between Superpowers skills and GSD commands based on project state, task scope, and context signals. Fires before other skills when both systems are installed.","description":"# Workflow Routing: Superpowers + GSD\n\n**Announce at start:** \"Workflow Routing skill activated.\"\n\nRoute every task to the right toolchain. Superpowers handles **task-level quality** (TDD, debugging, design, review). GSD handles **project-level orchestration** (phases, milestones, persistent state). They are complementary — never competing.\n\n<HARD-GATE>\nCheck routing BEFORE invoking any other skill or GSD command. This skill fires first.\n</HARD-GATE>\n\n## Detection: Is GSD Active?\n\nCheck the current working directory:\n\n```dot\ndigraph detect {\n    \".planning/ exists?\" [shape=diamond];\n    \"ROADMAP.md exists?\" [shape=diamond];\n    \"GSD ACTIVE\" [shape=box, style=filled, fillcolor=lightblue];\n    \"GSD NOT ACTIVE\" [shape=box, style=filled, fillcolor=lightyellow];\n\n    \".planning/ exists?\" -> \"ROADMAP.md exists?\" [label=\"yes\"];\n    \".planning/ exists?\" -> \"GSD NOT ACTIVE\" [label=\"no\"];\n    \"ROADMAP.md exists?\" -> \"GSD ACTIVE\" [label=\"yes\"];\n    \"ROADMAP.md exists?\" -> \"GSD NOT ACTIVE\\n(stale or pre-roadmap)\" [label=\"no\"];\n}\n```\n\n**GSD active signals:** `.planning/PROJECT.md`, `.planning/ROADMAP.md`, `.planning/STATE.md` all present.\n\n## Primary Routing Decision\n\n```dot\ndigraph route {\n    \"Task received\" [shape=doublecircle];\n    \"GSD active?\" [shape=diamond];\n    \"Task in current phase scope?\" [shape=diamond];\n    \"Scope: multi-phase?\" [shape=diamond];\n    \"Use GSD commands\" [shape=box, style=filled, fillcolor=lightblue];\n    \"Use /gsd:quick\" [shape=box, style=filled, fillcolor=lightcyan];\n    \"Suggest /gsd:new-project\" [shape=box, style=filled, fillcolor=lightblue];\n    \"Use Superpowers skills\" [shape=box, style=filled, fillcolor=lightyellow];\n\n    \"Task received\" -> \"GSD active?\";\n    \"GSD active?\" -> \"Task in current phase scope?\" [label=\"yes\"];\n    \"GSD active?\" -> \"Scope: multi-phase?\" [label=\"no\"];\n    \"Task in current phase scope?\" -> \"Use GSD commands\" [label=\"yes\"];\n    \"Task in current phase scope?\" -> \"Use /gsd:quick\" [label=\"no, small/unrelated\"];\n    \"Scope: multi-phase?\" -> \"Suggest /gsd:new-project\" [label=\"yes\"];\n    \"Scope: multi-phase?\" -> \"Use Superpowers skills\" [label=\"no\"];\n}\n```\n\n## Scope Signals\n\n| Signal | Indicates | Route |\n|--------|-----------|-------|\n| \"build app\", \"create platform\", \"new project\", \"implement system\" | Multi-phase | GSD |\n| \"phase\", \"milestone\", \"roadmap\", \"epic\", \"release\" | Multi-phase | GSD |\n| 6+ features, 2+ weeks, architectural decisions needed | Multi-phase | GSD |\n| \"fix bug\", \"add button\", \"update function\", \"refactor method\" | Single-session | Superpowers |\n| \"quick fix\", \"hotfix\", \"one more thing\" | Small/ad-hoc | Superpowers or `/gsd:quick` if GSD active |\n| Unknown scope, user unsure | Undetermined | `/brainstorming` first to scope, then decide |\n\n## Combined Workflows\n\n### Multi-Phase Project (GSD + Superpowers for Quality)\n\n```\n/brainstorming                    ← Superpowers: design before planning\n  ↓\n/gsd:new-project                  ← GSD: project structure + roadmap\n  ↓\n/gsd:plan-phase N                 ← GSD: detailed phase plan\n  ↓\n/gsd:execute-phase N              ← GSD: runs tasks with atomic commits\n  ├── /systematic-debugging       ← Superpowers: if bug during execution\n  └── /test-driven-development    ← Superpowers: TDD within each task\n  ↓\n/requesting-code-review           ← Superpowers: review before moving on\n  ↓\n/gsd:verify-work N                ← GSD: UAT validation\n  ↓\n/verification-before-completion   ← Superpowers: evidence-based \"done\"\n  ↓\n/gsd:progress                     ← GSD: route to next phase\n```\n\n### Single-Session Task (Superpowers Only)\n\n```\n/brainstorming                    ← Explore intent, produce spec\n  ↓\n/writing-plans                    ← Break into TDD tasks\n  ↓\n/executing-plans                  ← Run tasks sequentially\n  OR /subagent-driven-development ← Run tasks via parallel subagents\n  ├── /systematic-debugging       ← If issues arise\n  └── /test-driven-development    ← TDD per task\n  ↓\n/requesting-code-review           ← Review before done\n  ↓\n/verification-before-completion   ← Prove it works\n  ↓\n/finishing-a-development-branch   ← Merge, PR, or cleanup\n```\n\n## Edge Case Decision Trees\n\n### \"Debug this\" — Which Tool?\n\n```dot\ndigraph debug {\n    \"Bug reported\" [shape=doublecircle];\n    \"GSD active?\" [shape=diamond];\n    \"Bug related to current phase?\" [shape=diamond];\n    \"Will span multiple sessions?\" [shape=diamond];\n    \"/gsd:debug\" [shape=box, style=filled, fillcolor=lightblue];\n    \"/systematic-debugging\" [shape=box, style=filled, fillcolor=lightyellow];\n\n    \"Bug reported\" -> \"GSD active?\";\n    \"GSD active?\" -> \"Bug related to current phase?\" [label=\"yes\"];\n    \"GSD active?\" -> \"Will span multiple sessions?\" [label=\"no\"];\n    \"Bug related to current phase?\" -> \"/gsd:debug\" [label=\"yes\"];\n    \"Bug related to current phase?\" -> \"/systematic-debugging\\nthen /gsd:quick to commit\" [label=\"no\"];\n    \"Will span multiple sessions?\" -> \"/gsd:debug\" [label=\"yes, need persistence\"];\n    \"Will span multiple sessions?\" -> \"/systematic-debugging\" [label=\"no, fix it now\"];\n}\n```\n\n### \"Plan this\" — Which Tool?\n\n```dot\ndigraph plan {\n    \"Planning requested\" [shape=doublecircle];\n    \"GSD active?\" [shape=diamond];\n    \"Feature in roadmap?\" [shape=diamond];\n    \"/gsd:plan-phase N\" [shape=box, style=filled, fillcolor=lightblue];\n    \"/gsd:add-phase or /gsd:quick\" [shape=box, style=filled, fillcolor=lightcyan];\n    \"/brainstorming then /writing-plans\" [shape=box, style=filled, fillcolor=lightyellow];\n\n    \"Planning requested\" -> \"GSD active?\";\n    \"GSD active?\" -> \"Feature in roadmap?\" [label=\"yes\"];\n    \"GSD active?\" -> \"/brainstorming then /writing-plans\" [label=\"no\"];\n    \"Feature in roadmap?\" -> \"/gsd:plan-phase N\" [label=\"yes, phase N\"];\n    \"Feature in roadmap?\" -> \"/gsd:add-phase or /gsd:quick\" [label=\"no\"];\n}\n```\n\n### Scope Escalation (Superpowers → GSD)\n\nDuring `/brainstorming`, if scope grows beyond single-session:\n\n```\nDetection:\n  - 5+ independent subsystems identified\n  - 2+ weeks estimated work\n  - Multiple architectural decisions needed\n  - User says \"this is bigger than I thought\"\n\nAction:\n  \"This needs GSD's phase structure for persistence across sessions.\n   Ready to initialize /gsd:new-project with the spec we just brainstormed?\"\n\n  → Convert brainstorming output into GSD project input\n  → User confirms escalation\n```\n\n### User Picks Wrong Tool\n\n**User wants Superpowers for a large project:**\n> \"This sounds like it needs 5+ phases and multiple sessions. GSD would give you persistent state and milestone tracking. Want to use `/gsd:new-project` instead?\"\n\n**User wants GSD for a tiny task:**\n> \"This is small enough for a single session — GSD's ceremony would slow us down. Let's use `/brainstorming` → `/writing-plans` → `/executing-plans` instead.\"\n\n**Always respect the user's final choice.** Suggest, don't force.\n\n## Universal Rules (Both Toolchains)\n\n1. **Always `/brainstorming` before creative work** — regardless of GSD or Superpowers\n2. **Always `/verification-before-completion` before claiming done** — no exceptions\n3. **Always `/requesting-code-review` after significant implementation** — works in both contexts\n4. **Always `/test-driven-development` when writing code** — embedded discipline, not optional\n5. **Always `/systematic-debugging` before proposing fixes** — root cause first\n\n## Quick Reference: Command Mapping\n\n| Task | GSD Active | No GSD |\n|------|-----------|--------|\n| Design a feature | `/brainstorming` → `/gsd:plan-phase` | `/brainstorming` → `/writing-plans` |\n| Execute a plan | `/gsd:execute-phase N` | `/executing-plans` or `/subagent-driven-development` |\n| Fix a bug (small) | `/gsd:quick` | `/systematic-debugging` |\n| Fix a bug (complex) | `/gsd:debug` | `/systematic-debugging` |\n| Review code | `/requesting-code-review` | `/requesting-code-review` |\n| Verify work | `/gsd:verify-work N` | `/verification-before-completion` |\n| Check progress | `/gsd:progress` | N/A (session-scoped) |\n| Resume paused work | `/gsd:resume-work` | Re-read plan file |\n| Ad-hoc task | `/gsd:quick` | Direct Superpowers workflow |\n| Start new project | `/gsd:new-project` | `/brainstorming` → `/writing-plans` |\n\n## Red Flags — You're Routing Wrong\n\n| Symptom | Problem | Fix |\n|---------|---------|-----|\n| Using `/writing-plans` when `.planning/` exists | Bypassing GSD's plan structure | Use `/gsd:plan-phase` instead |\n| Using `/gsd:new-project` for a 1-hour task | Overkill, ceremony slows you down | Use Superpowers workflow |\n| Skipping `/brainstorming` because \"it's obvious\" | Hidden assumptions will bite you | Brainstorm first, always |\n| Fixing bugs without `/systematic-debugging` | Guessing instead of investigating | Root cause first |\n| Claiming \"done\" without verification evidence | No proof = no done | Run `/verification-before-completion` |\n| Using Superpowers for multi-week work | Context lost between sessions | Escalate to GSD |\n| Ignoring stale GSD project in directory | `.planning/` exists for a reason | Run `/gsd:progress` to check state |","tags":["workflow","routing","coco","rkz91","agent-skills","agents-md","ai-agents","claude-code","codex","cursor","developer-tools","llm-tools"],"capabilities":["skill","source-rkz91","skill-workflow-routing","topic-agent-skills","topic-agents-md","topic-ai-agents","topic-claude-code","topic-codex","topic-cursor","topic-developer-tools","topic-llm-tools","topic-mcp","topic-pm-tools","topic-product-management","topic-productivity"],"categories":["coco"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/rkz91/coco/workflow-routing","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add rkz91/coco","source_repo":"https://github.com/rkz91/coco","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 7 github stars · SKILL.md body (9,021 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:10.516Z","embedding":null,"createdAt":"2026-05-18T13:21:44.225Z","updatedAt":"2026-05-18T19:14:10.516Z","lastSeenAt":"2026-05-18T19:14:10.516Z","tsv":"'/brainstorming':366,382,460,656,678,712,838,859,917,922,997,1043 '/executing-plans':470,840,932 '/finishing-a-development-branch':497 '/gsd':208,217,273,283,356,387,395,404,433,447,534,575,586,596,632,643,648,686,698,703,755,808,918,927,939,946,955,963,972,985,993,1019,1025,1104 '/requesting-code-review':427,489,878,951,952 '/subagent-driven-development':475,934 '/systematic-debugging':415,481,542,584,606,898,941,948,1059 '/test-driven-development':421,485,888 '/verification-before-completion':441,493,870,960,1077 '/writing-plans':465,658,680,839,923,998,1009 '1':857,1031 '2':326,725,868 '3':876 '4':886 '5':721,791,896 '6':324 'across':750 'action':741 'activ':47,97,115,124,141,147,154,164,182,239,241,250,360,518,552,554,563,624,668,670,677,911 'ad':982 'ad-hoc':981 'add':337,645,700 'add-phas':644,699 'alway':842,858,869,877,887,897,1055 'announc':41 'app':304 'architectur':328,730 'aris':484 'assumpt':1049 'atom':413 'base':19,445 'beyond':716 'bigger':737 'bite':1051 'box':117,126,202,211,222,231,537,544,638,651,660 'brainstorm':764,766,1053 'break':466 'bug':336,418,513,521,549,555,570,579,937,944,1057 'build':303 'button':338 'bypass':1013 'case':503 'caus':903,1065 'ceremoni':830,1035 'check':80,98,961,1107 'choic':848 'claim':872,1067 'cleanup':501 'code':891,950 'combin':372 'command':18,89,200,264,907 'commit':414,589 'compet':79 'complementari':77 'complex':945 'confirm':773 'context':26,885,1085 'convert':765 'creat':305 'creativ':861 'current':100,187,244,259,269,524,558,573,582 'debug':62,506,512,535,576,597,947 'decid':371 'decis':173,329,504,731 'design':63,384,914 'detail':401 'detect':94,105,720 'diamond':109,113,184,191,197,520,527,533,626,631 'digraph':104,175,511,617 'direct':987 'directori':102,1097 'disciplin':893 'done':446,492,873,1068,1075 'dot':103,174,510,616 'doublecircl':180,516,622 'edg':502 'embed':892 'enough':823 'epic':318 'escal':708,774,1089 'estim':727 'everi':49 'evid':444,1071 'evidence-bas':443 'except':875 'execut':406,420,924,929 'execute-phas':405,928 'exist':107,111,132,134,138,145,151,1012,1099 'explor':461 'featur':325,627,671,683,695,916 'file':980 'fill':119,128,204,213,224,233,539,546,640,653,662 'fillcolor':120,129,205,214,225,234,540,547,641,654,663 'final':847 'fire':28,92 'first':93,367,904,1054,1066 'fix':335,348,609,901,935,942,1007,1056 'flag':1000 'forc':852 'function':340 'give':798 'grow':715 'gsd':17,40,65,88,96,114,122,139,146,152,163,181,199,238,240,249,263,314,323,334,359,378,391,400,409,438,449,517,551,553,562,623,667,669,676,710,744,769,796,815,828,865,910,913,1014,1091,1094 'guess':1060 'handl':56,66 'hidden':1048 'hoc':983 'hotfix':349 'hour':1032 'identifi':724 'ignor':1092 'implement':309,881 'independ':722 'indic':301 'initi':754 'input':771 'instal':36 'instead':812,841,1023,1061 'intent':462 'investig':1063 'invok':83 'issu':483 'label':135,142,148,161,247,255,265,275,287,296,560,568,577,590,598,607,674,681,691,705 'larg':784 'let':835 'level':59,69 'lightblu':121,206,226,541,642 'lightcyan':215,655 'lightyellow':130,235,548,664 'like':788 'lost':1086 'map':908 'merg':498 'method':342 'mileston':72,316,803 'move':431 'multi':194,253,280,291,312,321,332,375,1082 'multi-phas':193,252,279,290,311,320,331,374 'multi-week':1081 'multipl':530,566,594,604,729,794 'n':155,399,408,437,636,690,694,931,959 'n/a':965 'need':330,600,732,743,790 'never':78 'new':219,285,307,389,757,810,991,995,1027 'new-project':218,284,388,756,809,994,1026 'next':452 'nthen':585 'obvious':1047 'one':350 'option':895 'orchestr':70 'output':767 'overkil':1034 'parallel':479 'paus':970 'per':487 'persist':73,601,749,800 'phase':71,188,195,245,254,260,270,281,292,313,315,322,333,376,398,402,407,453,525,559,574,583,635,646,689,693,701,746,792,921,930,1022 'pick':776 'plan':106,131,137,386,397,403,612,618,619,634,665,688,920,926,979,1011,1016,1021,1098 'plan-phas':396,633,687,919,1020 'planning/project.md':166 'planning/roadmap.md':167 'planning/state.md':168 'platform':306 'pr':499 'pre':159 'pre-roadmap':158 'present':170 'primari':171 'problem':1006 'produc':463 'progress':448,962,964,1105 'project':21,68,220,286,308,377,390,392,758,770,785,811,992,996,1028,1095 'project-level':67 'proof':1073 'propos':900 'prove':494 'qualiti':60,381 'quick':209,274,347,357,587,649,704,905,940,986 're':977,1002 're-read':976 'read':978 'readi':752 'reason':1102 'receiv':178,237 'red':999 'refactor':341 'refer':906 'regardless':863 'relat':522,556,571,580 'releas':319 'report':514,550 'request':620,666 'respect':843 'resum':969,974 'resume-work':973 'review':64,429,490,949 'right':53 'roadmap':160,317,394,629,673,685,697 'roadmap.md':110,133,144,150 'root':902,1064 'rout':3,12,38,45,48,81,172,176,302,450,1003 'rule':854 'run':410,471,476,1076,1103 'say':734 'scope':24,189,192,246,251,261,271,278,289,298,362,369,707,714,968 'sequenti':473 'session':345,456,531,567,595,605,719,751,795,827,967,1088 'session-scop':966 'shape':108,112,116,125,179,183,190,196,201,210,221,230,515,519,526,532,536,543,621,625,630,637,650,659 'signal':27,165,299,300 'signific':880 'singl':344,455,718,826 'single-sess':343,454,717 'skill':15,31,46,86,91,229,295 'skill-workflow-routing' 'skip':1042 'slow':832,1036 'small':822,938 'small/ad-hoc':353 'small/unrelated':277 'sound':787 'source-rkz91' 'span':529,565,593,603 'spec':464,761 'stale':156,1093 'start':7,43,990 'state':22,74,801,1108 'structur':393,747,1017 'style':118,127,203,212,223,232,538,545,639,652,661 'subag':480 'subsystem':723 'suggest':216,282,849 'superpow':14,39,55,228,294,346,354,379,383,416,422,428,442,458,709,781,867,988,1040,1079 'symptom':1005 'system':34,310 'task':10,23,50,58,177,185,236,242,257,267,411,426,457,469,472,477,488,819,909,984,1033 'task-level':57 'tdd':61,423,468,486 'thing':352 'thought':740 'tini':818 'tool':509,615,778 'toolchain':54,856 'topic-agent-skills' 'topic-agents-md' 'topic-ai-agents' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-developer-tools' 'topic-llm-tools' 'topic-mcp' 'topic-pm-tools' 'topic-product-management' 'topic-productivity' 'track':804 'tree':505 'uat':439 'undetermin':365 'univers':853 'unknown':361 'unsur':364 'updat':339 'us':833 'use':4,198,207,227,262,272,293,807,837,1008,1018,1024,1039,1078 'user':363,733,772,775,779,813,845 'valid':440 'verif':1070 'verifi':435,953,957 'verify-work':434,956 'via':478 'want':780,805,814 'week':327,726,1083 'within':424 'without':1058,1069 'work':101,436,496,728,862,882,954,958,971,975,1084 'workflow':2,37,44,373,989,1041 'workflow-rout':1 'would':797,831 'write':890 'wrong':777,1004 'yes':136,149,248,266,288,561,578,599,675,692","prices":[{"id":"e652c9d0-a6e6-4815-93ff-a789efc0c569","listingId":"7b5d6fdb-7630-45ce-b41f-102d3d9d8905","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"rkz91","category":"coco","install_from":"skills.sh"},"createdAt":"2026-05-18T13:21:44.225Z"}],"sources":[{"listingId":"7b5d6fdb-7630-45ce-b41f-102d3d9d8905","source":"github","sourceId":"rkz91/coco/workflow-routing","sourceUrl":"https://github.com/rkz91/coco/tree/main/skills/workflow-routing","isPrimary":false,"firstSeenAt":"2026-05-18T13:21:44.225Z","lastSeenAt":"2026-05-18T19:14:10.516Z"}],"details":{"listingId":"7b5d6fdb-7630-45ce-b41f-102d3d9d8905","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"rkz91","slug":"workflow-routing","github":{"repo":"rkz91/coco","stars":7,"topics":["agent-skills","agents-md","ai","ai-agents","claude-code","codex","cursor","developer-tools","llm-tools","mcp","pm-tools","product-management","productivity","prompt-engineering","workflow-automation"],"license":"mit","html_url":"https://github.com/rkz91/coco","pushed_at":"2026-04-26T01:51:27Z","description":"Open-source library of AI superpowers — 59 skills, 34 commands, 10 agents + 24 GSD subagents, 3 system bundles. An entire team, wherever your AI lives. Vendor-neutral across Claude Code, Cursor, Codex, and any AGENTS.md tool.","skill_md_sha":"4577e84a84d8ebd793933e1b989fa866124f476d","skill_md_path":"skills/workflow-routing/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/rkz91/coco/tree/main/skills/workflow-routing"},"layout":"multi","source":"github","category":"coco","frontmatter":{"name":"workflow-routing","description":"Use at the start of any task to route between Superpowers skills and GSD commands based on project state, task scope, and context signals. Fires before other skills when both systems are installed."},"skills_sh_url":"https://skills.sh/rkz91/coco/workflow-routing"},"updatedAt":"2026-05-18T19:14:10.516Z"}}