@minhduydev/mdpi 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (561) hide show
  1. package/README.md +31 -0
  2. package/dist/index.js +1187 -0
  3. package/dist/template/.pi/.env.example +28 -0
  4. package/dist/template/.pi/AGENTS.md +226 -0
  5. package/dist/template/.pi/QUALITY.md +13 -0
  6. package/dist/template/.pi/README.md +452 -0
  7. package/dist/template/.pi/VERSION +1 -0
  8. package/dist/template/.pi/agents/INDEX.md +54 -0
  9. package/dist/template/.pi/agents/build.md +194 -0
  10. package/dist/template/.pi/agents/explore.md +85 -0
  11. package/dist/template/.pi/agents/general.md +189 -0
  12. package/dist/template/.pi/agents/plan.md +407 -0
  13. package/dist/template/.pi/agents/review.md +198 -0
  14. package/dist/template/.pi/agents/scout.md +142 -0
  15. package/dist/template/.pi/agents/vision.md +157 -0
  16. package/dist/template/.pi/artifacts/example/plan.md +12 -0
  17. package/dist/template/.pi/artifacts/example/progress.md +4 -0
  18. package/dist/template/.pi/artifacts/example/research.md +4 -0
  19. package/dist/template/.pi/artifacts/example/spec.md +16 -0
  20. package/dist/template/.pi/context/architecture.md +141 -0
  21. package/dist/template/.pi/context/fallow.md +137 -0
  22. package/dist/template/.pi/extensions/templates-injector.ts +76 -0
  23. package/dist/template/.pi/extensions/workflows-runner.ts +301 -0
  24. package/dist/template/.pi/guard.example.json +75 -0
  25. package/dist/template/.pi/prompts/INDEX.md +78 -0
  26. package/dist/template/.pi/prompts/audit.md +109 -0
  27. package/dist/template/.pi/prompts/close.md +88 -0
  28. package/dist/template/.pi/prompts/create.md +197 -0
  29. package/dist/template/.pi/prompts/fix.md +117 -0
  30. package/dist/template/.pi/prompts/gc.md +112 -0
  31. package/dist/template/.pi/prompts/init.md +206 -0
  32. package/dist/template/.pi/prompts/loop-check.md +87 -0
  33. package/dist/template/.pi/prompts/loop-init.md +157 -0
  34. package/dist/template/.pi/prompts/loop-review.md +90 -0
  35. package/dist/template/.pi/prompts/plan.md +254 -0
  36. package/dist/template/.pi/prompts/research.md +136 -0
  37. package/dist/template/.pi/prompts/ship.md +219 -0
  38. package/dist/template/.pi/prompts/status.md +92 -0
  39. package/dist/template/.pi/prompts/verify.md +154 -0
  40. package/dist/template/.pi/scripts/gc-check.sh +86 -0
  41. package/dist/template/.pi/settings.json +15 -0
  42. package/dist/template/.pi/skills/INDEX.md +331 -0
  43. package/dist/template/.pi/skills/accessibility-audit/SKILL.md +205 -0
  44. package/dist/template/.pi/skills/accessibility-audit/references/accessibility-checklist.md +109 -0
  45. package/dist/template/.pi/skills/agent-code-quality-gate/SKILL.md +131 -0
  46. package/dist/template/.pi/skills/api-and-interface-design/SKILL.md +159 -0
  47. package/dist/template/.pi/skills/behavioral-kernel/SKILL.md +92 -0
  48. package/dist/template/.pi/skills/brainstorming/SKILL.md +138 -0
  49. package/dist/template/.pi/skills/browser-testing-with-devtools/SKILL.md +90 -0
  50. package/dist/template/.pi/skills/chrome-devtools/SKILL.md +129 -0
  51. package/dist/template/.pi/skills/ci-cd-and-automation/SKILL.md +199 -0
  52. package/dist/template/.pi/skills/cloudflare/SKILL.md +271 -0
  53. package/dist/template/.pi/skills/cloudflare/references/agents-sdk/README.md +35 -0
  54. package/dist/template/.pi/skills/cloudflare/references/agents-sdk/api.md +100 -0
  55. package/dist/template/.pi/skills/cloudflare/references/agents-sdk/configuration.md +99 -0
  56. package/dist/template/.pi/skills/cloudflare/references/agents-sdk/gotchas.md +59 -0
  57. package/dist/template/.pi/skills/cloudflare/references/agents-sdk/patterns.md +89 -0
  58. package/dist/template/.pi/skills/cloudflare/references/ai-gateway/README.md +695 -0
  59. package/dist/template/.pi/skills/cloudflare/references/ai-search/README.md +14 -0
  60. package/dist/template/.pi/skills/cloudflare/references/ai-search/api.md +38 -0
  61. package/dist/template/.pi/skills/cloudflare/references/ai-search/configuration.md +52 -0
  62. package/dist/template/.pi/skills/cloudflare/references/ai-search/gotchas.md +41 -0
  63. package/dist/template/.pi/skills/cloudflare/references/ai-search/patterns.md +45 -0
  64. package/dist/template/.pi/skills/cloudflare/references/analytics-engine/README.md +14 -0
  65. package/dist/template/.pi/skills/cloudflare/references/analytics-engine/api.md +27 -0
  66. package/dist/template/.pi/skills/cloudflare/references/analytics-engine/configuration.md +45 -0
  67. package/dist/template/.pi/skills/cloudflare/references/analytics-engine/gotchas.md +3 -0
  68. package/dist/template/.pi/skills/cloudflare/references/analytics-engine/patterns.md +36 -0
  69. package/dist/template/.pi/skills/cloudflare/references/api/README.md +21 -0
  70. package/dist/template/.pi/skills/cloudflare/references/api/api.md +31 -0
  71. package/dist/template/.pi/skills/cloudflare/references/api/configuration.md +20 -0
  72. package/dist/template/.pi/skills/cloudflare/references/api/gotchas.md +28 -0
  73. package/dist/template/.pi/skills/cloudflare/references/api/patterns.md +47 -0
  74. package/dist/template/.pi/skills/cloudflare/references/api-shield/README.md +20 -0
  75. package/dist/template/.pi/skills/cloudflare/references/api-shield/api.md +78 -0
  76. package/dist/template/.pi/skills/cloudflare/references/api-shield/configuration.md +128 -0
  77. package/dist/template/.pi/skills/cloudflare/references/api-shield/gotchas.md +51 -0
  78. package/dist/template/.pi/skills/cloudflare/references/api-shield/patterns.md +145 -0
  79. package/dist/template/.pi/skills/cloudflare/references/argo-smart-routing/README.md +16 -0
  80. package/dist/template/.pi/skills/cloudflare/references/argo-smart-routing/api.md +50 -0
  81. package/dist/template/.pi/skills/cloudflare/references/argo-smart-routing/configuration.md +53 -0
  82. package/dist/template/.pi/skills/cloudflare/references/argo-smart-routing/gotchas.md +16 -0
  83. package/dist/template/.pi/skills/cloudflare/references/argo-smart-routing/patterns.md +45 -0
  84. package/dist/template/.pi/skills/cloudflare/references/bindings/README.md +14 -0
  85. package/dist/template/.pi/skills/cloudflare/references/bindings/api.md +3 -0
  86. package/dist/template/.pi/skills/cloudflare/references/bindings/configuration.md +58 -0
  87. package/dist/template/.pi/skills/cloudflare/references/bindings/gotchas.md +35 -0
  88. package/dist/template/.pi/skills/cloudflare/references/bindings/patterns.md +37 -0
  89. package/dist/template/.pi/skills/cloudflare/references/bot-management/README.md +71 -0
  90. package/dist/template/.pi/skills/cloudflare/references/bot-management/api.md +168 -0
  91. package/dist/template/.pi/skills/cloudflare/references/bot-management/configuration.md +114 -0
  92. package/dist/template/.pi/skills/cloudflare/references/bot-management/gotchas.md +99 -0
  93. package/dist/template/.pi/skills/cloudflare/references/bot-management/patterns.md +125 -0
  94. package/dist/template/.pi/skills/cloudflare/references/browser-rendering/README.md +16 -0
  95. package/dist/template/.pi/skills/cloudflare/references/browser-rendering/api.md +54 -0
  96. package/dist/template/.pi/skills/cloudflare/references/browser-rendering/configuration.md +47 -0
  97. package/dist/template/.pi/skills/cloudflare/references/browser-rendering/gotchas.md +29 -0
  98. package/dist/template/.pi/skills/cloudflare/references/browser-rendering/patterns.md +29 -0
  99. package/dist/template/.pi/skills/cloudflare/references/c3/README.md +264 -0
  100. package/dist/template/.pi/skills/cloudflare/references/cache-reserve/README.md +93 -0
  101. package/dist/template/.pi/skills/cloudflare/references/cache-reserve/api.md +176 -0
  102. package/dist/template/.pi/skills/cloudflare/references/cache-reserve/configuration.md +164 -0
  103. package/dist/template/.pi/skills/cloudflare/references/cache-reserve/gotchas.md +203 -0
  104. package/dist/template/.pi/skills/cloudflare/references/cache-reserve/patterns.md +180 -0
  105. package/dist/template/.pi/skills/cloudflare/references/containers/README.md +16 -0
  106. package/dist/template/.pi/skills/cloudflare/references/containers/api.md +43 -0
  107. package/dist/template/.pi/skills/cloudflare/references/containers/configuration.md +56 -0
  108. package/dist/template/.pi/skills/cloudflare/references/containers/gotchas.md +21 -0
  109. package/dist/template/.pi/skills/cloudflare/references/containers/patterns.md +40 -0
  110. package/dist/template/.pi/skills/cloudflare/references/cron-triggers/README.md +85 -0
  111. package/dist/template/.pi/skills/cloudflare/references/cron-triggers/api.md +198 -0
  112. package/dist/template/.pi/skills/cloudflare/references/cron-triggers/configuration.md +151 -0
  113. package/dist/template/.pi/skills/cloudflare/references/cron-triggers/gotchas.md +129 -0
  114. package/dist/template/.pi/skills/cloudflare/references/cron-triggers/patterns.md +122 -0
  115. package/dist/template/.pi/skills/cloudflare/references/d1/README.md +92 -0
  116. package/dist/template/.pi/skills/cloudflare/references/d1/api.md +141 -0
  117. package/dist/template/.pi/skills/cloudflare/references/d1/configuration.md +127 -0
  118. package/dist/template/.pi/skills/cloudflare/references/d1/gotchas.md +70 -0
  119. package/dist/template/.pi/skills/cloudflare/references/d1/patterns.md +144 -0
  120. package/dist/template/.pi/skills/cloudflare/references/ddos/README.md +34 -0
  121. package/dist/template/.pi/skills/cloudflare/references/ddos/api.md +136 -0
  122. package/dist/template/.pi/skills/cloudflare/references/ddos/configuration.md +67 -0
  123. package/dist/template/.pi/skills/cloudflare/references/ddos/gotchas.md +114 -0
  124. package/dist/template/.pi/skills/cloudflare/references/ddos/patterns.md +158 -0
  125. package/dist/template/.pi/skills/cloudflare/references/do-storage/README.md +62 -0
  126. package/dist/template/.pi/skills/cloudflare/references/do-storage/api.md +89 -0
  127. package/dist/template/.pi/skills/cloudflare/references/do-storage/configuration.md +116 -0
  128. package/dist/template/.pi/skills/cloudflare/references/do-storage/gotchas.md +93 -0
  129. package/dist/template/.pi/skills/cloudflare/references/do-storage/patterns.md +112 -0
  130. package/dist/template/.pi/skills/cloudflare/references/durable-objects/README.md +125 -0
  131. package/dist/template/.pi/skills/cloudflare/references/durable-objects/api.md +152 -0
  132. package/dist/template/.pi/skills/cloudflare/references/durable-objects/configuration.md +148 -0
  133. package/dist/template/.pi/skills/cloudflare/references/durable-objects/gotchas.md +158 -0
  134. package/dist/template/.pi/skills/cloudflare/references/durable-objects/patterns.md +255 -0
  135. package/dist/template/.pi/skills/cloudflare/references/email-routing/README.md +18 -0
  136. package/dist/template/.pi/skills/cloudflare/references/email-routing/api.md +46 -0
  137. package/dist/template/.pi/skills/cloudflare/references/email-routing/configuration.md +63 -0
  138. package/dist/template/.pi/skills/cloudflare/references/email-routing/gotchas.md +16 -0
  139. package/dist/template/.pi/skills/cloudflare/references/email-routing/patterns.md +46 -0
  140. package/dist/template/.pi/skills/cloudflare/references/email-workers/README.md +598 -0
  141. package/dist/template/.pi/skills/cloudflare/references/hyperdrive/README.md +62 -0
  142. package/dist/template/.pi/skills/cloudflare/references/hyperdrive/api.md +137 -0
  143. package/dist/template/.pi/skills/cloudflare/references/hyperdrive/configuration.md +133 -0
  144. package/dist/template/.pi/skills/cloudflare/references/hyperdrive/gotchas.md +184 -0
  145. package/dist/template/.pi/skills/cloudflare/references/hyperdrive/patterns.md +176 -0
  146. package/dist/template/.pi/skills/cloudflare/references/images/README.md +14 -0
  147. package/dist/template/.pi/skills/cloudflare/references/images/api.md +3 -0
  148. package/dist/template/.pi/skills/cloudflare/references/images/configuration.md +45 -0
  149. package/dist/template/.pi/skills/cloudflare/references/images/gotchas.md +23 -0
  150. package/dist/template/.pi/skills/cloudflare/references/images/patterns.md +31 -0
  151. package/dist/template/.pi/skills/cloudflare/references/kv/README.md +60 -0
  152. package/dist/template/.pi/skills/cloudflare/references/kv/api.md +114 -0
  153. package/dist/template/.pi/skills/cloudflare/references/kv/configuration.md +92 -0
  154. package/dist/template/.pi/skills/cloudflare/references/kv/gotchas.md +117 -0
  155. package/dist/template/.pi/skills/cloudflare/references/kv/patterns.md +139 -0
  156. package/dist/template/.pi/skills/cloudflare/references/miniflare/README.md +64 -0
  157. package/dist/template/.pi/skills/cloudflare/references/miniflare/api.md +144 -0
  158. package/dist/template/.pi/skills/cloudflare/references/miniflare/configuration.md +203 -0
  159. package/dist/template/.pi/skills/cloudflare/references/miniflare/gotchas.md +187 -0
  160. package/dist/template/.pi/skills/cloudflare/references/miniflare/patterns.md +211 -0
  161. package/dist/template/.pi/skills/cloudflare/references/network-interconnect/README.md +60 -0
  162. package/dist/template/.pi/skills/cloudflare/references/network-interconnect/api.md +240 -0
  163. package/dist/template/.pi/skills/cloudflare/references/network-interconnect/configuration.md +127 -0
  164. package/dist/template/.pi/skills/cloudflare/references/network-interconnect/gotchas.md +171 -0
  165. package/dist/template/.pi/skills/cloudflare/references/network-interconnect/patterns.md +171 -0
  166. package/dist/template/.pi/skills/cloudflare/references/observability/README.md +18 -0
  167. package/dist/template/.pi/skills/cloudflare/references/observability/api.md +51 -0
  168. package/dist/template/.pi/skills/cloudflare/references/observability/configuration.md +60 -0
  169. package/dist/template/.pi/skills/cloudflare/references/observability/gotchas.md +36 -0
  170. package/dist/template/.pi/skills/cloudflare/references/observability/patterns.md +42 -0
  171. package/dist/template/.pi/skills/cloudflare/references/pages/README.md +76 -0
  172. package/dist/template/.pi/skills/cloudflare/references/pages/api.md +200 -0
  173. package/dist/template/.pi/skills/cloudflare/references/pages/configuration.md +228 -0
  174. package/dist/template/.pi/skills/cloudflare/references/pages/gotchas.md +161 -0
  175. package/dist/template/.pi/skills/cloudflare/references/pages/patterns.md +145 -0
  176. package/dist/template/.pi/skills/cloudflare/references/pages-functions/README.md +57 -0
  177. package/dist/template/.pi/skills/cloudflare/references/pages-functions/api.md +201 -0
  178. package/dist/template/.pi/skills/cloudflare/references/pages-functions/configuration.md +159 -0
  179. package/dist/template/.pi/skills/cloudflare/references/pages-functions/gotchas.md +151 -0
  180. package/dist/template/.pi/skills/cloudflare/references/pages-functions/patterns.md +190 -0
  181. package/dist/template/.pi/skills/cloudflare/references/pipelines/README.md +664 -0
  182. package/dist/template/.pi/skills/cloudflare/references/pulumi/README.md +107 -0
  183. package/dist/template/.pi/skills/cloudflare/references/pulumi/api.md +194 -0
  184. package/dist/template/.pi/skills/cloudflare/references/pulumi/configuration.md +216 -0
  185. package/dist/template/.pi/skills/cloudflare/references/pulumi/gotchas.md +223 -0
  186. package/dist/template/.pi/skills/cloudflare/references/pulumi/patterns.md +139 -0
  187. package/dist/template/.pi/skills/cloudflare/references/queues/README.md +69 -0
  188. package/dist/template/.pi/skills/cloudflare/references/queues/api.md +138 -0
  189. package/dist/template/.pi/skills/cloudflare/references/queues/configuration.md +125 -0
  190. package/dist/template/.pi/skills/cloudflare/references/queues/gotchas.md +112 -0
  191. package/dist/template/.pi/skills/cloudflare/references/queues/patterns.md +155 -0
  192. package/dist/template/.pi/skills/cloudflare/references/r2/README.md +61 -0
  193. package/dist/template/.pi/skills/cloudflare/references/r2/api.md +127 -0
  194. package/dist/template/.pi/skills/cloudflare/references/r2/configuration.md +76 -0
  195. package/dist/template/.pi/skills/cloudflare/references/r2/gotchas.md +94 -0
  196. package/dist/template/.pi/skills/cloudflare/references/r2/patterns.md +127 -0
  197. package/dist/template/.pi/skills/cloudflare/references/r2-data-catalog/README.md +18 -0
  198. package/dist/template/.pi/skills/cloudflare/references/r2-data-catalog/api.md +29 -0
  199. package/dist/template/.pi/skills/cloudflare/references/r2-data-catalog/configuration.md +39 -0
  200. package/dist/template/.pi/skills/cloudflare/references/r2-data-catalog/gotchas.md +20 -0
  201. package/dist/template/.pi/skills/cloudflare/references/r2-data-catalog/patterns.md +46 -0
  202. package/dist/template/.pi/skills/cloudflare/references/r2-sql/README.md +512 -0
  203. package/dist/template/.pi/skills/cloudflare/references/realtime-sfu/README.md +21 -0
  204. package/dist/template/.pi/skills/cloudflare/references/realtime-sfu/api.md +135 -0
  205. package/dist/template/.pi/skills/cloudflare/references/realtime-sfu/configuration.md +63 -0
  206. package/dist/template/.pi/skills/cloudflare/references/realtime-sfu/gotchas.md +75 -0
  207. package/dist/template/.pi/skills/cloudflare/references/realtime-sfu/patterns.md +102 -0
  208. package/dist/template/.pi/skills/cloudflare/references/realtimekit/README.md +81 -0
  209. package/dist/template/.pi/skills/cloudflare/references/realtimekit/api.md +164 -0
  210. package/dist/template/.pi/skills/cloudflare/references/realtimekit/configuration.md +147 -0
  211. package/dist/template/.pi/skills/cloudflare/references/realtimekit/gotchas.md +172 -0
  212. package/dist/template/.pi/skills/cloudflare/references/realtimekit/patterns.md +155 -0
  213. package/dist/template/.pi/skills/cloudflare/references/sandbox/README.md +90 -0
  214. package/dist/template/.pi/skills/cloudflare/references/sandbox/api.md +178 -0
  215. package/dist/template/.pi/skills/cloudflare/references/sandbox/configuration.md +131 -0
  216. package/dist/template/.pi/skills/cloudflare/references/sandbox/gotchas.md +156 -0
  217. package/dist/template/.pi/skills/cloudflare/references/sandbox/patterns.md +203 -0
  218. package/dist/template/.pi/skills/cloudflare/references/secrets-store/README.md +58 -0
  219. package/dist/template/.pi/skills/cloudflare/references/secrets-store/api.md +182 -0
  220. package/dist/template/.pi/skills/cloudflare/references/secrets-store/configuration.md +140 -0
  221. package/dist/template/.pi/skills/cloudflare/references/secrets-store/gotchas.md +129 -0
  222. package/dist/template/.pi/skills/cloudflare/references/secrets-store/patterns.md +218 -0
  223. package/dist/template/.pi/skills/cloudflare/references/smart-placement/README.md +91 -0
  224. package/dist/template/.pi/skills/cloudflare/references/smart-placement/api.md +139 -0
  225. package/dist/template/.pi/skills/cloudflare/references/smart-placement/configuration.md +129 -0
  226. package/dist/template/.pi/skills/cloudflare/references/smart-placement/gotchas.md +87 -0
  227. package/dist/template/.pi/skills/cloudflare/references/smart-placement/patterns.md +135 -0
  228. package/dist/template/.pi/skills/cloudflare/references/snippets/README.md +15 -0
  229. package/dist/template/.pi/skills/cloudflare/references/snippets/api.md +47 -0
  230. package/dist/template/.pi/skills/cloudflare/references/snippets/configuration.md +33 -0
  231. package/dist/template/.pi/skills/cloudflare/references/snippets/gotchas.md +21 -0
  232. package/dist/template/.pi/skills/cloudflare/references/snippets/patterns.md +34 -0
  233. package/dist/template/.pi/skills/cloudflare/references/spectrum/README.md +16 -0
  234. package/dist/template/.pi/skills/cloudflare/references/spectrum/api.md +24 -0
  235. package/dist/template/.pi/skills/cloudflare/references/spectrum/configuration.md +43 -0
  236. package/dist/template/.pi/skills/cloudflare/references/spectrum/gotchas.md +42 -0
  237. package/dist/template/.pi/skills/cloudflare/references/spectrum/patterns.md +40 -0
  238. package/dist/template/.pi/skills/cloudflare/references/static-assets/README.md +14 -0
  239. package/dist/template/.pi/skills/cloudflare/references/static-assets/api.md +3 -0
  240. package/dist/template/.pi/skills/cloudflare/references/static-assets/configuration.md +47 -0
  241. package/dist/template/.pi/skills/cloudflare/references/static-assets/gotchas.md +44 -0
  242. package/dist/template/.pi/skills/cloudflare/references/static-assets/patterns.md +42 -0
  243. package/dist/template/.pi/skills/cloudflare/references/stream/README.md +103 -0
  244. package/dist/template/.pi/skills/cloudflare/references/stream/api.md +204 -0
  245. package/dist/template/.pi/skills/cloudflare/references/stream/configuration.md +127 -0
  246. package/dist/template/.pi/skills/cloudflare/references/stream/gotchas.md +131 -0
  247. package/dist/template/.pi/skills/cloudflare/references/stream/patterns.md +152 -0
  248. package/dist/template/.pi/skills/cloudflare/references/tail-workers/README.md +640 -0
  249. package/dist/template/.pi/skills/cloudflare/references/terraform/README.md +76 -0
  250. package/dist/template/.pi/skills/cloudflare/references/terraform/api.md +159 -0
  251. package/dist/template/.pi/skills/cloudflare/references/terraform/configuration.md +156 -0
  252. package/dist/template/.pi/skills/cloudflare/references/terraform/gotchas.md +207 -0
  253. package/dist/template/.pi/skills/cloudflare/references/terraform/patterns.md +135 -0
  254. package/dist/template/.pi/skills/cloudflare/references/tunnel/README.md +82 -0
  255. package/dist/template/.pi/skills/cloudflare/references/tunnel/api.md +105 -0
  256. package/dist/template/.pi/skills/cloudflare/references/tunnel/configuration.md +113 -0
  257. package/dist/template/.pi/skills/cloudflare/references/tunnel/gotchas.md +115 -0
  258. package/dist/template/.pi/skills/cloudflare/references/tunnel/patterns.md +157 -0
  259. package/dist/template/.pi/skills/cloudflare/references/turn/README.md +699 -0
  260. package/dist/template/.pi/skills/cloudflare/references/turnstile/README.md +14 -0
  261. package/dist/template/.pi/skills/cloudflare/references/turnstile/api.md +3 -0
  262. package/dist/template/.pi/skills/cloudflare/references/turnstile/configuration.md +19 -0
  263. package/dist/template/.pi/skills/cloudflare/references/turnstile/gotchas.md +27 -0
  264. package/dist/template/.pi/skills/cloudflare/references/turnstile/patterns.md +41 -0
  265. package/dist/template/.pi/skills/cloudflare/references/vectorize/README.md +682 -0
  266. package/dist/template/.pi/skills/cloudflare/references/waf/README.md +14 -0
  267. package/dist/template/.pi/skills/cloudflare/references/waf/api.md +3 -0
  268. package/dist/template/.pi/skills/cloudflare/references/waf/configuration.md +44 -0
  269. package/dist/template/.pi/skills/cloudflare/references/waf/gotchas.md +24 -0
  270. package/dist/template/.pi/skills/cloudflare/references/waf/patterns.md +29 -0
  271. package/dist/template/.pi/skills/cloudflare/references/web-analytics/README.md +19 -0
  272. package/dist/template/.pi/skills/cloudflare/references/web-analytics/api.md +52 -0
  273. package/dist/template/.pi/skills/cloudflare/references/web-analytics/configuration.md +31 -0
  274. package/dist/template/.pi/skills/cloudflare/references/web-analytics/gotchas.md +28 -0
  275. package/dist/template/.pi/skills/cloudflare/references/web-analytics/patterns.md +52 -0
  276. package/dist/template/.pi/skills/cloudflare/references/workerd/README.md +47 -0
  277. package/dist/template/.pi/skills/cloudflare/references/workerd/api.md +199 -0
  278. package/dist/template/.pi/skills/cloudflare/references/workerd/configuration.md +185 -0
  279. package/dist/template/.pi/skills/cloudflare/references/workerd/gotchas.md +203 -0
  280. package/dist/template/.pi/skills/cloudflare/references/workerd/patterns.md +216 -0
  281. package/dist/template/.pi/skills/cloudflare/references/workers/README.md +96 -0
  282. package/dist/template/.pi/skills/cloudflare/references/workers/api.md +137 -0
  283. package/dist/template/.pi/skills/cloudflare/references/workers/configuration.md +147 -0
  284. package/dist/template/.pi/skills/cloudflare/references/workers/gotchas.md +99 -0
  285. package/dist/template/.pi/skills/cloudflare/references/workers/patterns.md +149 -0
  286. package/dist/template/.pi/skills/cloudflare/references/workers-ai/README.md +116 -0
  287. package/dist/template/.pi/skills/cloudflare/references/workers-for-platforms/README.md +48 -0
  288. package/dist/template/.pi/skills/cloudflare/references/workers-for-platforms/api.md +169 -0
  289. package/dist/template/.pi/skills/cloudflare/references/workers-for-platforms/configuration.md +136 -0
  290. package/dist/template/.pi/skills/cloudflare/references/workers-for-platforms/gotchas.md +130 -0
  291. package/dist/template/.pi/skills/cloudflare/references/workers-for-platforms/patterns.md +170 -0
  292. package/dist/template/.pi/skills/cloudflare/references/workers-playground/README.md +16 -0
  293. package/dist/template/.pi/skills/cloudflare/references/workers-playground/api.md +20 -0
  294. package/dist/template/.pi/skills/cloudflare/references/workers-playground/configuration.md +3 -0
  295. package/dist/template/.pi/skills/cloudflare/references/workers-playground/gotchas.md +35 -0
  296. package/dist/template/.pi/skills/cloudflare/references/workers-playground/patterns.md +42 -0
  297. package/dist/template/.pi/skills/cloudflare/references/workers-vpc/README.md +579 -0
  298. package/dist/template/.pi/skills/cloudflare/references/workflows/README.md +62 -0
  299. package/dist/template/.pi/skills/cloudflare/references/workflows/api.md +125 -0
  300. package/dist/template/.pi/skills/cloudflare/references/workflows/configuration.md +177 -0
  301. package/dist/template/.pi/skills/cloudflare/references/workflows/gotchas.md +136 -0
  302. package/dist/template/.pi/skills/cloudflare/references/workflows/patterns.md +132 -0
  303. package/dist/template/.pi/skills/cloudflare/references/wrangler/README.md +90 -0
  304. package/dist/template/.pi/skills/cloudflare/references/wrangler/api.md +140 -0
  305. package/dist/template/.pi/skills/cloudflare/references/wrangler/configuration.md +128 -0
  306. package/dist/template/.pi/skills/cloudflare/references/wrangler/gotchas.md +93 -0
  307. package/dist/template/.pi/skills/cloudflare/references/wrangler/patterns.md +150 -0
  308. package/dist/template/.pi/skills/cloudflare/references/zaraz/README.md +360 -0
  309. package/dist/template/.pi/skills/code-cleanup/SKILL.md +232 -0
  310. package/dist/template/.pi/skills/code-review-and-quality/SKILL.md +344 -0
  311. package/dist/template/.pi/skills/code-simplification/SKILL.md +348 -0
  312. package/dist/template/.pi/skills/context-engineering/SKILL.md +296 -0
  313. package/dist/template/.pi/skills/core-data-expert/SKILL.md +117 -0
  314. package/dist/template/.pi/skills/core-data-expert/references/batch-operations.md +543 -0
  315. package/dist/template/.pi/skills/core-data-expert/references/cloudkit-integration.md +259 -0
  316. package/dist/template/.pi/skills/core-data-expert/references/concurrency.md +522 -0
  317. package/dist/template/.pi/skills/core-data-expert/references/fetch-requests.md +643 -0
  318. package/dist/template/.pi/skills/core-data-expert/references/glossary.md +233 -0
  319. package/dist/template/.pi/skills/core-data-expert/references/migration.md +393 -0
  320. package/dist/template/.pi/skills/core-data-expert/references/model-configuration.md +597 -0
  321. package/dist/template/.pi/skills/core-data-expert/references/performance.md +300 -0
  322. package/dist/template/.pi/skills/core-data-expert/references/persistent-history.md +553 -0
  323. package/dist/template/.pi/skills/core-data-expert/references/project-audit.md +60 -0
  324. package/dist/template/.pi/skills/core-data-expert/references/saving.md +574 -0
  325. package/dist/template/.pi/skills/core-data-expert/references/stack-setup.md +625 -0
  326. package/dist/template/.pi/skills/core-data-expert/references/testing.md +300 -0
  327. package/dist/template/.pi/skills/core-data-expert/references/threading.md +589 -0
  328. package/dist/template/.pi/skills/debugging-and-error-recovery/SKILL.md +274 -0
  329. package/dist/template/.pi/skills/deep-module-design/SKILL.md +218 -0
  330. package/dist/template/.pi/skills/defense-in-depth/SKILL.md +161 -0
  331. package/dist/template/.pi/skills/deprecation-and-migration/SKILL.md +186 -0
  332. package/dist/template/.pi/skills/design-system-audit/SKILL.md +176 -0
  333. package/dist/template/.pi/skills/design-taste-frontend/SKILL.md +255 -0
  334. package/dist/template/.pi/skills/development-lifecycle/SKILL.md +285 -0
  335. package/dist/template/.pi/skills/documentation-and-adrs/SKILL.md +217 -0
  336. package/dist/template/.pi/skills/doubt-driven-development/SKILL.md +207 -0
  337. package/dist/template/.pi/skills/fallow/SKILL.md +457 -0
  338. package/dist/template/.pi/skills/fallow/references/cli-reference.md +1905 -0
  339. package/dist/template/.pi/skills/fallow/references/gotchas.md +644 -0
  340. package/dist/template/.pi/skills/fallow/references/patterns.md +791 -0
  341. package/dist/template/.pi/skills/figma/SKILL.md +241 -0
  342. package/dist/template/.pi/skills/frontend-design/SKILL.md +262 -0
  343. package/dist/template/.pi/skills/frontend-design/references/animation/motion-advanced.md +224 -0
  344. package/dist/template/.pi/skills/frontend-design/references/animation/motion-core.md +181 -0
  345. package/dist/template/.pi/skills/frontend-design/references/canvas/execution.md +90 -0
  346. package/dist/template/.pi/skills/frontend-design/references/canvas/philosophy.md +94 -0
  347. package/dist/template/.pi/skills/frontend-design/references/design/color-system.md +111 -0
  348. package/dist/template/.pi/skills/frontend-design/references/design/interaction.md +149 -0
  349. package/dist/template/.pi/skills/frontend-design/references/design/typography-rules.md +106 -0
  350. package/dist/template/.pi/skills/frontend-design/references/design/ux-writing.md +99 -0
  351. package/dist/template/.pi/skills/frontend-design/references/shadcn/accessibility.md +132 -0
  352. package/dist/template/.pi/skills/frontend-design/references/shadcn/core-components.md +153 -0
  353. package/dist/template/.pi/skills/frontend-design/references/shadcn/form-components.md +158 -0
  354. package/dist/template/.pi/skills/frontend-design/references/shadcn/setup.md +69 -0
  355. package/dist/template/.pi/skills/frontend-design/references/shadcn/theming.md +152 -0
  356. package/dist/template/.pi/skills/frontend-design/references/tailwind/responsive.md +112 -0
  357. package/dist/template/.pi/skills/frontend-design/references/tailwind/utilities-layout.md +134 -0
  358. package/dist/template/.pi/skills/frontend-design/references/tailwind/utilities-styling.md +165 -0
  359. package/dist/template/.pi/skills/frontend-design/references/tailwind/v4-config.md +147 -0
  360. package/dist/template/.pi/skills/frontend-design/references/tailwind/v4-features.md +128 -0
  361. package/dist/template/.pi/skills/frontend-ui-engineering/SKILL.md +217 -0
  362. package/dist/template/.pi/skills/gemini-large-context/SKILL.md +238 -0
  363. package/dist/template/.pi/skills/git-workflow-and-versioning/SKILL.md +217 -0
  364. package/dist/template/.pi/skills/grill-me/SKILL.md +162 -0
  365. package/dist/template/.pi/skills/high-end-visual-design/SKILL.md +128 -0
  366. package/dist/template/.pi/skills/idea-refine/SKILL.md +195 -0
  367. package/dist/template/.pi/skills/idea-refine/examples.md +62 -0
  368. package/dist/template/.pi/skills/idea-refine/frameworks.md +63 -0
  369. package/dist/template/.pi/skills/idea-refine/refinement-criteria.md +56 -0
  370. package/dist/template/.pi/skills/incremental-implementation/SKILL.md +190 -0
  371. package/dist/template/.pi/skills/industrial-brutalist-ui/SKILL.md +131 -0
  372. package/dist/template/.pi/skills/interview-me/SKILL.md +227 -0
  373. package/dist/template/.pi/skills/jira/SKILL.md +306 -0
  374. package/dist/template/.pi/skills/loop-audit/SKILL.md +141 -0
  375. package/dist/template/.pi/skills/loop-cost/SKILL.md +130 -0
  376. package/dist/template/.pi/skills/loop-engineering/SKILL.md +175 -0
  377. package/dist/template/.pi/skills/minimalist-ui/SKILL.md +124 -0
  378. package/dist/template/.pi/skills/mockup-to-code/SKILL.md +197 -0
  379. package/dist/template/.pi/skills/observability-and-instrumentation/SKILL.md +202 -0
  380. package/dist/template/.pi/skills/opensrc/SKILL.md +297 -0
  381. package/dist/template/.pi/skills/opensrc/references/architecture.md +176 -0
  382. package/dist/template/.pi/skills/opensrc/references/cli-usage.md +176 -0
  383. package/dist/template/.pi/skills/opensrc/references/registry-support.md +137 -0
  384. package/dist/template/.pi/skills/pdf-extract/SKILL.md +461 -0
  385. package/dist/template/.pi/skills/performance-optimization/SKILL.md +233 -0
  386. package/dist/template/.pi/skills/performance-optimization/references/performance-checklist.md +85 -0
  387. package/dist/template/.pi/skills/planning-and-task-breakdown/SKILL.md +204 -0
  388. package/dist/template/.pi/skills/playwright/SKILL.md +404 -0
  389. package/dist/template/.pi/skills/playwright/references/agent-browser-cli.md +405 -0
  390. package/dist/template/.pi/skills/polar/SKILL.md +125 -0
  391. package/dist/template/.pi/skills/react-best-practices/SKILL.md +156 -0
  392. package/dist/template/.pi/skills/react-best-practices/rules/_sections.md +46 -0
  393. package/dist/template/.pi/skills/react-best-practices/rules/_template.md +28 -0
  394. package/dist/template/.pi/skills/react-best-practices/rules/advanced-event-handler-refs.md +55 -0
  395. package/dist/template/.pi/skills/react-best-practices/rules/advanced-use-latest.md +49 -0
  396. package/dist/template/.pi/skills/react-best-practices/rules/async-api-routes.md +38 -0
  397. package/dist/template/.pi/skills/react-best-practices/rules/async-defer-await.md +80 -0
  398. package/dist/template/.pi/skills/react-best-practices/rules/async-dependencies.md +36 -0
  399. package/dist/template/.pi/skills/react-best-practices/rules/async-parallel.md +28 -0
  400. package/dist/template/.pi/skills/react-best-practices/rules/async-suspense-boundaries.md +99 -0
  401. package/dist/template/.pi/skills/react-best-practices/rules/bundle-barrel-imports.md +59 -0
  402. package/dist/template/.pi/skills/react-best-practices/rules/bundle-conditional.md +31 -0
  403. package/dist/template/.pi/skills/react-best-practices/rules/bundle-defer-third-party.md +49 -0
  404. package/dist/template/.pi/skills/react-best-practices/rules/bundle-dynamic-imports.md +35 -0
  405. package/dist/template/.pi/skills/react-best-practices/rules/bundle-preload.md +50 -0
  406. package/dist/template/.pi/skills/react-best-practices/rules/client-event-listeners.md +74 -0
  407. package/dist/template/.pi/skills/react-best-practices/rules/client-localstorage-schema.md +71 -0
  408. package/dist/template/.pi/skills/react-best-practices/rules/client-passive-event-listeners.md +48 -0
  409. package/dist/template/.pi/skills/react-best-practices/rules/client-swr-dedup.md +56 -0
  410. package/dist/template/.pi/skills/react-best-practices/rules/js-batch-dom-css.md +82 -0
  411. package/dist/template/.pi/skills/react-best-practices/rules/js-cache-function-results.md +80 -0
  412. package/dist/template/.pi/skills/react-best-practices/rules/js-cache-property-access.md +28 -0
  413. package/dist/template/.pi/skills/react-best-practices/rules/js-cache-storage.md +70 -0
  414. package/dist/template/.pi/skills/react-best-practices/rules/js-combine-iterations.md +32 -0
  415. package/dist/template/.pi/skills/react-best-practices/rules/js-early-exit.md +50 -0
  416. package/dist/template/.pi/skills/react-best-practices/rules/js-hoist-regexp.md +45 -0
  417. package/dist/template/.pi/skills/react-best-practices/rules/js-index-maps.md +37 -0
  418. package/dist/template/.pi/skills/react-best-practices/rules/js-length-check-first.md +49 -0
  419. package/dist/template/.pi/skills/react-best-practices/rules/js-min-max-loop.md +82 -0
  420. package/dist/template/.pi/skills/react-best-practices/rules/js-set-map-lookups.md +24 -0
  421. package/dist/template/.pi/skills/react-best-practices/rules/js-tosorted-immutable.md +57 -0
  422. package/dist/template/.pi/skills/react-best-practices/rules/rendering-activity.md +26 -0
  423. package/dist/template/.pi/skills/react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
  424. package/dist/template/.pi/skills/react-best-practices/rules/rendering-conditional-render.md +40 -0
  425. package/dist/template/.pi/skills/react-best-practices/rules/rendering-content-visibility.md +38 -0
  426. package/dist/template/.pi/skills/react-best-practices/rules/rendering-hoist-jsx.md +46 -0
  427. package/dist/template/.pi/skills/react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
  428. package/dist/template/.pi/skills/react-best-practices/rules/rendering-svg-precision.md +28 -0
  429. package/dist/template/.pi/skills/react-best-practices/rules/rerender-defer-reads.md +39 -0
  430. package/dist/template/.pi/skills/react-best-practices/rules/rerender-dependencies.md +45 -0
  431. package/dist/template/.pi/skills/react-best-practices/rules/rerender-derived-state.md +29 -0
  432. package/dist/template/.pi/skills/react-best-practices/rules/rerender-functional-setstate.md +74 -0
  433. package/dist/template/.pi/skills/react-best-practices/rules/rerender-lazy-state-init.md +58 -0
  434. package/dist/template/.pi/skills/react-best-practices/rules/rerender-memo.md +44 -0
  435. package/dist/template/.pi/skills/react-best-practices/rules/rerender-transitions.md +40 -0
  436. package/dist/template/.pi/skills/react-best-practices/rules/server-after-nonblocking.md +73 -0
  437. package/dist/template/.pi/skills/react-best-practices/rules/server-cache-lru.md +41 -0
  438. package/dist/template/.pi/skills/react-best-practices/rules/server-cache-react.md +76 -0
  439. package/dist/template/.pi/skills/react-best-practices/rules/server-parallel-fetching.md +83 -0
  440. package/dist/template/.pi/skills/react-best-practices/rules/server-serialization.md +38 -0
  441. package/dist/template/.pi/skills/redesign-existing-projects/SKILL.md +217 -0
  442. package/dist/template/.pi/skills/resend/SKILL.md +196 -0
  443. package/dist/template/.pi/skills/resend/references/react-email.md +287 -0
  444. package/dist/template/.pi/skills/resend/references/receive-email.md +248 -0
  445. package/dist/template/.pi/skills/resend/references/send-email.md +318 -0
  446. package/dist/template/.pi/skills/root-cause-tracing/SKILL.md +216 -0
  447. package/dist/template/.pi/skills/security-and-hardening/SKILL.md +293 -0
  448. package/dist/template/.pi/skills/security-and-hardening/references/security-checklist.md +105 -0
  449. package/dist/template/.pi/skills/shipping-and-launch/SKILL.md +101 -0
  450. package/dist/template/.pi/skills/source-driven-development/SKILL.md +108 -0
  451. package/dist/template/.pi/skills/spec-driven-development/SKILL.md +177 -0
  452. package/dist/template/.pi/skills/srcwalk/SKILL.md +182 -0
  453. package/dist/template/.pi/skills/subagent-driven-development/SKILL.md +253 -0
  454. package/dist/template/.pi/skills/supabase/SKILL.md +153 -0
  455. package/dist/template/.pi/skills/supabase-postgres-best-practices/SKILL.md +88 -0
  456. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/advanced-full-text-search.md +55 -0
  457. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/advanced-jsonb-indexing.md +49 -0
  458. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/conn-idle-timeout.md +46 -0
  459. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/conn-limits.md +44 -0
  460. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/conn-pooling.md +41 -0
  461. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/conn-prepared-statements.md +46 -0
  462. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/data-batch-inserts.md +54 -0
  463. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/data-n-plus-one.md +53 -0
  464. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/data-pagination.md +50 -0
  465. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/data-upsert.md +50 -0
  466. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/lock-advisory.md +56 -0
  467. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/lock-deadlock-prevention.md +68 -0
  468. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/lock-short-transactions.md +50 -0
  469. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/lock-skip-locked.md +54 -0
  470. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/monitor-explain-analyze.md +45 -0
  471. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/monitor-pg-stat-statements.md +55 -0
  472. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/monitor-vacuum-analyze.md +55 -0
  473. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/query-composite-indexes.md +44 -0
  474. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/query-covering-indexes.md +40 -0
  475. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/query-index-types.md +45 -0
  476. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/query-missing-indexes.md +43 -0
  477. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/query-partial-indexes.md +45 -0
  478. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/schema-data-types.md +46 -0
  479. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/schema-foreign-key-indexes.md +59 -0
  480. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/schema-lowercase-identifiers.md +55 -0
  481. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/schema-partitioning.md +55 -0
  482. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/schema-primary-keys.md +61 -0
  483. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/security-privileges.md +54 -0
  484. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/security-rls-basics.md +50 -0
  485. package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/security-rls-performance.md +57 -0
  486. package/dist/template/.pi/skills/swift-concurrency/SKILL.md +290 -0
  487. package/dist/template/.pi/skills/swift-concurrency/references/actors.md +640 -0
  488. package/dist/template/.pi/skills/swift-concurrency/references/async-algorithms.md +822 -0
  489. package/dist/template/.pi/skills/swift-concurrency/references/async-await-basics.md +249 -0
  490. package/dist/template/.pi/skills/swift-concurrency/references/async-sequences.md +670 -0
  491. package/dist/template/.pi/skills/swift-concurrency/references/core-data.md +533 -0
  492. package/dist/template/.pi/skills/swift-concurrency/references/glossary.md +128 -0
  493. package/dist/template/.pi/skills/swift-concurrency/references/linting.md +142 -0
  494. package/dist/template/.pi/skills/swift-concurrency/references/memory-management.md +542 -0
  495. package/dist/template/.pi/skills/swift-concurrency/references/migration.md +1076 -0
  496. package/dist/template/.pi/skills/swift-concurrency/references/performance.md +574 -0
  497. package/dist/template/.pi/skills/swift-concurrency/references/sendable.md +578 -0
  498. package/dist/template/.pi/skills/swift-concurrency/references/tasks.md +604 -0
  499. package/dist/template/.pi/skills/swift-concurrency/references/testing.md +565 -0
  500. package/dist/template/.pi/skills/swift-concurrency/references/threading.md +452 -0
  501. package/dist/template/.pi/skills/swiftui-expert-skill/SKILL.md +343 -0
  502. package/dist/template/.pi/skills/swiftui-expert-skill/references/animation-advanced.md +351 -0
  503. package/dist/template/.pi/skills/swiftui-expert-skill/references/animation-basics.md +284 -0
  504. package/dist/template/.pi/skills/swiftui-expert-skill/references/animation-transitions.md +326 -0
  505. package/dist/template/.pi/skills/swiftui-expert-skill/references/image-optimization.md +286 -0
  506. package/dist/template/.pi/skills/swiftui-expert-skill/references/layout-best-practices.md +312 -0
  507. package/dist/template/.pi/skills/swiftui-expert-skill/references/liquid-glass.md +377 -0
  508. package/dist/template/.pi/skills/swiftui-expert-skill/references/list-patterns.md +153 -0
  509. package/dist/template/.pi/skills/swiftui-expert-skill/references/modern-apis.md +400 -0
  510. package/dist/template/.pi/skills/swiftui-expert-skill/references/performance-patterns.md +377 -0
  511. package/dist/template/.pi/skills/swiftui-expert-skill/references/scroll-patterns.md +305 -0
  512. package/dist/template/.pi/skills/swiftui-expert-skill/references/sheet-navigation-patterns.md +292 -0
  513. package/dist/template/.pi/skills/swiftui-expert-skill/references/state-management.md +447 -0
  514. package/dist/template/.pi/skills/swiftui-expert-skill/references/text-formatting.md +285 -0
  515. package/dist/template/.pi/skills/swiftui-expert-skill/references/view-structure.md +276 -0
  516. package/dist/template/.pi/skills/test-driven-development/SKILL.md +400 -0
  517. package/dist/template/.pi/skills/test-driven-development/references/testing-patterns.md +155 -0
  518. package/dist/template/.pi/skills/testing-anti-patterns/SKILL.md +339 -0
  519. package/dist/template/.pi/skills/using-agent-skills/SKILL.md +371 -0
  520. package/dist/template/.pi/skills/using-git-worktrees/SKILL.md +275 -0
  521. package/dist/template/.pi/skills/vercel-deploy-claimable/SKILL.md +144 -0
  522. package/dist/template/.pi/skills/vercel-deploy-claimable/scripts/deploy.sh +249 -0
  523. package/dist/template/.pi/skills/verification-before-completion/SKILL.md +348 -0
  524. package/dist/template/.pi/skills/webclaw/SKILL.md +188 -0
  525. package/dist/template/.pi/skills/writing-skills/SKILL.md +329 -0
  526. package/dist/template/.pi/skills/writing-skills/references/anti-patterns.md +25 -0
  527. package/dist/template/.pi/skills/writing-skills/references/claude-search-optimization.md +140 -0
  528. package/dist/template/.pi/skills/writing-skills/references/discovery-workflow.md +11 -0
  529. package/dist/template/.pi/skills/writing-skills/references/file-organization.md +32 -0
  530. package/dist/template/.pi/skills/writing-skills/references/flowcharts-and-examples.md +57 -0
  531. package/dist/template/.pi/skills/writing-skills/references/rationalization-hardening.md +75 -0
  532. package/dist/template/.pi/skills/writing-skills/references/testing-methodology.md +397 -0
  533. package/dist/template/.pi/skills/writing-skills/references/testing-skill-types.md +52 -0
  534. package/dist/template/.pi/subagents.json +10 -0
  535. package/dist/template/.pi/templates/adr.md +47 -0
  536. package/dist/template/.pi/templates/design.md +61 -0
  537. package/dist/template/.pi/templates/loop-github-action.yml +162 -0
  538. package/dist/template/.pi/templates/loop-orchestrator.sh +514 -0
  539. package/dist/template/.pi/templates/loop-orchestrator.test.ts +332 -0
  540. package/dist/template/.pi/templates/loop-orchestrator.ts +936 -0
  541. package/dist/template/.pi/templates/loop-state.json +24 -0
  542. package/dist/template/.pi/templates/loop-state.md +98 -0
  543. package/dist/template/.pi/templates/loop-vision.md +110 -0
  544. package/dist/template/.pi/templates/prd.md +204 -0
  545. package/dist/template/.pi/templates/progress.md +55 -0
  546. package/dist/template/.pi/templates/project.md +58 -0
  547. package/dist/template/.pi/templates/proposal.md +40 -0
  548. package/dist/template/.pi/templates/review-state.json +20 -0
  549. package/dist/template/.pi/templates/roadmap.md +93 -0
  550. package/dist/template/.pi/templates/state.md +97 -0
  551. package/dist/template/.pi/templates/tasks.md +202 -0
  552. package/dist/template/.pi/templates/tech-stack.md +85 -0
  553. package/dist/template/.pi/templates/user.md +26 -0
  554. package/dist/template/.pi/workflows/INDEX.md +63 -0
  555. package/dist/template/.pi/workflows/audit-pattern.md +84 -0
  556. package/dist/template/.pi/workflows/batch-implement.md +121 -0
  557. package/dist/template/.pi/workflows/deep-research.md +89 -0
  558. package/dist/template/.pi/workflows/development-lifecycle-workflow.md +175 -0
  559. package/dist/template/.pi/workflows/garbage-collection.md +144 -0
  560. package/dist/template/.pi/workflows/quality-loop.md +211 -0
  561. package/package.json +57 -0
@@ -0,0 +1,254 @@
1
+ ---
2
+ description: Create detailed implementation plan with TDD steps
3
+ argument-hint: "[--level 0-3] [--dry-run] [--help]"
4
+ ---
5
+
6
+ # Plan
7
+
8
+ Create a detailed implementation plan with TDD steps. Optional deep-planning between `/create` and `/ship`.
9
+
10
+ > **Workflow:** `/create` → **`/plan`** (optional) → `/ship`
11
+ >
12
+ > **When to use:** Complex tasks where spec verification steps aren't enough guidance. Skip for simple tasks.
13
+
14
+ ## Parse Arguments
15
+
16
+ | Argument | Default | Description |
17
+ | ----------- | ------- | ----------------------------------------- |
18
+ | `--level` | auto | Force discovery level: 0 (skip), 1 (quick), 2 (standard), 3 (deep) |
19
+ | `--dry-run` | false | Preview plan without writing to disk |
20
+ | `--help` | false | Show this usage |
21
+
22
+ ## Guard Phase
23
+
24
+ Before planning:
25
+ - Verify `.pi/artifacts/$(cat .pi/artifacts/.active)/spec.md` exists (if not, tell user to run `/create` first)
26
+ - If `plan.md` already exists, ask user: overwrite or skip?
27
+ - If `tasks.json` already exists (from a prior `/plan` run), read it to understand existing task structure — avoid re-decomposing
28
+
29
+ ## Load Skills
30
+
31
+ | Skill | When | Why |
32
+ |-------|------|-----|
33
+ | `planning-and-task-breakdown` | Always | Goal-backward methodology, dependency graphing, wave assignment |
34
+ | `context-engineering` | Always | Context budget management — plans target ~50% context per execution |
35
+ | `test-driven-development` | Always | Structure tasks as RED-GREEN-REFACTOR steps |
36
+ | `incremental-implementation` | Always | Thin vertical slice discipline — each task is verify-after-each |
37
+ | `subagent-driven-development` | Multi-wave plan | Plan tasks for fresh subagent dispatch per task |
38
+ | `source-driven-development` | Level 1-3 | Ground decisions in official docs when researching dependencies |
39
+
40
+ ## Phase 0: Institutional Research (Mandatory)
41
+
42
+ ### Step 1: Search institutional memory
43
+
44
+ Use `vcc_recall` to search for bugfixes and existing plans. If relevant observations found, incorporate them.
45
+
46
+ ### Step 2: Mine git history
47
+
48
+ ```bash
49
+ git log --oneline -20
50
+ git log --oneline --follow -- <relevant-file-path>
51
+ git log --oneline --all | head -30
52
+ ```
53
+
54
+ Look for: commit conventions, recent changes (merge conflict risk), similar features, footgun zones.
55
+
56
+ ### Step 3: Spawn learnings-researcher (Level 2-3 work)
57
+
58
+ ```typescript
59
+ subagent({
60
+ agent: "explore",
61
+ prompt: "Search the codebase for patterns, conventions, and existing implementations related to: [FEATURE]. Return: existing patterns to follow, files to be aware of, and any gotchas."
62
+ });
63
+ ```
64
+
65
+ ## Phase 1: Discovery Assessment
66
+
67
+ Determine discovery level (same Level 0-3 taxonomy as `/create`):
68
+
69
+ | Level | Name | Scope | Action |
70
+ |-------|------|-------|--------|
71
+ | **0** | Skip | Pure internal work, existing patterns only | Skip external research |
72
+ | **1** | Quick | Single known library (~30 sec) | `context7` resolve + query |
73
+ | **2** | Standard | Choosing between 2-3 options (~1 min) | Spawn `scout` subagent for research |
74
+ | **3** | Deep | Architectural decision (~2 min) | Full research with parallel `scout` subagents |
75
+
76
+ Force with `--level N` flag. Default: auto-detect from spec complexity.
77
+
78
+ ## Phase 2: Research (Level 1-3)
79
+
80
+ Spawn parallel agents:
81
+
82
+ | Agent | Purpose |
83
+ | --------- | -------------------------------------------------------------------- |
84
+ | `explore` | Codebase patterns, affected file structure, test patterns, conflicts |
85
+ | `scout` | External best practices, common patterns, pitfalls |
86
+
87
+ ## Phase 3: Goal-Backward Analysis
88
+
89
+ Load `planning-and-task-breakdown` skill. Follow its methodology:
90
+
91
+ **Step 1: Extract Goal from PRD** — outcome-shaped, not task-shaped.
92
+
93
+ **Step 2: Derive Observable Truths** — 3-7 truths from USER's perspective.
94
+
95
+ **Step 3: Derive Required Artifacts** — for each truth, what must EXIST.
96
+
97
+ **Step 4: Identify Key Links** — critical connections where breakage causes cascading failures.
98
+
99
+ ## Phase 4: Decompose with Context Budget
100
+
101
+ Load `context-engineering` skill. Target ~50% context per execution.
102
+
103
+ | Task Complexity | Max Tasks | Context/Task | Total |
104
+ |------------------|-----------|--------------|-------|
105
+ | Simple (CRUD) | 3 | ~10-15% | ~30-45% |
106
+ | Complex (auth) | 2 | ~20-30% | ~40-50% |
107
+ | Very complex | 1-2 | ~30-40% | ~30-50% |
108
+
109
+ ## Phase 5: Dependency Graph & Wave Assignment
110
+
111
+ For each task, record:
112
+ - `needs`: What must exist before this runs
113
+ - `creates`: What this produces
114
+ - `has_checkpoint`: Requires user interaction?
115
+
116
+ Build wave analysis for parallel execution. Reference `subagent-driven-development` skill for task formats compatible with subagent dispatch.
117
+
118
+ ## Phase 6: Write Plan
119
+
120
+ Write `.pi/artifacts/$SLUG/plan.md`:
121
+
122
+ ```markdown
123
+ # [Feature] Implementation Plan
124
+
125
+ **Goal:** [Outcome-shaped goal from PRD]
126
+ **Discovery Level:** [0-3]
127
+ **Context Budget:** [Estimated context usage, target ~50%]
128
+
129
+ ## Must-Haves
130
+
131
+ ### Observable Truths
132
+ 1. [Truth 1]
133
+ 2. [Truth 2]
134
+ ...
135
+
136
+ ### Required Artifacts
137
+ | Artifact | Provides | Path |
138
+ |----------|----------|------|
139
+ ...
140
+
141
+ ### Key Links
142
+ | From | To | Via | Risk |
143
+ ...
144
+
145
+ ## Dependency Graph
146
+
147
+ Task A: needs nothing, creates src/models/X.ts
148
+ Task B: needs Task A, creates src/api/X.ts
149
+
150
+ Wave 1: A
151
+ Wave 2: B
152
+
153
+ ## Tasks
154
+ [Task definitions with TDD steps]
155
+ ```
156
+
157
+ After writing `plan.md`, derive the runtime `tasks.json` from it and write to `.pi/artifacts/$SLUG/tasks.json`:
158
+
159
+ ```json
160
+ {
161
+ "slug": "<slug>",
162
+ "title": "<title>",
163
+ "tasks": [
164
+ {
165
+ "id": "task-1",
166
+ "description": "...",
167
+ "files": ["src/path.ts"],
168
+ "depends_on": [],
169
+ "verification": ["npm run typecheck", "npm test -- path"],
170
+ "tdd": false,
171
+ "checkpoint": null
172
+ }
173
+ ]
174
+ }
175
+ ```
176
+
177
+ `plan.md` remains the **authoritative** decomposition; `tasks.json` is the runtime mirror consumed by `/ship`. Keep them in sync.
178
+
179
+ ### Task Standards
180
+
181
+ - **Exact file paths** — never "add to the relevant file"
182
+ - **Complete code** — never "add validation logic here"
183
+ - **Exact commands with expected output**
184
+ - **TDD order** — test first, then implementation (per `test-driven-development` skill)
185
+ - **Each step is 2-5 minutes** — one action per step
186
+ - **UI state coverage** — empty/loading/error/success states when applicable
187
+ - **Thin vertical slices** — per `incremental-implementation` skill
188
+
189
+ Use `.pi/templates/tasks.md` as the body template for the `## Tasks` section (task IDs, YAML metadata blocks, verification bullets).
190
+
191
+ ## Phase 7: Constitutional Compliance Gate
192
+
193
+ Scan plan against AGENTS.md hard constraints:
194
+
195
+ | Violation Pattern | AGENTS.md Rule | Severity |
196
+ | ------------------------------------------------- | ------------------------------------------- | ------------ |
197
+ | `git add .` or `git add -A` | Multi-Agent Safety: stage specific files | **CRITICAL** |
198
+ | `--force` push or `force push` | Git Safety: never force push main | **CRITICAL** |
199
+ | `--no-verify` | Git Safety: never bypass hooks | **CRITICAL** |
200
+ | `as any` or `@ts-ignore` without justification | Quality Bar: strong typing | **WARNING** |
201
+ | New package/dependency without approval step | Guardrails: no new deps without approval | **WARNING** |
202
+ | `reset --hard` or `checkout .` or `clean -fd` | Git Restore: never without explicit request | **CRITICAL** |
203
+ | Secret/credential patterns | Security: never expose credentials | **CRITICAL** |
204
+
205
+ ### Violation Response
206
+
207
+ | Severity | Action |
208
+ | ------------ | ------------------------------------------------------------------ |
209
+ | **CRITICAL** | Stop. Remove violation from plan. Report to user. |
210
+ | **WARNING** | Flag in plan output. Add confirmation checkpoint to affected task. |
211
+
212
+ ## Failure Handling
213
+
214
+ | Scenario | Action |
215
+ |----------|--------|
216
+ | Plan already exists | Ask user: overwrite or skip? |
217
+ | Missing spec artifact | Report: "No spec found. Run `/create` first." |
218
+ | Subagent research fails | Retry once with adjusted prompt, then proceed with existing knowledge |
219
+ | Verification fails 2x | Stop, report blocker with file:line evidence |
220
+
221
+ ## Stop Conditions
222
+
223
+ - Spec artifact missing → stop, tell user: run `/create` first
224
+ - Plan already exists → ask user before overwriting
225
+ - Constitutional violation found (CRITICAL) → remove violation from plan, report to user
226
+ - Verification fails 2x on same approach → stop, escalate
227
+
228
+ ## Phase 8: Report
229
+
230
+ 1. **Discovery Level:** [0-3] with rationale
231
+ 2. **Must-Haves:** [N] observable truths, [M] required artifacts, [K] key links
232
+ 3. **Context Budget:** [Estimated usage]
233
+ 4. **Dependency Waves:** [N] waves for parallel execution
234
+ 5. **Task count:** [N] tasks, [M] TDD steps
235
+ 6. **Files affected:** [List]
236
+ 7. **Plan location:** `.pi/artifacts/$SLUG/plan.md`
237
+ 8. **Next step:** `/ship`
238
+
239
+ ## Related Commands
240
+
241
+ | Need | Command |
242
+ | -------------- | ------------ |
243
+ | Create spec | `/create` |
244
+ | Execute plan | `/ship` |
245
+ | Research first | `/research` |
246
+
247
+ ## Related Skills
248
+
249
+ - `planning-and-task-breakdown` — goal-backward decomposition, dependency graphing (Phases 3-5)
250
+ - `context-engineering` — context budget management (Phases 0, 4)
251
+ - `test-driven-development` — RED-GREEN-REFACTOR task structuring (Phase 6)
252
+ - `incremental-implementation` — thin vertical slice discipline (Phase 6)
253
+ - `subagent-driven-development` — task format for subagent dispatch (Phase 5)
254
+ - `source-driven-development` — doc-backed research (Phase 2)
@@ -0,0 +1,136 @@
1
+ ---
2
+ description: Research a topic before implementation
3
+ argument-hint: "<topic> [--quick|--thorough] [--dry-run] [--help]"
4
+ ---
5
+
6
+ # Research: $ARGUMENTS
7
+
8
+ Gather information before implementation. Find answers, document findings, stop when done.
9
+
10
+ > Research can happen at any phase when you need external information or codebase understanding.
11
+
12
+ ## Parse Arguments
13
+
14
+ | Argument | Default | Description |
15
+ | ------------- | -------- | ----------------------------------- |
16
+ | `<topic>` | required | What to research |
17
+ | `--quick` | false | ~10 tool calls, single question |
18
+ | `--thorough` | false | ~100+ calls, comprehensive analysis |
19
+ | `--dry-run` | false | Report research plan without executing |
20
+ | `--help` | false | Show this usage |
21
+
22
+ Default depth: ~30 tool calls for moderate exploration. **Track call count and stop when you hit the depth budget** (`--quick` ≈10, default ≈30, `--thorough` ≈100+) — don't blow past it silently.
23
+
24
+ ## Guard Phase
25
+
26
+ Before researching:
27
+ - Check `.pi/artifacts/.active` — if active slug exists, write findings to `.pi/artifacts/$SLUG/research.md`
28
+ - If no active slug, report findings inline
29
+ - Assess complexity to choose Direct vs Workflow execution
30
+
31
+ ## Complexity Detection
32
+
33
+ Before starting, analyze the research topic complexity:
34
+
35
+ **Simple research** (execute directly):
36
+ - Single factual question
37
+ - One specific API or library
38
+ - Narrow scope with clear boundaries
39
+
40
+ **Complex research** (invoke workflow):
41
+ - Multi-angle topic requiring cross-checking
42
+ - Broad scope with multiple perspectives
43
+ - Requires verification from multiple sources
44
+
45
+ ### Decision Logic
46
+
47
+ 1. **Parse the topic** from $ARGUMENTS
48
+ 2. **Assess complexity:**
49
+ - Contains "best practices", "compare", "approaches", "strategies" → Complex
50
+ - Contains "how does", "what is", "explain" → Simple
51
+ - Topic spans multiple domains or technologies → Complex
52
+ 3. **If ambiguous**, ask user: "Is this a quick look-up or deep investigation?"
53
+ 4. **Route accordingly:**
54
+ - Simple → Direct Execution (Phase 1-3)
55
+ - Complex → Workflow Execution (read `.pi/workflows/deep-research.md`)
56
+
57
+ ## Load Skills
58
+
59
+ | Skill | When | Why |
60
+ |-------|------|-----|
61
+ | `source-driven-development` | Always | Ground findings in official docs, source code, and cited references |
62
+ | `srcwalk` | Codebase research | Navigate codebase with repo maps, symbol search, callers/callees |
63
+ | `opensrc` | Researching dependencies | Inspect library source for internal behavior |
64
+ | `gemini-large-context` | Large codebase or multi-repo | Analyze beyond typical context limits |
65
+
66
+ ## Direct Execution (Simple Research)
67
+
68
+ ### Phase 1: Search
69
+
70
+ Follow source priority:
71
+ 1. **Codebase patterns** — delegate via `subagent({ agent: "explore" })`. Never escalate to web if codebase has answer.
72
+ 2. **Official docs** — `context7` for API references
73
+ 3. **Real-world examples** — `codesearch` / `grepsearch`
74
+ 4. **Web search** — only if tiers 1-3 don't answer
75
+
76
+ ### Phase 2: Verify
77
+
78
+ Cross-check findings:
79
+ - Multiple authoritative sources agree → High confidence
80
+ - Single good source, plausible but unverified → Medium confidence
81
+ - Conflicting info, speculation → discard without corroboration
82
+
83
+ ### Phase 3: Synthesize
84
+
85
+ If within active work, write findings to `.pi/artifacts/$SLUG/research.md`. Otherwise report inline.
86
+
87
+ ## Workflow Execution (Complex Research)
88
+
89
+ **Announce:** "This is complex research requiring multi-angle analysis. Invoking deep-research workflow."
90
+
91
+ 1. Invoke the workflow:
92
+ ```
93
+ run_workflow({ name: "deep-research", args: { question: "<topic from $ARGUMENTS>" } })
94
+ ```
95
+ 2. The runner fans out `scout` agents per angle, then cross-checks with `review` agents, then synthesizes.
96
+ 3. Receive the synthesized cited report from the runner.
97
+
98
+ ## Stop Conditions
99
+
100
+ - All questions answered with medium+ confidence → stop research, proceed
101
+ - Tool budget exhausted for depth level → stop, report findings
102
+ - Network/API repeatedly unavailable → stop, report partial results
103
+
104
+ ## Failure Handling
105
+
106
+ | Scenario | Action |
107
+ |----------|--------|
108
+ | Subagent returns failure | Retry once with adjusted prompt, then escalate |
109
+ | Network/API error | Cache findings so far, retry with degraded mode |
110
+ | No results found | Report empty result set, suggest broader search terms |
111
+ | Tool budget exhausted | Report findings so far, note what remains unexplored |
112
+
113
+ ## Output
114
+
115
+ 1. **Execution mode:** Direct or Workflow
116
+ 2. Depth level and tool call count (if direct)
117
+ 3. Questions with answer status and confidence
118
+ 4. Key insights (bullet points)
119
+ 5. Artifact location: `.pi/artifacts/$SLUG/research.md` (if active work) or inline
120
+ 6. Next step suggestion
121
+
122
+ ## Related Commands
123
+
124
+ | Need | Command |
125
+ | -------------- | ------------ |
126
+ | Create spec | `/create` |
127
+ | Plan details | `/plan` |
128
+ | Ship feature | `/ship` |
129
+ | Audit codebase | `/audit` |
130
+
131
+ ## Related Skills
132
+
133
+ - `source-driven-development` — doc-backed research methodology (all phases)
134
+ - `srcwalk` — codebase symbol navigation and call tracing
135
+ - `opensrc` — library source inspection for dependency research
136
+ - `gemini-large-context` — large codebase analysis
@@ -0,0 +1,219 @@
1
+ ---
2
+ description: Ship a plan - implement specs, verify, review, close
3
+ argument-hint: "[--skip-review] [--dry-run] [--help]"
4
+ ---
5
+
6
+ # Ship
7
+
8
+ Execute spec tasks, verify each passes, run review, mark complete.
9
+
10
+ > **Workflow:** `/create` → **`/ship`** (or `/create` → `/plan` → `/ship`)
11
+
12
+ ## Parse Arguments
13
+
14
+ | Argument | Default | Description |
15
+ | --------------- | ------- | ----------------------------------------- |
16
+ | `--skip-review` | false | Skip Phase 5 review (low-risk changes only) |
17
+ | `--dry-run` | false | Validate plan and preview execution without implementing |
18
+ | `--help` | false | Show this usage |
19
+
20
+ ## Guard Phase
21
+
22
+ Before shipping:
23
+ - Use `vcc_recall` to search for failed approaches to avoid repeating
24
+ - Verify `.pi/artifacts/$(cat .pi/artifacts/.active)/spec.md` exists (if not, tell user to run `/create` first)
25
+ - If `plan.md` exists, verify it references the current spec
26
+ - Workspace check: create branch if needed, install deps if needed
27
+
28
+ ## Load Skills
29
+
30
+ | Skill | When | Why |
31
+ |-------|------|-----|
32
+ | `verification-before-completion` | Always | Evidence-before-claims; phantom detection; Worker Distrust Protocol |
33
+ | `shipping-and-launch` | Always | Pre-ship checklist, rollback planning, handoff protocols |
34
+ | `subagent-driven-development` | ≥2 independent tasks | Fresh subagent per task with review gates |
35
+ | `test-driven-development` | Tasks marked `tdd: true` | RED-GREEN-REFACTOR workflow (delegate to subagents) |
36
+ | `git-workflow-and-versioning` | After each task completes | Atomic commits, branch strategy, conventional commits |
37
+ | `code-review-and-quality` | Phase 5 review | 5-axis review: correctness, readability, architecture, security, performance |
38
+ | `doubt-driven-development` | High-risk features | In-flight adversarial review before merge |
39
+ | `context-engineering` | Batch workflow (≥5 independent tasks) | Context budget management for parallel subagent handoffs |
40
+
41
+ ## Phase 1: Route to Execution
42
+
43
+ ### Complexity Detection
44
+
45
+ **Direct execution** (sequential):
46
+ - Plan has <5 tasks
47
+ - Tasks have dependencies
48
+ - Tasks edit overlapping files
49
+
50
+ **Workflow execution** (parallel):
51
+ - Plan has ≥5 independent tasks
52
+ - No file conflicts between tasks
53
+
54
+ ### Decision Logic
55
+
56
+ 1. Read task list from `.pi/artifacts/$SLUG/tasks.json` (primary — produced by `/plan`). If `tasks.json` is absent, derive it on the fly from `.pi/artifacts/$SLUG/plan.md` (or the Lite PRD's task outline).
57
+ 2. Count independent tasks (no `depends_on`)
58
+ 3. Check for file conflicts (any shared files?)
59
+ 4. Route:
60
+ - <5 tasks OR has dependencies OR file conflicts → **Direct execution** (Phase 2)
61
+ - ≥5 independent AND no conflicts → **Workflow execution** (Phase 3)
62
+
63
+ ## Phase 2: Direct Execution (Sequential)
64
+
65
+ Execute tasks one at a time, verifying each before proceeding.
66
+
67
+ ### Per-Task Loop
68
+
69
+ For each task:
70
+
71
+ 1. **Read** the task description, verification steps, affected files
72
+ 2. **Read** affected files before editing
73
+ 3. **Implement** changes — stay within task's `files` list
74
+ 4. **Handle Deviations:** If the implementation reveals scope beyond the task, apply deviation rules:
75
+ - Rule 1: Trivial fix (<5 lines) in same file → fix inline, note in progress
76
+ - Rule 2: New small dependency discovered → implement, note
77
+ - Rule 3: Plan is wrong (task can't be done as specified) → report blocker
78
+ - Rule 4: Deviance exceeds 20% of task scope → stop, present options
79
+ 5. **Checkpoint Protocol:** If task has `checkpoint:*` type:
80
+
81
+ | Type | Action |
82
+ |------|--------|
83
+ | `checkpoint:human-verify` | Execute automation first, then pause for user verification |
84
+ | `checkpoint:decision` | Present options, wait for selection |
85
+ | `checkpoint:human-action` | Request specific action with verification command |
86
+
87
+ 6. **Verify** — run each verification step from the task
88
+ 7. **If verification fails**, fix and retry (max 2 attempts per task)
89
+ 8. **Commit** — load `git-workflow-and-versioning` skill, follow atomic commit protocol (NEVER `git add .`)
90
+ 9. **Mark** `passes: true` in tasks.json
91
+ 10. **Append** progress to `.pi/artifacts/$SLUG/progress.md`
92
+
93
+ ### TDD Tasks
94
+
95
+ When task has `"tdd": true`, load `test-driven-development` skill. Subagents follow RED-GREEN-REFACTOR as defined in that skill. The orchestrating agent verifies the red-green cycle after each subagent returns.
96
+
97
+ ### Stop Conditions
98
+
99
+ - Verification fails 2x on same task → stop, report blocker
100
+ - Blocked by unfinished dependency → stop, report which one
101
+ - Modifying files outside task scope → stop, ask user
102
+ - Rule 4 deviation → stop, present options
103
+
104
+ ## Phase 3: Workflow Execution (Parallel)
105
+
106
+ If routed to workflow mode:
107
+
108
+ 1. **Invoke the workflow:**
109
+ ```
110
+ run_workflow({ name: "batch-implement", args: { plan: "<plan from plan.md or tasks.json>" } })
111
+ ```
112
+ 2. The runner executes all phases (plan-review → implement → verify → merge) and handles placeholder substitution (`{plan}`, `{phase_N_output}`).
113
+ 3. Load `context-engineering` — ensures subagents receive focused context.
114
+
115
+ **Announce:** "This plan has [N] independent tasks. Invoking batch-implement workflow for parallel execution."
116
+
117
+ **Fallback:** If the batch workflow fails, fall back to Direct Execution (Phase 2).
118
+
119
+ ## Phase 4: Verification Gate
120
+
121
+ **Delegate to `/verify` — do not duplicate the gate logic here.** Run the canonical verification protocol defined in `prompts/verify.md` (Phase 1 Completeness → Phase 2 Correctness → Phase 4 Phantom Detection). Concretely:
122
+
123
+ 1. Invoke `/verify all --full` semantics (or run the same steps inline if already mid-session): load `verification-before-completion`, run typecheck + lint + test gates, use **full mode** for shipping (incremental is for iteration only), record stamp to `.pi/artifacts/verify.log` after all gates pass, run phantom completion detection, and do goal-backward verification (observable truths from plan/spec satisfied).
124
+ 2. If any gate fails, stop and surface the failure exactly as `/verify` would (don't proceed to Phase 5).
125
+ 3. Treat `/verify`'s output as the authoritative result for this phase.
126
+
127
+ **Why delegate:** `/verify` owns the gate definitions, the verification cache protocol, and phantom detection. Duplicating them here drifts over time. Ship is the consumer; verify is the source of truth for gates.
128
+
129
+ ## Phase 5: Review
130
+
131
+ > Skip with `--skip-review` for low-risk changes.
132
+
133
+ ### Mode Selection
134
+
135
+ | Condition | Mode |
136
+ |-----------|------|
137
+ | Routine change, low risk | **Standard Review** |
138
+ | High-risk feature, explicit quality gating request | **Iterative Quality Loop** (`.pi/workflows/quality-loop.md`) |
139
+
140
+ ### Standard Review
141
+
142
+ Spawn parallel `review` agents using `code-review-and-quality` skill's 5-axis methodology (security/correctness, performance/architecture, type-safety/tests, conventions/patterns, simplicity/completeness). Synthesize findings.
143
+
144
+ **Budget guard:** Scale reviewer count to diff size — don't blindly spawn 5.
145
+
146
+ | Changed files | Reviewers | Axes per reviewer |
147
+ |--------------|-----------|------------------|
148
+ | <10 | 2-3 | 2 axes each |
149
+ | 10-30 | 3-4 | 1-2 axes each |
150
+ | >30 | 5 | 1 axis each |
151
+
152
+ Fewer reviewers on small diffs keeps context cost proportional.
153
+
154
+ **Auto-fix rule:**
155
+ - Critical issues → fix inline, re-run Phase 4, continue
156
+ - Important issues → fix inline, continue
157
+ - Minor issues → log to `.pi/artifacts/$SLUG/progress.md`
158
+
159
+ ### Iterative Quality Loop
160
+
161
+ For high-risk features: run the score-gated review loop workflow:
162
+
163
+ ```bash
164
+ SLUG=$(cat .pi/artifacts/.active)
165
+ ```
166
+
167
+ 1. Invoke the workflow:
168
+ ```
169
+ run_workflow({ name: "quality-loop", args: { slug: "$SLUG" } })
170
+ ```
171
+ 2. The runner initializes `review-state.json` and executes the loop (REVIEW → GATE → STALL CHECK → FILTER → FIX → RE-REVIEW) per the workflow.
172
+ 3. Exit when score ≥ 5/5 or escalate per workflow rules (stall / max rounds / architecture finding).
173
+
174
+ ## Phase 6: Close
175
+
176
+ Ask user before closing. If confirmed:
177
+ - Update `tasks.json` to mark all tasks complete
178
+ - Append completion summary to `.pi/artifacts/$SLUG/progress.md`
179
+ - Clear `.pi/artifacts/.active`
180
+
181
+ ## Failure Handling
182
+
183
+ | Scenario | Action |
184
+ |----------|--------|
185
+ | Task verification fails 2x | Stop, report blocker with file:line evidence |
186
+ | Subagent returns failure | Read error, retry once with adjusted prompt, then escalate |
187
+ | Review finds critical issue | Fix inline, re-run Phase 4, continue |
188
+ | Batch workflow failure | Fall back to sequential execution |
189
+ | Missing `.active` slug | Report: "No active feature. Run `/create` first." |
190
+
191
+ ## Phase 7: Report
192
+
193
+ 1. **Execution Summary:** tasks completed/total, waves executed, commits made
194
+ 2. **Task Results:** per-task status, files modified, commit hashes
195
+ 3. **Verification Gate Results:** typecheck, lint, test, build — pass/fail
196
+ 4. **Goal-Backward:** artifacts verified (exists/substantive/wired), key links checked
197
+ 5. **Review Summary:** critical/important/minor issues, overall assessment
198
+ 6. **Next Steps:** Ask user if they want a PR created — always ask, never push without confirmation
199
+
200
+ ## Related Commands
201
+
202
+ | Need | Command |
203
+ | -------------- | ------------ |
204
+ | Create feature | `/create` |
205
+ | Plan execution | `/plan` |
206
+ | Research topic | `/research` |
207
+ | Fix a bug | `/fix` |
208
+ | Verify gates | `/verify` |
209
+
210
+ ## Related Skills
211
+
212
+ - `verification-before-completion` — phantom detection, evidence gate, cache protocol (Phases 4-5)
213
+ - `shipping-and-launch` — pre-ship checklist, rollback planning (Phases 4, 6)
214
+ - `test-driven-development` — RED-GREEN-REFACTOR for TDD tasks (Phase 2)
215
+ - `git-workflow-and-versioning` — atomic commit protocol (Phase 2)
216
+ - `code-review-and-quality` — 5-axis review methodology (Phase 5)
217
+ - `subagent-driven-development` — subagent dispatch pattern (Phase 2-3)
218
+ - `doubt-driven-development` — adversarial review for high-risk work (Phase 5)
219
+ - `context-engineering` — context budgets for parallel subagents (Phase 3)