@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.
- package/README.md +31 -0
- package/dist/index.js +1187 -0
- package/dist/template/.pi/.env.example +28 -0
- package/dist/template/.pi/AGENTS.md +226 -0
- package/dist/template/.pi/QUALITY.md +13 -0
- package/dist/template/.pi/README.md +452 -0
- package/dist/template/.pi/VERSION +1 -0
- package/dist/template/.pi/agents/INDEX.md +54 -0
- package/dist/template/.pi/agents/build.md +194 -0
- package/dist/template/.pi/agents/explore.md +85 -0
- package/dist/template/.pi/agents/general.md +189 -0
- package/dist/template/.pi/agents/plan.md +407 -0
- package/dist/template/.pi/agents/review.md +198 -0
- package/dist/template/.pi/agents/scout.md +142 -0
- package/dist/template/.pi/agents/vision.md +157 -0
- package/dist/template/.pi/artifacts/example/plan.md +12 -0
- package/dist/template/.pi/artifacts/example/progress.md +4 -0
- package/dist/template/.pi/artifacts/example/research.md +4 -0
- package/dist/template/.pi/artifacts/example/spec.md +16 -0
- package/dist/template/.pi/context/architecture.md +141 -0
- package/dist/template/.pi/context/fallow.md +137 -0
- package/dist/template/.pi/extensions/templates-injector.ts +76 -0
- package/dist/template/.pi/extensions/workflows-runner.ts +301 -0
- package/dist/template/.pi/guard.example.json +75 -0
- package/dist/template/.pi/prompts/INDEX.md +78 -0
- package/dist/template/.pi/prompts/audit.md +109 -0
- package/dist/template/.pi/prompts/close.md +88 -0
- package/dist/template/.pi/prompts/create.md +197 -0
- package/dist/template/.pi/prompts/fix.md +117 -0
- package/dist/template/.pi/prompts/gc.md +112 -0
- package/dist/template/.pi/prompts/init.md +206 -0
- package/dist/template/.pi/prompts/loop-check.md +87 -0
- package/dist/template/.pi/prompts/loop-init.md +157 -0
- package/dist/template/.pi/prompts/loop-review.md +90 -0
- package/dist/template/.pi/prompts/plan.md +254 -0
- package/dist/template/.pi/prompts/research.md +136 -0
- package/dist/template/.pi/prompts/ship.md +219 -0
- package/dist/template/.pi/prompts/status.md +92 -0
- package/dist/template/.pi/prompts/verify.md +154 -0
- package/dist/template/.pi/scripts/gc-check.sh +86 -0
- package/dist/template/.pi/settings.json +15 -0
- package/dist/template/.pi/skills/INDEX.md +331 -0
- package/dist/template/.pi/skills/accessibility-audit/SKILL.md +205 -0
- package/dist/template/.pi/skills/accessibility-audit/references/accessibility-checklist.md +109 -0
- package/dist/template/.pi/skills/agent-code-quality-gate/SKILL.md +131 -0
- package/dist/template/.pi/skills/api-and-interface-design/SKILL.md +159 -0
- package/dist/template/.pi/skills/behavioral-kernel/SKILL.md +92 -0
- package/dist/template/.pi/skills/brainstorming/SKILL.md +138 -0
- package/dist/template/.pi/skills/browser-testing-with-devtools/SKILL.md +90 -0
- package/dist/template/.pi/skills/chrome-devtools/SKILL.md +129 -0
- package/dist/template/.pi/skills/ci-cd-and-automation/SKILL.md +199 -0
- package/dist/template/.pi/skills/cloudflare/SKILL.md +271 -0
- package/dist/template/.pi/skills/cloudflare/references/agents-sdk/README.md +35 -0
- package/dist/template/.pi/skills/cloudflare/references/agents-sdk/api.md +100 -0
- package/dist/template/.pi/skills/cloudflare/references/agents-sdk/configuration.md +99 -0
- package/dist/template/.pi/skills/cloudflare/references/agents-sdk/gotchas.md +59 -0
- package/dist/template/.pi/skills/cloudflare/references/agents-sdk/patterns.md +89 -0
- package/dist/template/.pi/skills/cloudflare/references/ai-gateway/README.md +695 -0
- package/dist/template/.pi/skills/cloudflare/references/ai-search/README.md +14 -0
- package/dist/template/.pi/skills/cloudflare/references/ai-search/api.md +38 -0
- package/dist/template/.pi/skills/cloudflare/references/ai-search/configuration.md +52 -0
- package/dist/template/.pi/skills/cloudflare/references/ai-search/gotchas.md +41 -0
- package/dist/template/.pi/skills/cloudflare/references/ai-search/patterns.md +45 -0
- package/dist/template/.pi/skills/cloudflare/references/analytics-engine/README.md +14 -0
- package/dist/template/.pi/skills/cloudflare/references/analytics-engine/api.md +27 -0
- package/dist/template/.pi/skills/cloudflare/references/analytics-engine/configuration.md +45 -0
- package/dist/template/.pi/skills/cloudflare/references/analytics-engine/gotchas.md +3 -0
- package/dist/template/.pi/skills/cloudflare/references/analytics-engine/patterns.md +36 -0
- package/dist/template/.pi/skills/cloudflare/references/api/README.md +21 -0
- package/dist/template/.pi/skills/cloudflare/references/api/api.md +31 -0
- package/dist/template/.pi/skills/cloudflare/references/api/configuration.md +20 -0
- package/dist/template/.pi/skills/cloudflare/references/api/gotchas.md +28 -0
- package/dist/template/.pi/skills/cloudflare/references/api/patterns.md +47 -0
- package/dist/template/.pi/skills/cloudflare/references/api-shield/README.md +20 -0
- package/dist/template/.pi/skills/cloudflare/references/api-shield/api.md +78 -0
- package/dist/template/.pi/skills/cloudflare/references/api-shield/configuration.md +128 -0
- package/dist/template/.pi/skills/cloudflare/references/api-shield/gotchas.md +51 -0
- package/dist/template/.pi/skills/cloudflare/references/api-shield/patterns.md +145 -0
- package/dist/template/.pi/skills/cloudflare/references/argo-smart-routing/README.md +16 -0
- package/dist/template/.pi/skills/cloudflare/references/argo-smart-routing/api.md +50 -0
- package/dist/template/.pi/skills/cloudflare/references/argo-smart-routing/configuration.md +53 -0
- package/dist/template/.pi/skills/cloudflare/references/argo-smart-routing/gotchas.md +16 -0
- package/dist/template/.pi/skills/cloudflare/references/argo-smart-routing/patterns.md +45 -0
- package/dist/template/.pi/skills/cloudflare/references/bindings/README.md +14 -0
- package/dist/template/.pi/skills/cloudflare/references/bindings/api.md +3 -0
- package/dist/template/.pi/skills/cloudflare/references/bindings/configuration.md +58 -0
- package/dist/template/.pi/skills/cloudflare/references/bindings/gotchas.md +35 -0
- package/dist/template/.pi/skills/cloudflare/references/bindings/patterns.md +37 -0
- package/dist/template/.pi/skills/cloudflare/references/bot-management/README.md +71 -0
- package/dist/template/.pi/skills/cloudflare/references/bot-management/api.md +168 -0
- package/dist/template/.pi/skills/cloudflare/references/bot-management/configuration.md +114 -0
- package/dist/template/.pi/skills/cloudflare/references/bot-management/gotchas.md +99 -0
- package/dist/template/.pi/skills/cloudflare/references/bot-management/patterns.md +125 -0
- package/dist/template/.pi/skills/cloudflare/references/browser-rendering/README.md +16 -0
- package/dist/template/.pi/skills/cloudflare/references/browser-rendering/api.md +54 -0
- package/dist/template/.pi/skills/cloudflare/references/browser-rendering/configuration.md +47 -0
- package/dist/template/.pi/skills/cloudflare/references/browser-rendering/gotchas.md +29 -0
- package/dist/template/.pi/skills/cloudflare/references/browser-rendering/patterns.md +29 -0
- package/dist/template/.pi/skills/cloudflare/references/c3/README.md +264 -0
- package/dist/template/.pi/skills/cloudflare/references/cache-reserve/README.md +93 -0
- package/dist/template/.pi/skills/cloudflare/references/cache-reserve/api.md +176 -0
- package/dist/template/.pi/skills/cloudflare/references/cache-reserve/configuration.md +164 -0
- package/dist/template/.pi/skills/cloudflare/references/cache-reserve/gotchas.md +203 -0
- package/dist/template/.pi/skills/cloudflare/references/cache-reserve/patterns.md +180 -0
- package/dist/template/.pi/skills/cloudflare/references/containers/README.md +16 -0
- package/dist/template/.pi/skills/cloudflare/references/containers/api.md +43 -0
- package/dist/template/.pi/skills/cloudflare/references/containers/configuration.md +56 -0
- package/dist/template/.pi/skills/cloudflare/references/containers/gotchas.md +21 -0
- package/dist/template/.pi/skills/cloudflare/references/containers/patterns.md +40 -0
- package/dist/template/.pi/skills/cloudflare/references/cron-triggers/README.md +85 -0
- package/dist/template/.pi/skills/cloudflare/references/cron-triggers/api.md +198 -0
- package/dist/template/.pi/skills/cloudflare/references/cron-triggers/configuration.md +151 -0
- package/dist/template/.pi/skills/cloudflare/references/cron-triggers/gotchas.md +129 -0
- package/dist/template/.pi/skills/cloudflare/references/cron-triggers/patterns.md +122 -0
- package/dist/template/.pi/skills/cloudflare/references/d1/README.md +92 -0
- package/dist/template/.pi/skills/cloudflare/references/d1/api.md +141 -0
- package/dist/template/.pi/skills/cloudflare/references/d1/configuration.md +127 -0
- package/dist/template/.pi/skills/cloudflare/references/d1/gotchas.md +70 -0
- package/dist/template/.pi/skills/cloudflare/references/d1/patterns.md +144 -0
- package/dist/template/.pi/skills/cloudflare/references/ddos/README.md +34 -0
- package/dist/template/.pi/skills/cloudflare/references/ddos/api.md +136 -0
- package/dist/template/.pi/skills/cloudflare/references/ddos/configuration.md +67 -0
- package/dist/template/.pi/skills/cloudflare/references/ddos/gotchas.md +114 -0
- package/dist/template/.pi/skills/cloudflare/references/ddos/patterns.md +158 -0
- package/dist/template/.pi/skills/cloudflare/references/do-storage/README.md +62 -0
- package/dist/template/.pi/skills/cloudflare/references/do-storage/api.md +89 -0
- package/dist/template/.pi/skills/cloudflare/references/do-storage/configuration.md +116 -0
- package/dist/template/.pi/skills/cloudflare/references/do-storage/gotchas.md +93 -0
- package/dist/template/.pi/skills/cloudflare/references/do-storage/patterns.md +112 -0
- package/dist/template/.pi/skills/cloudflare/references/durable-objects/README.md +125 -0
- package/dist/template/.pi/skills/cloudflare/references/durable-objects/api.md +152 -0
- package/dist/template/.pi/skills/cloudflare/references/durable-objects/configuration.md +148 -0
- package/dist/template/.pi/skills/cloudflare/references/durable-objects/gotchas.md +158 -0
- package/dist/template/.pi/skills/cloudflare/references/durable-objects/patterns.md +255 -0
- package/dist/template/.pi/skills/cloudflare/references/email-routing/README.md +18 -0
- package/dist/template/.pi/skills/cloudflare/references/email-routing/api.md +46 -0
- package/dist/template/.pi/skills/cloudflare/references/email-routing/configuration.md +63 -0
- package/dist/template/.pi/skills/cloudflare/references/email-routing/gotchas.md +16 -0
- package/dist/template/.pi/skills/cloudflare/references/email-routing/patterns.md +46 -0
- package/dist/template/.pi/skills/cloudflare/references/email-workers/README.md +598 -0
- package/dist/template/.pi/skills/cloudflare/references/hyperdrive/README.md +62 -0
- package/dist/template/.pi/skills/cloudflare/references/hyperdrive/api.md +137 -0
- package/dist/template/.pi/skills/cloudflare/references/hyperdrive/configuration.md +133 -0
- package/dist/template/.pi/skills/cloudflare/references/hyperdrive/gotchas.md +184 -0
- package/dist/template/.pi/skills/cloudflare/references/hyperdrive/patterns.md +176 -0
- package/dist/template/.pi/skills/cloudflare/references/images/README.md +14 -0
- package/dist/template/.pi/skills/cloudflare/references/images/api.md +3 -0
- package/dist/template/.pi/skills/cloudflare/references/images/configuration.md +45 -0
- package/dist/template/.pi/skills/cloudflare/references/images/gotchas.md +23 -0
- package/dist/template/.pi/skills/cloudflare/references/images/patterns.md +31 -0
- package/dist/template/.pi/skills/cloudflare/references/kv/README.md +60 -0
- package/dist/template/.pi/skills/cloudflare/references/kv/api.md +114 -0
- package/dist/template/.pi/skills/cloudflare/references/kv/configuration.md +92 -0
- package/dist/template/.pi/skills/cloudflare/references/kv/gotchas.md +117 -0
- package/dist/template/.pi/skills/cloudflare/references/kv/patterns.md +139 -0
- package/dist/template/.pi/skills/cloudflare/references/miniflare/README.md +64 -0
- package/dist/template/.pi/skills/cloudflare/references/miniflare/api.md +144 -0
- package/dist/template/.pi/skills/cloudflare/references/miniflare/configuration.md +203 -0
- package/dist/template/.pi/skills/cloudflare/references/miniflare/gotchas.md +187 -0
- package/dist/template/.pi/skills/cloudflare/references/miniflare/patterns.md +211 -0
- package/dist/template/.pi/skills/cloudflare/references/network-interconnect/README.md +60 -0
- package/dist/template/.pi/skills/cloudflare/references/network-interconnect/api.md +240 -0
- package/dist/template/.pi/skills/cloudflare/references/network-interconnect/configuration.md +127 -0
- package/dist/template/.pi/skills/cloudflare/references/network-interconnect/gotchas.md +171 -0
- package/dist/template/.pi/skills/cloudflare/references/network-interconnect/patterns.md +171 -0
- package/dist/template/.pi/skills/cloudflare/references/observability/README.md +18 -0
- package/dist/template/.pi/skills/cloudflare/references/observability/api.md +51 -0
- package/dist/template/.pi/skills/cloudflare/references/observability/configuration.md +60 -0
- package/dist/template/.pi/skills/cloudflare/references/observability/gotchas.md +36 -0
- package/dist/template/.pi/skills/cloudflare/references/observability/patterns.md +42 -0
- package/dist/template/.pi/skills/cloudflare/references/pages/README.md +76 -0
- package/dist/template/.pi/skills/cloudflare/references/pages/api.md +200 -0
- package/dist/template/.pi/skills/cloudflare/references/pages/configuration.md +228 -0
- package/dist/template/.pi/skills/cloudflare/references/pages/gotchas.md +161 -0
- package/dist/template/.pi/skills/cloudflare/references/pages/patterns.md +145 -0
- package/dist/template/.pi/skills/cloudflare/references/pages-functions/README.md +57 -0
- package/dist/template/.pi/skills/cloudflare/references/pages-functions/api.md +201 -0
- package/dist/template/.pi/skills/cloudflare/references/pages-functions/configuration.md +159 -0
- package/dist/template/.pi/skills/cloudflare/references/pages-functions/gotchas.md +151 -0
- package/dist/template/.pi/skills/cloudflare/references/pages-functions/patterns.md +190 -0
- package/dist/template/.pi/skills/cloudflare/references/pipelines/README.md +664 -0
- package/dist/template/.pi/skills/cloudflare/references/pulumi/README.md +107 -0
- package/dist/template/.pi/skills/cloudflare/references/pulumi/api.md +194 -0
- package/dist/template/.pi/skills/cloudflare/references/pulumi/configuration.md +216 -0
- package/dist/template/.pi/skills/cloudflare/references/pulumi/gotchas.md +223 -0
- package/dist/template/.pi/skills/cloudflare/references/pulumi/patterns.md +139 -0
- package/dist/template/.pi/skills/cloudflare/references/queues/README.md +69 -0
- package/dist/template/.pi/skills/cloudflare/references/queues/api.md +138 -0
- package/dist/template/.pi/skills/cloudflare/references/queues/configuration.md +125 -0
- package/dist/template/.pi/skills/cloudflare/references/queues/gotchas.md +112 -0
- package/dist/template/.pi/skills/cloudflare/references/queues/patterns.md +155 -0
- package/dist/template/.pi/skills/cloudflare/references/r2/README.md +61 -0
- package/dist/template/.pi/skills/cloudflare/references/r2/api.md +127 -0
- package/dist/template/.pi/skills/cloudflare/references/r2/configuration.md +76 -0
- package/dist/template/.pi/skills/cloudflare/references/r2/gotchas.md +94 -0
- package/dist/template/.pi/skills/cloudflare/references/r2/patterns.md +127 -0
- package/dist/template/.pi/skills/cloudflare/references/r2-data-catalog/README.md +18 -0
- package/dist/template/.pi/skills/cloudflare/references/r2-data-catalog/api.md +29 -0
- package/dist/template/.pi/skills/cloudflare/references/r2-data-catalog/configuration.md +39 -0
- package/dist/template/.pi/skills/cloudflare/references/r2-data-catalog/gotchas.md +20 -0
- package/dist/template/.pi/skills/cloudflare/references/r2-data-catalog/patterns.md +46 -0
- package/dist/template/.pi/skills/cloudflare/references/r2-sql/README.md +512 -0
- package/dist/template/.pi/skills/cloudflare/references/realtime-sfu/README.md +21 -0
- package/dist/template/.pi/skills/cloudflare/references/realtime-sfu/api.md +135 -0
- package/dist/template/.pi/skills/cloudflare/references/realtime-sfu/configuration.md +63 -0
- package/dist/template/.pi/skills/cloudflare/references/realtime-sfu/gotchas.md +75 -0
- package/dist/template/.pi/skills/cloudflare/references/realtime-sfu/patterns.md +102 -0
- package/dist/template/.pi/skills/cloudflare/references/realtimekit/README.md +81 -0
- package/dist/template/.pi/skills/cloudflare/references/realtimekit/api.md +164 -0
- package/dist/template/.pi/skills/cloudflare/references/realtimekit/configuration.md +147 -0
- package/dist/template/.pi/skills/cloudflare/references/realtimekit/gotchas.md +172 -0
- package/dist/template/.pi/skills/cloudflare/references/realtimekit/patterns.md +155 -0
- package/dist/template/.pi/skills/cloudflare/references/sandbox/README.md +90 -0
- package/dist/template/.pi/skills/cloudflare/references/sandbox/api.md +178 -0
- package/dist/template/.pi/skills/cloudflare/references/sandbox/configuration.md +131 -0
- package/dist/template/.pi/skills/cloudflare/references/sandbox/gotchas.md +156 -0
- package/dist/template/.pi/skills/cloudflare/references/sandbox/patterns.md +203 -0
- package/dist/template/.pi/skills/cloudflare/references/secrets-store/README.md +58 -0
- package/dist/template/.pi/skills/cloudflare/references/secrets-store/api.md +182 -0
- package/dist/template/.pi/skills/cloudflare/references/secrets-store/configuration.md +140 -0
- package/dist/template/.pi/skills/cloudflare/references/secrets-store/gotchas.md +129 -0
- package/dist/template/.pi/skills/cloudflare/references/secrets-store/patterns.md +218 -0
- package/dist/template/.pi/skills/cloudflare/references/smart-placement/README.md +91 -0
- package/dist/template/.pi/skills/cloudflare/references/smart-placement/api.md +139 -0
- package/dist/template/.pi/skills/cloudflare/references/smart-placement/configuration.md +129 -0
- package/dist/template/.pi/skills/cloudflare/references/smart-placement/gotchas.md +87 -0
- package/dist/template/.pi/skills/cloudflare/references/smart-placement/patterns.md +135 -0
- package/dist/template/.pi/skills/cloudflare/references/snippets/README.md +15 -0
- package/dist/template/.pi/skills/cloudflare/references/snippets/api.md +47 -0
- package/dist/template/.pi/skills/cloudflare/references/snippets/configuration.md +33 -0
- package/dist/template/.pi/skills/cloudflare/references/snippets/gotchas.md +21 -0
- package/dist/template/.pi/skills/cloudflare/references/snippets/patterns.md +34 -0
- package/dist/template/.pi/skills/cloudflare/references/spectrum/README.md +16 -0
- package/dist/template/.pi/skills/cloudflare/references/spectrum/api.md +24 -0
- package/dist/template/.pi/skills/cloudflare/references/spectrum/configuration.md +43 -0
- package/dist/template/.pi/skills/cloudflare/references/spectrum/gotchas.md +42 -0
- package/dist/template/.pi/skills/cloudflare/references/spectrum/patterns.md +40 -0
- package/dist/template/.pi/skills/cloudflare/references/static-assets/README.md +14 -0
- package/dist/template/.pi/skills/cloudflare/references/static-assets/api.md +3 -0
- package/dist/template/.pi/skills/cloudflare/references/static-assets/configuration.md +47 -0
- package/dist/template/.pi/skills/cloudflare/references/static-assets/gotchas.md +44 -0
- package/dist/template/.pi/skills/cloudflare/references/static-assets/patterns.md +42 -0
- package/dist/template/.pi/skills/cloudflare/references/stream/README.md +103 -0
- package/dist/template/.pi/skills/cloudflare/references/stream/api.md +204 -0
- package/dist/template/.pi/skills/cloudflare/references/stream/configuration.md +127 -0
- package/dist/template/.pi/skills/cloudflare/references/stream/gotchas.md +131 -0
- package/dist/template/.pi/skills/cloudflare/references/stream/patterns.md +152 -0
- package/dist/template/.pi/skills/cloudflare/references/tail-workers/README.md +640 -0
- package/dist/template/.pi/skills/cloudflare/references/terraform/README.md +76 -0
- package/dist/template/.pi/skills/cloudflare/references/terraform/api.md +159 -0
- package/dist/template/.pi/skills/cloudflare/references/terraform/configuration.md +156 -0
- package/dist/template/.pi/skills/cloudflare/references/terraform/gotchas.md +207 -0
- package/dist/template/.pi/skills/cloudflare/references/terraform/patterns.md +135 -0
- package/dist/template/.pi/skills/cloudflare/references/tunnel/README.md +82 -0
- package/dist/template/.pi/skills/cloudflare/references/tunnel/api.md +105 -0
- package/dist/template/.pi/skills/cloudflare/references/tunnel/configuration.md +113 -0
- package/dist/template/.pi/skills/cloudflare/references/tunnel/gotchas.md +115 -0
- package/dist/template/.pi/skills/cloudflare/references/tunnel/patterns.md +157 -0
- package/dist/template/.pi/skills/cloudflare/references/turn/README.md +699 -0
- package/dist/template/.pi/skills/cloudflare/references/turnstile/README.md +14 -0
- package/dist/template/.pi/skills/cloudflare/references/turnstile/api.md +3 -0
- package/dist/template/.pi/skills/cloudflare/references/turnstile/configuration.md +19 -0
- package/dist/template/.pi/skills/cloudflare/references/turnstile/gotchas.md +27 -0
- package/dist/template/.pi/skills/cloudflare/references/turnstile/patterns.md +41 -0
- package/dist/template/.pi/skills/cloudflare/references/vectorize/README.md +682 -0
- package/dist/template/.pi/skills/cloudflare/references/waf/README.md +14 -0
- package/dist/template/.pi/skills/cloudflare/references/waf/api.md +3 -0
- package/dist/template/.pi/skills/cloudflare/references/waf/configuration.md +44 -0
- package/dist/template/.pi/skills/cloudflare/references/waf/gotchas.md +24 -0
- package/dist/template/.pi/skills/cloudflare/references/waf/patterns.md +29 -0
- package/dist/template/.pi/skills/cloudflare/references/web-analytics/README.md +19 -0
- package/dist/template/.pi/skills/cloudflare/references/web-analytics/api.md +52 -0
- package/dist/template/.pi/skills/cloudflare/references/web-analytics/configuration.md +31 -0
- package/dist/template/.pi/skills/cloudflare/references/web-analytics/gotchas.md +28 -0
- package/dist/template/.pi/skills/cloudflare/references/web-analytics/patterns.md +52 -0
- package/dist/template/.pi/skills/cloudflare/references/workerd/README.md +47 -0
- package/dist/template/.pi/skills/cloudflare/references/workerd/api.md +199 -0
- package/dist/template/.pi/skills/cloudflare/references/workerd/configuration.md +185 -0
- package/dist/template/.pi/skills/cloudflare/references/workerd/gotchas.md +203 -0
- package/dist/template/.pi/skills/cloudflare/references/workerd/patterns.md +216 -0
- package/dist/template/.pi/skills/cloudflare/references/workers/README.md +96 -0
- package/dist/template/.pi/skills/cloudflare/references/workers/api.md +137 -0
- package/dist/template/.pi/skills/cloudflare/references/workers/configuration.md +147 -0
- package/dist/template/.pi/skills/cloudflare/references/workers/gotchas.md +99 -0
- package/dist/template/.pi/skills/cloudflare/references/workers/patterns.md +149 -0
- package/dist/template/.pi/skills/cloudflare/references/workers-ai/README.md +116 -0
- package/dist/template/.pi/skills/cloudflare/references/workers-for-platforms/README.md +48 -0
- package/dist/template/.pi/skills/cloudflare/references/workers-for-platforms/api.md +169 -0
- package/dist/template/.pi/skills/cloudflare/references/workers-for-platforms/configuration.md +136 -0
- package/dist/template/.pi/skills/cloudflare/references/workers-for-platforms/gotchas.md +130 -0
- package/dist/template/.pi/skills/cloudflare/references/workers-for-platforms/patterns.md +170 -0
- package/dist/template/.pi/skills/cloudflare/references/workers-playground/README.md +16 -0
- package/dist/template/.pi/skills/cloudflare/references/workers-playground/api.md +20 -0
- package/dist/template/.pi/skills/cloudflare/references/workers-playground/configuration.md +3 -0
- package/dist/template/.pi/skills/cloudflare/references/workers-playground/gotchas.md +35 -0
- package/dist/template/.pi/skills/cloudflare/references/workers-playground/patterns.md +42 -0
- package/dist/template/.pi/skills/cloudflare/references/workers-vpc/README.md +579 -0
- package/dist/template/.pi/skills/cloudflare/references/workflows/README.md +62 -0
- package/dist/template/.pi/skills/cloudflare/references/workflows/api.md +125 -0
- package/dist/template/.pi/skills/cloudflare/references/workflows/configuration.md +177 -0
- package/dist/template/.pi/skills/cloudflare/references/workflows/gotchas.md +136 -0
- package/dist/template/.pi/skills/cloudflare/references/workflows/patterns.md +132 -0
- package/dist/template/.pi/skills/cloudflare/references/wrangler/README.md +90 -0
- package/dist/template/.pi/skills/cloudflare/references/wrangler/api.md +140 -0
- package/dist/template/.pi/skills/cloudflare/references/wrangler/configuration.md +128 -0
- package/dist/template/.pi/skills/cloudflare/references/wrangler/gotchas.md +93 -0
- package/dist/template/.pi/skills/cloudflare/references/wrangler/patterns.md +150 -0
- package/dist/template/.pi/skills/cloudflare/references/zaraz/README.md +360 -0
- package/dist/template/.pi/skills/code-cleanup/SKILL.md +232 -0
- package/dist/template/.pi/skills/code-review-and-quality/SKILL.md +344 -0
- package/dist/template/.pi/skills/code-simplification/SKILL.md +348 -0
- package/dist/template/.pi/skills/context-engineering/SKILL.md +296 -0
- package/dist/template/.pi/skills/core-data-expert/SKILL.md +117 -0
- package/dist/template/.pi/skills/core-data-expert/references/batch-operations.md +543 -0
- package/dist/template/.pi/skills/core-data-expert/references/cloudkit-integration.md +259 -0
- package/dist/template/.pi/skills/core-data-expert/references/concurrency.md +522 -0
- package/dist/template/.pi/skills/core-data-expert/references/fetch-requests.md +643 -0
- package/dist/template/.pi/skills/core-data-expert/references/glossary.md +233 -0
- package/dist/template/.pi/skills/core-data-expert/references/migration.md +393 -0
- package/dist/template/.pi/skills/core-data-expert/references/model-configuration.md +597 -0
- package/dist/template/.pi/skills/core-data-expert/references/performance.md +300 -0
- package/dist/template/.pi/skills/core-data-expert/references/persistent-history.md +553 -0
- package/dist/template/.pi/skills/core-data-expert/references/project-audit.md +60 -0
- package/dist/template/.pi/skills/core-data-expert/references/saving.md +574 -0
- package/dist/template/.pi/skills/core-data-expert/references/stack-setup.md +625 -0
- package/dist/template/.pi/skills/core-data-expert/references/testing.md +300 -0
- package/dist/template/.pi/skills/core-data-expert/references/threading.md +589 -0
- package/dist/template/.pi/skills/debugging-and-error-recovery/SKILL.md +274 -0
- package/dist/template/.pi/skills/deep-module-design/SKILL.md +218 -0
- package/dist/template/.pi/skills/defense-in-depth/SKILL.md +161 -0
- package/dist/template/.pi/skills/deprecation-and-migration/SKILL.md +186 -0
- package/dist/template/.pi/skills/design-system-audit/SKILL.md +176 -0
- package/dist/template/.pi/skills/design-taste-frontend/SKILL.md +255 -0
- package/dist/template/.pi/skills/development-lifecycle/SKILL.md +285 -0
- package/dist/template/.pi/skills/documentation-and-adrs/SKILL.md +217 -0
- package/dist/template/.pi/skills/doubt-driven-development/SKILL.md +207 -0
- package/dist/template/.pi/skills/fallow/SKILL.md +457 -0
- package/dist/template/.pi/skills/fallow/references/cli-reference.md +1905 -0
- package/dist/template/.pi/skills/fallow/references/gotchas.md +644 -0
- package/dist/template/.pi/skills/fallow/references/patterns.md +791 -0
- package/dist/template/.pi/skills/figma/SKILL.md +241 -0
- package/dist/template/.pi/skills/frontend-design/SKILL.md +262 -0
- package/dist/template/.pi/skills/frontend-design/references/animation/motion-advanced.md +224 -0
- package/dist/template/.pi/skills/frontend-design/references/animation/motion-core.md +181 -0
- package/dist/template/.pi/skills/frontend-design/references/canvas/execution.md +90 -0
- package/dist/template/.pi/skills/frontend-design/references/canvas/philosophy.md +94 -0
- package/dist/template/.pi/skills/frontend-design/references/design/color-system.md +111 -0
- package/dist/template/.pi/skills/frontend-design/references/design/interaction.md +149 -0
- package/dist/template/.pi/skills/frontend-design/references/design/typography-rules.md +106 -0
- package/dist/template/.pi/skills/frontend-design/references/design/ux-writing.md +99 -0
- package/dist/template/.pi/skills/frontend-design/references/shadcn/accessibility.md +132 -0
- package/dist/template/.pi/skills/frontend-design/references/shadcn/core-components.md +153 -0
- package/dist/template/.pi/skills/frontend-design/references/shadcn/form-components.md +158 -0
- package/dist/template/.pi/skills/frontend-design/references/shadcn/setup.md +69 -0
- package/dist/template/.pi/skills/frontend-design/references/shadcn/theming.md +152 -0
- package/dist/template/.pi/skills/frontend-design/references/tailwind/responsive.md +112 -0
- package/dist/template/.pi/skills/frontend-design/references/tailwind/utilities-layout.md +134 -0
- package/dist/template/.pi/skills/frontend-design/references/tailwind/utilities-styling.md +165 -0
- package/dist/template/.pi/skills/frontend-design/references/tailwind/v4-config.md +147 -0
- package/dist/template/.pi/skills/frontend-design/references/tailwind/v4-features.md +128 -0
- package/dist/template/.pi/skills/frontend-ui-engineering/SKILL.md +217 -0
- package/dist/template/.pi/skills/gemini-large-context/SKILL.md +238 -0
- package/dist/template/.pi/skills/git-workflow-and-versioning/SKILL.md +217 -0
- package/dist/template/.pi/skills/grill-me/SKILL.md +162 -0
- package/dist/template/.pi/skills/high-end-visual-design/SKILL.md +128 -0
- package/dist/template/.pi/skills/idea-refine/SKILL.md +195 -0
- package/dist/template/.pi/skills/idea-refine/examples.md +62 -0
- package/dist/template/.pi/skills/idea-refine/frameworks.md +63 -0
- package/dist/template/.pi/skills/idea-refine/refinement-criteria.md +56 -0
- package/dist/template/.pi/skills/incremental-implementation/SKILL.md +190 -0
- package/dist/template/.pi/skills/industrial-brutalist-ui/SKILL.md +131 -0
- package/dist/template/.pi/skills/interview-me/SKILL.md +227 -0
- package/dist/template/.pi/skills/jira/SKILL.md +306 -0
- package/dist/template/.pi/skills/loop-audit/SKILL.md +141 -0
- package/dist/template/.pi/skills/loop-cost/SKILL.md +130 -0
- package/dist/template/.pi/skills/loop-engineering/SKILL.md +175 -0
- package/dist/template/.pi/skills/minimalist-ui/SKILL.md +124 -0
- package/dist/template/.pi/skills/mockup-to-code/SKILL.md +197 -0
- package/dist/template/.pi/skills/observability-and-instrumentation/SKILL.md +202 -0
- package/dist/template/.pi/skills/opensrc/SKILL.md +297 -0
- package/dist/template/.pi/skills/opensrc/references/architecture.md +176 -0
- package/dist/template/.pi/skills/opensrc/references/cli-usage.md +176 -0
- package/dist/template/.pi/skills/opensrc/references/registry-support.md +137 -0
- package/dist/template/.pi/skills/pdf-extract/SKILL.md +461 -0
- package/dist/template/.pi/skills/performance-optimization/SKILL.md +233 -0
- package/dist/template/.pi/skills/performance-optimization/references/performance-checklist.md +85 -0
- package/dist/template/.pi/skills/planning-and-task-breakdown/SKILL.md +204 -0
- package/dist/template/.pi/skills/playwright/SKILL.md +404 -0
- package/dist/template/.pi/skills/playwright/references/agent-browser-cli.md +405 -0
- package/dist/template/.pi/skills/polar/SKILL.md +125 -0
- package/dist/template/.pi/skills/react-best-practices/SKILL.md +156 -0
- package/dist/template/.pi/skills/react-best-practices/rules/_sections.md +46 -0
- package/dist/template/.pi/skills/react-best-practices/rules/_template.md +28 -0
- package/dist/template/.pi/skills/react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- package/dist/template/.pi/skills/react-best-practices/rules/advanced-use-latest.md +49 -0
- package/dist/template/.pi/skills/react-best-practices/rules/async-api-routes.md +38 -0
- package/dist/template/.pi/skills/react-best-practices/rules/async-defer-await.md +80 -0
- package/dist/template/.pi/skills/react-best-practices/rules/async-dependencies.md +36 -0
- package/dist/template/.pi/skills/react-best-practices/rules/async-parallel.md +28 -0
- package/dist/template/.pi/skills/react-best-practices/rules/async-suspense-boundaries.md +99 -0
- package/dist/template/.pi/skills/react-best-practices/rules/bundle-barrel-imports.md +59 -0
- package/dist/template/.pi/skills/react-best-practices/rules/bundle-conditional.md +31 -0
- package/dist/template/.pi/skills/react-best-practices/rules/bundle-defer-third-party.md +49 -0
- package/dist/template/.pi/skills/react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- package/dist/template/.pi/skills/react-best-practices/rules/bundle-preload.md +50 -0
- package/dist/template/.pi/skills/react-best-practices/rules/client-event-listeners.md +74 -0
- package/dist/template/.pi/skills/react-best-practices/rules/client-localstorage-schema.md +71 -0
- package/dist/template/.pi/skills/react-best-practices/rules/client-passive-event-listeners.md +48 -0
- package/dist/template/.pi/skills/react-best-practices/rules/client-swr-dedup.md +56 -0
- package/dist/template/.pi/skills/react-best-practices/rules/js-batch-dom-css.md +82 -0
- package/dist/template/.pi/skills/react-best-practices/rules/js-cache-function-results.md +80 -0
- package/dist/template/.pi/skills/react-best-practices/rules/js-cache-property-access.md +28 -0
- package/dist/template/.pi/skills/react-best-practices/rules/js-cache-storage.md +70 -0
- package/dist/template/.pi/skills/react-best-practices/rules/js-combine-iterations.md +32 -0
- package/dist/template/.pi/skills/react-best-practices/rules/js-early-exit.md +50 -0
- package/dist/template/.pi/skills/react-best-practices/rules/js-hoist-regexp.md +45 -0
- package/dist/template/.pi/skills/react-best-practices/rules/js-index-maps.md +37 -0
- package/dist/template/.pi/skills/react-best-practices/rules/js-length-check-first.md +49 -0
- package/dist/template/.pi/skills/react-best-practices/rules/js-min-max-loop.md +82 -0
- package/dist/template/.pi/skills/react-best-practices/rules/js-set-map-lookups.md +24 -0
- package/dist/template/.pi/skills/react-best-practices/rules/js-tosorted-immutable.md +57 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rendering-activity.md +26 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rendering-conditional-render.md +40 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rendering-content-visibility.md +38 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rendering-svg-precision.md +28 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rerender-defer-reads.md +39 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rerender-dependencies.md +45 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rerender-derived-state.md +29 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rerender-functional-setstate.md +74 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rerender-memo.md +44 -0
- package/dist/template/.pi/skills/react-best-practices/rules/rerender-transitions.md +40 -0
- package/dist/template/.pi/skills/react-best-practices/rules/server-after-nonblocking.md +73 -0
- package/dist/template/.pi/skills/react-best-practices/rules/server-cache-lru.md +41 -0
- package/dist/template/.pi/skills/react-best-practices/rules/server-cache-react.md +76 -0
- package/dist/template/.pi/skills/react-best-practices/rules/server-parallel-fetching.md +83 -0
- package/dist/template/.pi/skills/react-best-practices/rules/server-serialization.md +38 -0
- package/dist/template/.pi/skills/redesign-existing-projects/SKILL.md +217 -0
- package/dist/template/.pi/skills/resend/SKILL.md +196 -0
- package/dist/template/.pi/skills/resend/references/react-email.md +287 -0
- package/dist/template/.pi/skills/resend/references/receive-email.md +248 -0
- package/dist/template/.pi/skills/resend/references/send-email.md +318 -0
- package/dist/template/.pi/skills/root-cause-tracing/SKILL.md +216 -0
- package/dist/template/.pi/skills/security-and-hardening/SKILL.md +293 -0
- package/dist/template/.pi/skills/security-and-hardening/references/security-checklist.md +105 -0
- package/dist/template/.pi/skills/shipping-and-launch/SKILL.md +101 -0
- package/dist/template/.pi/skills/source-driven-development/SKILL.md +108 -0
- package/dist/template/.pi/skills/spec-driven-development/SKILL.md +177 -0
- package/dist/template/.pi/skills/srcwalk/SKILL.md +182 -0
- package/dist/template/.pi/skills/subagent-driven-development/SKILL.md +253 -0
- package/dist/template/.pi/skills/supabase/SKILL.md +153 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/SKILL.md +88 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/advanced-full-text-search.md +55 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/advanced-jsonb-indexing.md +49 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/conn-idle-timeout.md +46 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/conn-limits.md +44 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/conn-pooling.md +41 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/conn-prepared-statements.md +46 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/data-batch-inserts.md +54 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/data-n-plus-one.md +53 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/data-pagination.md +50 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/data-upsert.md +50 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/lock-advisory.md +56 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/lock-deadlock-prevention.md +68 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/lock-short-transactions.md +50 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/lock-skip-locked.md +54 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/monitor-explain-analyze.md +45 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/monitor-pg-stat-statements.md +55 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/monitor-vacuum-analyze.md +55 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/query-composite-indexes.md +44 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/query-covering-indexes.md +40 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/query-index-types.md +45 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/query-missing-indexes.md +43 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/query-partial-indexes.md +45 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/schema-data-types.md +46 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/schema-foreign-key-indexes.md +59 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/schema-lowercase-identifiers.md +55 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/schema-partitioning.md +55 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/schema-primary-keys.md +61 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/security-privileges.md +54 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/security-rls-basics.md +50 -0
- package/dist/template/.pi/skills/supabase-postgres-best-practices/rules/security-rls-performance.md +57 -0
- package/dist/template/.pi/skills/swift-concurrency/SKILL.md +290 -0
- package/dist/template/.pi/skills/swift-concurrency/references/actors.md +640 -0
- package/dist/template/.pi/skills/swift-concurrency/references/async-algorithms.md +822 -0
- package/dist/template/.pi/skills/swift-concurrency/references/async-await-basics.md +249 -0
- package/dist/template/.pi/skills/swift-concurrency/references/async-sequences.md +670 -0
- package/dist/template/.pi/skills/swift-concurrency/references/core-data.md +533 -0
- package/dist/template/.pi/skills/swift-concurrency/references/glossary.md +128 -0
- package/dist/template/.pi/skills/swift-concurrency/references/linting.md +142 -0
- package/dist/template/.pi/skills/swift-concurrency/references/memory-management.md +542 -0
- package/dist/template/.pi/skills/swift-concurrency/references/migration.md +1076 -0
- package/dist/template/.pi/skills/swift-concurrency/references/performance.md +574 -0
- package/dist/template/.pi/skills/swift-concurrency/references/sendable.md +578 -0
- package/dist/template/.pi/skills/swift-concurrency/references/tasks.md +604 -0
- package/dist/template/.pi/skills/swift-concurrency/references/testing.md +565 -0
- package/dist/template/.pi/skills/swift-concurrency/references/threading.md +452 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/SKILL.md +343 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/animation-advanced.md +351 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/animation-basics.md +284 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/animation-transitions.md +326 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/image-optimization.md +286 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/layout-best-practices.md +312 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/liquid-glass.md +377 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/list-patterns.md +153 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/modern-apis.md +400 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/performance-patterns.md +377 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/scroll-patterns.md +305 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/sheet-navigation-patterns.md +292 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/state-management.md +447 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/text-formatting.md +285 -0
- package/dist/template/.pi/skills/swiftui-expert-skill/references/view-structure.md +276 -0
- package/dist/template/.pi/skills/test-driven-development/SKILL.md +400 -0
- package/dist/template/.pi/skills/test-driven-development/references/testing-patterns.md +155 -0
- package/dist/template/.pi/skills/testing-anti-patterns/SKILL.md +339 -0
- package/dist/template/.pi/skills/using-agent-skills/SKILL.md +371 -0
- package/dist/template/.pi/skills/using-git-worktrees/SKILL.md +275 -0
- package/dist/template/.pi/skills/vercel-deploy-claimable/SKILL.md +144 -0
- package/dist/template/.pi/skills/vercel-deploy-claimable/scripts/deploy.sh +249 -0
- package/dist/template/.pi/skills/verification-before-completion/SKILL.md +348 -0
- package/dist/template/.pi/skills/webclaw/SKILL.md +188 -0
- package/dist/template/.pi/skills/writing-skills/SKILL.md +329 -0
- package/dist/template/.pi/skills/writing-skills/references/anti-patterns.md +25 -0
- package/dist/template/.pi/skills/writing-skills/references/claude-search-optimization.md +140 -0
- package/dist/template/.pi/skills/writing-skills/references/discovery-workflow.md +11 -0
- package/dist/template/.pi/skills/writing-skills/references/file-organization.md +32 -0
- package/dist/template/.pi/skills/writing-skills/references/flowcharts-and-examples.md +57 -0
- package/dist/template/.pi/skills/writing-skills/references/rationalization-hardening.md +75 -0
- package/dist/template/.pi/skills/writing-skills/references/testing-methodology.md +397 -0
- package/dist/template/.pi/skills/writing-skills/references/testing-skill-types.md +52 -0
- package/dist/template/.pi/subagents.json +10 -0
- package/dist/template/.pi/templates/adr.md +47 -0
- package/dist/template/.pi/templates/design.md +61 -0
- package/dist/template/.pi/templates/loop-github-action.yml +162 -0
- package/dist/template/.pi/templates/loop-orchestrator.sh +514 -0
- package/dist/template/.pi/templates/loop-orchestrator.test.ts +332 -0
- package/dist/template/.pi/templates/loop-orchestrator.ts +936 -0
- package/dist/template/.pi/templates/loop-state.json +24 -0
- package/dist/template/.pi/templates/loop-state.md +98 -0
- package/dist/template/.pi/templates/loop-vision.md +110 -0
- package/dist/template/.pi/templates/prd.md +204 -0
- package/dist/template/.pi/templates/progress.md +55 -0
- package/dist/template/.pi/templates/project.md +58 -0
- package/dist/template/.pi/templates/proposal.md +40 -0
- package/dist/template/.pi/templates/review-state.json +20 -0
- package/dist/template/.pi/templates/roadmap.md +93 -0
- package/dist/template/.pi/templates/state.md +97 -0
- package/dist/template/.pi/templates/tasks.md +202 -0
- package/dist/template/.pi/templates/tech-stack.md +85 -0
- package/dist/template/.pi/templates/user.md +26 -0
- package/dist/template/.pi/workflows/INDEX.md +63 -0
- package/dist/template/.pi/workflows/audit-pattern.md +84 -0
- package/dist/template/.pi/workflows/batch-implement.md +121 -0
- package/dist/template/.pi/workflows/deep-research.md +89 -0
- package/dist/template/.pi/workflows/development-lifecycle-workflow.md +175 -0
- package/dist/template/.pi/workflows/garbage-collection.md +144 -0
- package/dist/template/.pi/workflows/quality-loop.md +211 -0
- 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)
|