codexkit 1.0.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/.codex/.env.example +27 -0
- package/.codex/.template-manifest.json +631 -0
- package/.codex/.version +1 -0
- package/.codex/agents/builder.toml +104 -0
- package/.codex/agents/debugger.toml +67 -0
- package/.codex/agents/general.toml +41 -0
- package/.codex/agents/painter.toml +40 -0
- package/.codex/agents/planner.toml +60 -0
- package/.codex/agents/refactorer.toml +76 -0
- package/.codex/agents/reviewer.toml +60 -0
- package/.codex/agents/runner.toml +40 -0
- package/.codex/agents/scout.toml +133 -0
- package/.codex/agents/shipper.toml +69 -0
- package/.codex/agents/vision.toml +69 -0
- package/.codex/config.toml +146 -0
- package/.codex/context/architecture.md +66 -0
- package/.codex/context/conventions.md +98 -0
- package/.codex/context/current-priorities.md +33 -0
- package/.codex/context/decision-log.md +93 -0
- package/.codex/context/gotchas.md +42 -0
- package/.codex/context/index.md +21 -0
- package/.codex/context/session-context.md +11 -0
- package/.codex/context/worklog.md +9 -0
- package/.codex/hooks/README.md +17 -0
- package/.codex/hooks/after_agent.sh +11 -0
- package/.codex/hooks/after_tool_use.sh +10 -0
- package/.codex/hooks/post_commit.sh +10 -0
- package/.codex/hooks/pre_commit.sh +6 -0
- package/.codex/hooks/session_start.sh +18 -0
- package/.codex/hooks/stop.sh +10 -0
- package/.codex/mcp/README.md +143 -0
- package/.codex/mcp/basic-memory.toml.example +10 -0
- package/.codex/mcp/context7.toml.example +13 -0
- package/.codex/mcp/exa.toml.example +12 -0
- package/.codex/mcp/memory-bridge.toml.example +15 -0
- package/.codex/mcp/memory.toml.example +6 -0
- package/.codex/mcp/ref.toml.example +13 -0
- package/.codex/mcp/tilth.toml.example +10 -0
- package/.codex/memory/README.md +29 -0
- package/.codex/memory/_templates/README.md +26 -0
- package/.codex/memory/_templates/design.md +15 -0
- package/.codex/memory/_templates/gotcha.md +9 -0
- package/.codex/memory/_templates/handoff.md +9 -0
- package/.codex/memory/_templates/prd.md +13 -0
- package/.codex/memory/_templates/project.md +9 -0
- package/.codex/memory/_templates/proposal.md +13 -0
- package/.codex/memory/_templates/research.md +9 -0
- package/.codex/memory/_templates/roadmap.md +11 -0
- package/.codex/memory/_templates/session-context.md +7 -0
- package/.codex/memory/_templates/state.md +11 -0
- package/.codex/memory/_templates/tasks.md +9 -0
- package/.codex/memory/_templates/tech-stack.md +9 -0
- package/.codex/memory/_templates/user.md +7 -0
- package/.codex/memory/project/gotchas.md +5 -0
- package/.codex/memory/project/project.md +12 -0
- package/.codex/memory/project/roadmap.md +15 -0
- package/.codex/memory/project/state.md +22 -0
- package/.codex/memory/project/tech-stack.md +19 -0
- package/.codex/memory/project/user.md +10 -0
- package/.codex/memory/research/.gitkeep +1 -0
- package/.codex/memory/session-context.md +18 -0
- package/.codex/plans/README.md +7 -0
- package/.codex/prompts/compound.md +154 -0
- package/.codex/prompts/create.md +238 -0
- package/.codex/prompts/design.md +90 -0
- package/.codex/prompts/handoff.md +184 -0
- package/.codex/prompts/init-context.md +185 -0
- package/.codex/prompts/init-user.md +93 -0
- package/.codex/prompts/init.md +103 -0
- package/.codex/prompts/lfg.md +140 -0
- package/.codex/prompts/plan.md +140 -0
- package/.codex/prompts/pr.md +150 -0
- package/.codex/prompts/research.md +137 -0
- package/.codex/prompts/resume.md +105 -0
- package/.codex/prompts/review-codebase.md +147 -0
- package/.codex/prompts/ship.md +334 -0
- package/.codex/prompts/start.md +141 -0
- package/.codex/prompts/status.md +102 -0
- package/.codex/prompts/ui-inspire.md +151 -0
- package/.codex/prompts/ui-review.md +86 -0
- package/.codex/prompts/verify.md +181 -0
- package/.codex/scripts/append_worklog.sh +20 -0
- package/.codex/scripts/apply_worklog_archive.sh +48 -0
- package/.codex/scripts/audit_memory_hygiene.sh +102 -0
- package/.codex/scripts/build_memory_index.sh +167 -0
- package/.codex/scripts/build_prior_related_work.sh +127 -0
- package/.codex/scripts/build_startup_brief.sh +52 -0
- package/.codex/scripts/close_bead.sh +103 -0
- package/.codex/scripts/detect_changed_files.sh +38 -0
- package/.codex/scripts/ensure_beads.sh +14 -0
- package/.codex/scripts/memory_search.sh +292 -0
- package/.codex/scripts/prepare_worklog_archive.sh +115 -0
- package/.codex/scripts/search_bead_context.sh +214 -0
- package/.codex/scripts/start_bead.sh +129 -0
- package/.codex/scripts/sync_bead_context.sh +288 -0
- package/.codex/scripts/validate_memory_docs.sh +44 -0
- package/.codex/scripts/verify_bead.sh +154 -0
- package/.codex/skills/accessibility-audit/SKILL.md +191 -0
- package/.codex/skills/agent-browser/SKILL.md +413 -0
- package/.codex/skills/agent-teams/SKILL.md +268 -0
- package/.codex/skills/augment-context-engine/SKILL.md +115 -0
- package/.codex/skills/augment-context-engine/mcp.json +6 -0
- package/.codex/skills/beads/SKILL.md +181 -0
- package/.codex/skills/beads/references/BEST_PRACTICES.md +27 -0
- package/.codex/skills/beads/references/BOUNDARIES.md +219 -0
- package/.codex/skills/beads/references/DEPENDENCIES.md +124 -0
- package/.codex/skills/beads/references/EXAMPLES.md +45 -0
- package/.codex/skills/beads/references/FILE_CLAIMING.md +101 -0
- package/.codex/skills/beads/references/GIT_SYNC.md +25 -0
- package/.codex/skills/beads/references/HIERARCHY.md +71 -0
- package/.codex/skills/beads/references/MULTI_AGENT.md +40 -0
- package/.codex/skills/beads/references/RESUMABILITY.md +177 -0
- package/.codex/skills/beads/references/SESSION_PROTOCOL.md +61 -0
- package/.codex/skills/beads/references/TASK_CREATION.md +38 -0
- package/.codex/skills/beads/references/TROUBLESHOOTING.md +38 -0
- package/.codex/skills/beads/references/WORKFLOWS.md +226 -0
- package/.codex/skills/beads-bridge/SKILL.md +321 -0
- package/.codex/skills/brainstorming/SKILL.md +114 -0
- package/.codex/skills/bug-triage/SKILL.md +191 -0
- package/.codex/skills/chrome-devtools/SKILL.md +76 -0
- package/.codex/skills/chrome-devtools/mcp.json +19 -0
- package/.codex/skills/cloudflare/SKILL.md +253 -0
- package/.codex/skills/cloudflare/references/agents-sdk/README.md +35 -0
- package/.codex/skills/cloudflare/references/agents-sdk/api.md +100 -0
- package/.codex/skills/cloudflare/references/agents-sdk/configuration.md +99 -0
- package/.codex/skills/cloudflare/references/agents-sdk/gotchas.md +59 -0
- package/.codex/skills/cloudflare/references/agents-sdk/patterns.md +89 -0
- package/.codex/skills/cloudflare/references/ai-gateway/README.md +695 -0
- package/.codex/skills/cloudflare/references/ai-search/README.md +14 -0
- package/.codex/skills/cloudflare/references/ai-search/api.md +38 -0
- package/.codex/skills/cloudflare/references/ai-search/configuration.md +52 -0
- package/.codex/skills/cloudflare/references/ai-search/gotchas.md +41 -0
- package/.codex/skills/cloudflare/references/ai-search/patterns.md +45 -0
- package/.codex/skills/cloudflare/references/analytics-engine/README.md +14 -0
- package/.codex/skills/cloudflare/references/analytics-engine/api.md +27 -0
- package/.codex/skills/cloudflare/references/analytics-engine/configuration.md +45 -0
- package/.codex/skills/cloudflare/references/analytics-engine/gotchas.md +3 -0
- package/.codex/skills/cloudflare/references/analytics-engine/patterns.md +36 -0
- package/.codex/skills/cloudflare/references/api/README.md +21 -0
- package/.codex/skills/cloudflare/references/api/api.md +31 -0
- package/.codex/skills/cloudflare/references/api/configuration.md +20 -0
- package/.codex/skills/cloudflare/references/api/gotchas.md +28 -0
- package/.codex/skills/cloudflare/references/api/patterns.md +47 -0
- package/.codex/skills/cloudflare/references/api-shield/README.md +20 -0
- package/.codex/skills/cloudflare/references/api-shield/api.md +78 -0
- package/.codex/skills/cloudflare/references/api-shield/configuration.md +128 -0
- package/.codex/skills/cloudflare/references/api-shield/gotchas.md +51 -0
- package/.codex/skills/cloudflare/references/api-shield/patterns.md +145 -0
- package/.codex/skills/cloudflare/references/argo-smart-routing/README.md +16 -0
- package/.codex/skills/cloudflare/references/argo-smart-routing/api.md +50 -0
- package/.codex/skills/cloudflare/references/argo-smart-routing/configuration.md +53 -0
- package/.codex/skills/cloudflare/references/argo-smart-routing/gotchas.md +16 -0
- package/.codex/skills/cloudflare/references/argo-smart-routing/patterns.md +45 -0
- package/.codex/skills/cloudflare/references/bindings/README.md +14 -0
- package/.codex/skills/cloudflare/references/bindings/api.md +3 -0
- package/.codex/skills/cloudflare/references/bindings/configuration.md +58 -0
- package/.codex/skills/cloudflare/references/bindings/gotchas.md +35 -0
- package/.codex/skills/cloudflare/references/bindings/patterns.md +37 -0
- package/.codex/skills/cloudflare/references/bot-management/README.md +71 -0
- package/.codex/skills/cloudflare/references/bot-management/api.md +168 -0
- package/.codex/skills/cloudflare/references/bot-management/configuration.md +114 -0
- package/.codex/skills/cloudflare/references/bot-management/gotchas.md +99 -0
- package/.codex/skills/cloudflare/references/bot-management/patterns.md +125 -0
- package/.codex/skills/cloudflare/references/browser-rendering/README.md +16 -0
- package/.codex/skills/cloudflare/references/browser-rendering/api.md +54 -0
- package/.codex/skills/cloudflare/references/browser-rendering/configuration.md +47 -0
- package/.codex/skills/cloudflare/references/browser-rendering/gotchas.md +29 -0
- package/.codex/skills/cloudflare/references/browser-rendering/patterns.md +29 -0
- package/.codex/skills/cloudflare/references/c3/README.md +264 -0
- package/.codex/skills/cloudflare/references/cache-reserve/README.md +93 -0
- package/.codex/skills/cloudflare/references/cache-reserve/api.md +176 -0
- package/.codex/skills/cloudflare/references/cache-reserve/configuration.md +164 -0
- package/.codex/skills/cloudflare/references/cache-reserve/gotchas.md +203 -0
- package/.codex/skills/cloudflare/references/cache-reserve/patterns.md +180 -0
- package/.codex/skills/cloudflare/references/containers/README.md +16 -0
- package/.codex/skills/cloudflare/references/containers/api.md +43 -0
- package/.codex/skills/cloudflare/references/containers/configuration.md +56 -0
- package/.codex/skills/cloudflare/references/containers/gotchas.md +21 -0
- package/.codex/skills/cloudflare/references/containers/patterns.md +40 -0
- package/.codex/skills/cloudflare/references/cron-triggers/README.md +85 -0
- package/.codex/skills/cloudflare/references/cron-triggers/api.md +198 -0
- package/.codex/skills/cloudflare/references/cron-triggers/configuration.md +151 -0
- package/.codex/skills/cloudflare/references/cron-triggers/gotchas.md +129 -0
- package/.codex/skills/cloudflare/references/cron-triggers/patterns.md +122 -0
- package/.codex/skills/cloudflare/references/d1/README.md +92 -0
- package/.codex/skills/cloudflare/references/d1/api.md +141 -0
- package/.codex/skills/cloudflare/references/d1/configuration.md +127 -0
- package/.codex/skills/cloudflare/references/d1/gotchas.md +70 -0
- package/.codex/skills/cloudflare/references/d1/patterns.md +144 -0
- package/.codex/skills/cloudflare/references/ddos/README.md +34 -0
- package/.codex/skills/cloudflare/references/ddos/api.md +136 -0
- package/.codex/skills/cloudflare/references/ddos/configuration.md +67 -0
- package/.codex/skills/cloudflare/references/ddos/gotchas.md +114 -0
- package/.codex/skills/cloudflare/references/ddos/patterns.md +158 -0
- package/.codex/skills/cloudflare/references/do-storage/README.md +62 -0
- package/.codex/skills/cloudflare/references/do-storage/api.md +89 -0
- package/.codex/skills/cloudflare/references/do-storage/configuration.md +116 -0
- package/.codex/skills/cloudflare/references/do-storage/gotchas.md +93 -0
- package/.codex/skills/cloudflare/references/do-storage/patterns.md +112 -0
- package/.codex/skills/cloudflare/references/durable-objects/README.md +125 -0
- package/.codex/skills/cloudflare/references/durable-objects/api.md +152 -0
- package/.codex/skills/cloudflare/references/durable-objects/configuration.md +148 -0
- package/.codex/skills/cloudflare/references/durable-objects/gotchas.md +158 -0
- package/.codex/skills/cloudflare/references/durable-objects/patterns.md +255 -0
- package/.codex/skills/cloudflare/references/email-routing/README.md +18 -0
- package/.codex/skills/cloudflare/references/email-routing/api.md +46 -0
- package/.codex/skills/cloudflare/references/email-routing/configuration.md +63 -0
- package/.codex/skills/cloudflare/references/email-routing/gotchas.md +16 -0
- package/.codex/skills/cloudflare/references/email-routing/patterns.md +46 -0
- package/.codex/skills/cloudflare/references/email-workers/README.md +598 -0
- package/.codex/skills/cloudflare/references/hyperdrive/README.md +62 -0
- package/.codex/skills/cloudflare/references/hyperdrive/api.md +137 -0
- package/.codex/skills/cloudflare/references/hyperdrive/configuration.md +133 -0
- package/.codex/skills/cloudflare/references/hyperdrive/gotchas.md +184 -0
- package/.codex/skills/cloudflare/references/hyperdrive/patterns.md +176 -0
- package/.codex/skills/cloudflare/references/images/README.md +14 -0
- package/.codex/skills/cloudflare/references/images/api.md +3 -0
- package/.codex/skills/cloudflare/references/images/configuration.md +45 -0
- package/.codex/skills/cloudflare/references/images/gotchas.md +23 -0
- package/.codex/skills/cloudflare/references/images/patterns.md +31 -0
- package/.codex/skills/cloudflare/references/kv/README.md +60 -0
- package/.codex/skills/cloudflare/references/kv/api.md +114 -0
- package/.codex/skills/cloudflare/references/kv/configuration.md +92 -0
- package/.codex/skills/cloudflare/references/kv/gotchas.md +117 -0
- package/.codex/skills/cloudflare/references/kv/patterns.md +139 -0
- package/.codex/skills/cloudflare/references/miniflare/README.md +64 -0
- package/.codex/skills/cloudflare/references/miniflare/api.md +144 -0
- package/.codex/skills/cloudflare/references/miniflare/configuration.md +203 -0
- package/.codex/skills/cloudflare/references/miniflare/gotchas.md +187 -0
- package/.codex/skills/cloudflare/references/miniflare/patterns.md +211 -0
- package/.codex/skills/cloudflare/references/network-interconnect/README.md +60 -0
- package/.codex/skills/cloudflare/references/network-interconnect/api.md +240 -0
- package/.codex/skills/cloudflare/references/network-interconnect/configuration.md +127 -0
- package/.codex/skills/cloudflare/references/network-interconnect/gotchas.md +171 -0
- package/.codex/skills/cloudflare/references/network-interconnect/patterns.md +171 -0
- package/.codex/skills/cloudflare/references/observability/README.md +18 -0
- package/.codex/skills/cloudflare/references/observability/api.md +51 -0
- package/.codex/skills/cloudflare/references/observability/configuration.md +60 -0
- package/.codex/skills/cloudflare/references/observability/gotchas.md +36 -0
- package/.codex/skills/cloudflare/references/observability/patterns.md +42 -0
- package/.codex/skills/cloudflare/references/pages/README.md +76 -0
- package/.codex/skills/cloudflare/references/pages/api.md +200 -0
- package/.codex/skills/cloudflare/references/pages/configuration.md +228 -0
- package/.codex/skills/cloudflare/references/pages/gotchas.md +161 -0
- package/.codex/skills/cloudflare/references/pages/patterns.md +145 -0
- package/.codex/skills/cloudflare/references/pages-functions/README.md +57 -0
- package/.codex/skills/cloudflare/references/pages-functions/api.md +201 -0
- package/.codex/skills/cloudflare/references/pages-functions/configuration.md +159 -0
- package/.codex/skills/cloudflare/references/pages-functions/gotchas.md +151 -0
- package/.codex/skills/cloudflare/references/pages-functions/patterns.md +190 -0
- package/.codex/skills/cloudflare/references/pipelines/README.md +664 -0
- package/.codex/skills/cloudflare/references/pulumi/README.md +107 -0
- package/.codex/skills/cloudflare/references/pulumi/api.md +194 -0
- package/.codex/skills/cloudflare/references/pulumi/configuration.md +216 -0
- package/.codex/skills/cloudflare/references/pulumi/gotchas.md +223 -0
- package/.codex/skills/cloudflare/references/pulumi/patterns.md +139 -0
- package/.codex/skills/cloudflare/references/queues/README.md +69 -0
- package/.codex/skills/cloudflare/references/queues/api.md +138 -0
- package/.codex/skills/cloudflare/references/queues/configuration.md +125 -0
- package/.codex/skills/cloudflare/references/queues/gotchas.md +112 -0
- package/.codex/skills/cloudflare/references/queues/patterns.md +155 -0
- package/.codex/skills/cloudflare/references/r2/README.md +61 -0
- package/.codex/skills/cloudflare/references/r2/api.md +127 -0
- package/.codex/skills/cloudflare/references/r2/configuration.md +76 -0
- package/.codex/skills/cloudflare/references/r2/gotchas.md +94 -0
- package/.codex/skills/cloudflare/references/r2/patterns.md +127 -0
- package/.codex/skills/cloudflare/references/r2-data-catalog/README.md +18 -0
- package/.codex/skills/cloudflare/references/r2-data-catalog/api.md +29 -0
- package/.codex/skills/cloudflare/references/r2-data-catalog/configuration.md +39 -0
- package/.codex/skills/cloudflare/references/r2-data-catalog/gotchas.md +20 -0
- package/.codex/skills/cloudflare/references/r2-data-catalog/patterns.md +46 -0
- package/.codex/skills/cloudflare/references/r2-sql/README.md +512 -0
- package/.codex/skills/cloudflare/references/realtime-sfu/README.md +21 -0
- package/.codex/skills/cloudflare/references/realtime-sfu/api.md +135 -0
- package/.codex/skills/cloudflare/references/realtime-sfu/configuration.md +63 -0
- package/.codex/skills/cloudflare/references/realtime-sfu/gotchas.md +75 -0
- package/.codex/skills/cloudflare/references/realtime-sfu/patterns.md +102 -0
- package/.codex/skills/cloudflare/references/realtimekit/README.md +81 -0
- package/.codex/skills/cloudflare/references/realtimekit/api.md +164 -0
- package/.codex/skills/cloudflare/references/realtimekit/configuration.md +147 -0
- package/.codex/skills/cloudflare/references/realtimekit/gotchas.md +172 -0
- package/.codex/skills/cloudflare/references/realtimekit/patterns.md +155 -0
- package/.codex/skills/cloudflare/references/sandbox/README.md +90 -0
- package/.codex/skills/cloudflare/references/sandbox/api.md +178 -0
- package/.codex/skills/cloudflare/references/sandbox/configuration.md +131 -0
- package/.codex/skills/cloudflare/references/sandbox/gotchas.md +156 -0
- package/.codex/skills/cloudflare/references/sandbox/patterns.md +203 -0
- package/.codex/skills/cloudflare/references/secrets-store/README.md +58 -0
- package/.codex/skills/cloudflare/references/secrets-store/api.md +182 -0
- package/.codex/skills/cloudflare/references/secrets-store/configuration.md +140 -0
- package/.codex/skills/cloudflare/references/secrets-store/gotchas.md +129 -0
- package/.codex/skills/cloudflare/references/secrets-store/patterns.md +218 -0
- package/.codex/skills/cloudflare/references/smart-placement/README.md +91 -0
- package/.codex/skills/cloudflare/references/smart-placement/api.md +139 -0
- package/.codex/skills/cloudflare/references/smart-placement/configuration.md +129 -0
- package/.codex/skills/cloudflare/references/smart-placement/gotchas.md +87 -0
- package/.codex/skills/cloudflare/references/smart-placement/patterns.md +135 -0
- package/.codex/skills/cloudflare/references/snippets/README.md +15 -0
- package/.codex/skills/cloudflare/references/snippets/api.md +47 -0
- package/.codex/skills/cloudflare/references/snippets/configuration.md +33 -0
- package/.codex/skills/cloudflare/references/snippets/gotchas.md +21 -0
- package/.codex/skills/cloudflare/references/snippets/patterns.md +34 -0
- package/.codex/skills/cloudflare/references/spectrum/README.md +16 -0
- package/.codex/skills/cloudflare/references/spectrum/api.md +24 -0
- package/.codex/skills/cloudflare/references/spectrum/configuration.md +43 -0
- package/.codex/skills/cloudflare/references/spectrum/gotchas.md +42 -0
- package/.codex/skills/cloudflare/references/spectrum/patterns.md +40 -0
- package/.codex/skills/cloudflare/references/static-assets/README.md +14 -0
- package/.codex/skills/cloudflare/references/static-assets/api.md +3 -0
- package/.codex/skills/cloudflare/references/static-assets/configuration.md +47 -0
- package/.codex/skills/cloudflare/references/static-assets/gotchas.md +44 -0
- package/.codex/skills/cloudflare/references/static-assets/patterns.md +42 -0
- package/.codex/skills/cloudflare/references/stream/README.md +103 -0
- package/.codex/skills/cloudflare/references/stream/api.md +204 -0
- package/.codex/skills/cloudflare/references/stream/configuration.md +127 -0
- package/.codex/skills/cloudflare/references/stream/gotchas.md +131 -0
- package/.codex/skills/cloudflare/references/stream/patterns.md +152 -0
- package/.codex/skills/cloudflare/references/tail-workers/README.md +640 -0
- package/.codex/skills/cloudflare/references/terraform/README.md +76 -0
- package/.codex/skills/cloudflare/references/terraform/api.md +159 -0
- package/.codex/skills/cloudflare/references/terraform/configuration.md +156 -0
- package/.codex/skills/cloudflare/references/terraform/gotchas.md +207 -0
- package/.codex/skills/cloudflare/references/terraform/patterns.md +135 -0
- package/.codex/skills/cloudflare/references/tunnel/README.md +82 -0
- package/.codex/skills/cloudflare/references/tunnel/api.md +105 -0
- package/.codex/skills/cloudflare/references/tunnel/configuration.md +113 -0
- package/.codex/skills/cloudflare/references/tunnel/gotchas.md +115 -0
- package/.codex/skills/cloudflare/references/tunnel/patterns.md +157 -0
- package/.codex/skills/cloudflare/references/turn/README.md +699 -0
- package/.codex/skills/cloudflare/references/turnstile/README.md +14 -0
- package/.codex/skills/cloudflare/references/turnstile/api.md +3 -0
- package/.codex/skills/cloudflare/references/turnstile/configuration.md +19 -0
- package/.codex/skills/cloudflare/references/turnstile/gotchas.md +27 -0
- package/.codex/skills/cloudflare/references/turnstile/patterns.md +41 -0
- package/.codex/skills/cloudflare/references/vectorize/README.md +682 -0
- package/.codex/skills/cloudflare/references/waf/README.md +14 -0
- package/.codex/skills/cloudflare/references/waf/api.md +3 -0
- package/.codex/skills/cloudflare/references/waf/configuration.md +44 -0
- package/.codex/skills/cloudflare/references/waf/gotchas.md +24 -0
- package/.codex/skills/cloudflare/references/waf/patterns.md +29 -0
- package/.codex/skills/cloudflare/references/web-analytics/README.md +19 -0
- package/.codex/skills/cloudflare/references/web-analytics/api.md +52 -0
- package/.codex/skills/cloudflare/references/web-analytics/configuration.md +31 -0
- package/.codex/skills/cloudflare/references/web-analytics/gotchas.md +28 -0
- package/.codex/skills/cloudflare/references/web-analytics/patterns.md +52 -0
- package/.codex/skills/cloudflare/references/workerd/README.md +47 -0
- package/.codex/skills/cloudflare/references/workerd/api.md +199 -0
- package/.codex/skills/cloudflare/references/workerd/configuration.md +185 -0
- package/.codex/skills/cloudflare/references/workerd/gotchas.md +203 -0
- package/.codex/skills/cloudflare/references/workerd/patterns.md +216 -0
- package/.codex/skills/cloudflare/references/workers/README.md +96 -0
- package/.codex/skills/cloudflare/references/workers/api.md +137 -0
- package/.codex/skills/cloudflare/references/workers/configuration.md +147 -0
- package/.codex/skills/cloudflare/references/workers/gotchas.md +99 -0
- package/.codex/skills/cloudflare/references/workers/patterns.md +149 -0
- package/.codex/skills/cloudflare/references/workers-ai/README.md +116 -0
- package/.codex/skills/cloudflare/references/workers-for-platforms/README.md +48 -0
- package/.codex/skills/cloudflare/references/workers-for-platforms/api.md +169 -0
- package/.codex/skills/cloudflare/references/workers-for-platforms/configuration.md +136 -0
- package/.codex/skills/cloudflare/references/workers-for-platforms/gotchas.md +130 -0
- package/.codex/skills/cloudflare/references/workers-for-platforms/patterns.md +170 -0
- package/.codex/skills/cloudflare/references/workers-playground/README.md +16 -0
- package/.codex/skills/cloudflare/references/workers-playground/api.md +20 -0
- package/.codex/skills/cloudflare/references/workers-playground/configuration.md +3 -0
- package/.codex/skills/cloudflare/references/workers-playground/gotchas.md +35 -0
- package/.codex/skills/cloudflare/references/workers-playground/patterns.md +42 -0
- package/.codex/skills/cloudflare/references/workers-vpc/README.md +579 -0
- package/.codex/skills/cloudflare/references/workflows/README.md +62 -0
- package/.codex/skills/cloudflare/references/workflows/api.md +125 -0
- package/.codex/skills/cloudflare/references/workflows/configuration.md +177 -0
- package/.codex/skills/cloudflare/references/workflows/gotchas.md +136 -0
- package/.codex/skills/cloudflare/references/workflows/patterns.md +132 -0
- package/.codex/skills/cloudflare/references/wrangler/README.md +90 -0
- package/.codex/skills/cloudflare/references/wrangler/api.md +140 -0
- package/.codex/skills/cloudflare/references/wrangler/configuration.md +128 -0
- package/.codex/skills/cloudflare/references/wrangler/gotchas.md +93 -0
- package/.codex/skills/cloudflare/references/wrangler/patterns.md +150 -0
- package/.codex/skills/cloudflare/references/zaraz/README.md +360 -0
- package/.codex/skills/code-navigation/SKILL.md +130 -0
- package/.codex/skills/code-review/SKILL.md +208 -0
- package/.codex/skills/compaction/SKILL.md +317 -0
- package/.codex/skills/condition-based-waiting/SKILL.md +123 -0
- package/.codex/skills/condition-based-waiting/example.ts +158 -0
- package/.codex/skills/context-engineering/SKILL.md +176 -0
- package/.codex/skills/context-initialization/SKILL.md +70 -0
- package/.codex/skills/context-management/SKILL.md +163 -0
- package/.codex/skills/core-data-expert/SKILL.md +93 -0
- package/.codex/skills/core-data-expert/references/batch-operations.md +543 -0
- package/.codex/skills/core-data-expert/references/cloudkit-integration.md +259 -0
- package/.codex/skills/core-data-expert/references/concurrency.md +522 -0
- package/.codex/skills/core-data-expert/references/fetch-requests.md +643 -0
- package/.codex/skills/core-data-expert/references/glossary.md +233 -0
- package/.codex/skills/core-data-expert/references/migration.md +393 -0
- package/.codex/skills/core-data-expert/references/model-configuration.md +597 -0
- package/.codex/skills/core-data-expert/references/performance.md +300 -0
- package/.codex/skills/core-data-expert/references/persistent-history.md +553 -0
- package/.codex/skills/core-data-expert/references/project-audit.md +60 -0
- package/.codex/skills/core-data-expert/references/saving.md +574 -0
- package/.codex/skills/core-data-expert/references/stack-setup.md +625 -0
- package/.codex/skills/core-data-expert/references/testing.md +300 -0
- package/.codex/skills/core-data-expert/references/threading.md +589 -0
- package/.codex/skills/debugging/SKILL.md +203 -0
- package/.codex/skills/deep-research/SKILL.md +384 -0
- package/.codex/skills/defense-in-depth/SKILL.md +166 -0
- package/.codex/skills/dependency-upgrades/SKILL.md +198 -0
- package/.codex/skills/design-system-audit/SKILL.md +153 -0
- package/.codex/skills/development-lifecycle/SKILL.md +356 -0
- package/.codex/skills/dispatching-parallel-agents/SKILL.md +191 -0
- package/.codex/skills/docs-handoff/SKILL.md +175 -0
- package/.codex/skills/executing-plans/SKILL.md +247 -0
- package/.codex/skills/figma/SKILL.md +224 -0
- package/.codex/skills/figma/mcp.json +6 -0
- package/.codex/skills/finishing-a-development-branch/SKILL.md +357 -0
- package/.codex/skills/frontend-design/SKILL.md +176 -0
- package/.codex/skills/gemini-large-context/SKILL.md +216 -0
- package/.codex/skills/git-pr-prep/SKILL.md +179 -0
- package/.codex/skills/index-knowledge/SKILL.md +413 -0
- package/.codex/skills/jira/SKILL.md +283 -0
- package/.codex/skills/jira/mcp.json +6 -0
- package/.codex/skills/memory-system/SKILL.md +93 -0
- package/.codex/skills/mockup-to-code/SKILL.md +184 -0
- package/.codex/skills/mqdh/SKILL.md +171 -0
- package/.codex/skills/obsidian/SKILL.md +187 -0
- package/.codex/skills/obsidian/mcp.json +22 -0
- package/.codex/skills/opensrc/SKILL.md +127 -0
- package/.codex/skills/opensrc/references/architecture.md +176 -0
- package/.codex/skills/opensrc/references/cli-usage.md +176 -0
- package/.codex/skills/opensrc/references/registry-support.md +137 -0
- package/.codex/skills/pdf-extract/SKILL.md +438 -0
- package/.codex/skills/playwright/SKILL.md +320 -0
- package/.codex/skills/playwright/mcp.json +16 -0
- package/.codex/skills/playwriter/SKILL.md +158 -0
- package/.codex/skills/polar/SKILL.md +102 -0
- package/.codex/skills/prd/SKILL.md +146 -0
- package/.codex/skills/prd-task/SKILL.md +182 -0
- package/.codex/skills/prd-task/references/prd-schema.json +124 -0
- package/.codex/skills/prompt-leverage/SKILL.md +69 -0
- package/.codex/skills/prompt-leverage/agents/openai.yaml +4 -0
- package/.codex/skills/prompt-leverage/references/framework.md +91 -0
- package/.codex/skills/prompt-leverage/scripts/augment_prompt.py +114 -0
- package/.codex/skills/ralph/SKILL.md +296 -0
- package/.codex/skills/react-best-practices/AGENTS.md +2410 -0
- package/.codex/skills/react-best-practices/README.md +123 -0
- package/.codex/skills/react-best-practices/SKILL.md +133 -0
- package/.codex/skills/react-best-practices/metadata.json +15 -0
- package/.codex/skills/react-best-practices/rules/_sections.md +46 -0
- package/.codex/skills/react-best-practices/rules/_template.md +28 -0
- package/.codex/skills/react-best-practices/rules/advanced-event-handler-refs.md +55 -0
- package/.codex/skills/react-best-practices/rules/advanced-use-latest.md +49 -0
- package/.codex/skills/react-best-practices/rules/async-api-routes.md +38 -0
- package/.codex/skills/react-best-practices/rules/async-defer-await.md +80 -0
- package/.codex/skills/react-best-practices/rules/async-dependencies.md +36 -0
- package/.codex/skills/react-best-practices/rules/async-parallel.md +28 -0
- package/.codex/skills/react-best-practices/rules/async-suspense-boundaries.md +99 -0
- package/.codex/skills/react-best-practices/rules/bundle-barrel-imports.md +59 -0
- package/.codex/skills/react-best-practices/rules/bundle-conditional.md +31 -0
- package/.codex/skills/react-best-practices/rules/bundle-defer-third-party.md +49 -0
- package/.codex/skills/react-best-practices/rules/bundle-dynamic-imports.md +35 -0
- package/.codex/skills/react-best-practices/rules/bundle-preload.md +50 -0
- package/.codex/skills/react-best-practices/rules/client-event-listeners.md +74 -0
- package/.codex/skills/react-best-practices/rules/client-localstorage-schema.md +71 -0
- package/.codex/skills/react-best-practices/rules/client-passive-event-listeners.md +48 -0
- package/.codex/skills/react-best-practices/rules/client-swr-dedup.md +56 -0
- package/.codex/skills/react-best-practices/rules/js-batch-dom-css.md +82 -0
- package/.codex/skills/react-best-practices/rules/js-cache-function-results.md +80 -0
- package/.codex/skills/react-best-practices/rules/js-cache-property-access.md +28 -0
- package/.codex/skills/react-best-practices/rules/js-cache-storage.md +70 -0
- package/.codex/skills/react-best-practices/rules/js-combine-iterations.md +32 -0
- package/.codex/skills/react-best-practices/rules/js-early-exit.md +50 -0
- package/.codex/skills/react-best-practices/rules/js-hoist-regexp.md +45 -0
- package/.codex/skills/react-best-practices/rules/js-index-maps.md +37 -0
- package/.codex/skills/react-best-practices/rules/js-length-check-first.md +49 -0
- package/.codex/skills/react-best-practices/rules/js-min-max-loop.md +82 -0
- package/.codex/skills/react-best-practices/rules/js-set-map-lookups.md +24 -0
- package/.codex/skills/react-best-practices/rules/js-tosorted-immutable.md +57 -0
- package/.codex/skills/react-best-practices/rules/rendering-activity.md +26 -0
- package/.codex/skills/react-best-practices/rules/rendering-animate-svg-wrapper.md +47 -0
- package/.codex/skills/react-best-practices/rules/rendering-conditional-render.md +40 -0
- package/.codex/skills/react-best-practices/rules/rendering-content-visibility.md +38 -0
- package/.codex/skills/react-best-practices/rules/rendering-hoist-jsx.md +46 -0
- package/.codex/skills/react-best-practices/rules/rendering-hydration-no-flicker.md +82 -0
- package/.codex/skills/react-best-practices/rules/rendering-svg-precision.md +28 -0
- package/.codex/skills/react-best-practices/rules/rerender-defer-reads.md +39 -0
- package/.codex/skills/react-best-practices/rules/rerender-dependencies.md +45 -0
- package/.codex/skills/react-best-practices/rules/rerender-derived-state.md +29 -0
- package/.codex/skills/react-best-practices/rules/rerender-functional-setstate.md +74 -0
- package/.codex/skills/react-best-practices/rules/rerender-lazy-state-init.md +58 -0
- package/.codex/skills/react-best-practices/rules/rerender-memo.md +44 -0
- package/.codex/skills/react-best-practices/rules/rerender-transitions.md +40 -0
- package/.codex/skills/react-best-practices/rules/server-after-nonblocking.md +73 -0
- package/.codex/skills/react-best-practices/rules/server-cache-lru.md +41 -0
- package/.codex/skills/react-best-practices/rules/server-cache-react.md +76 -0
- package/.codex/skills/react-best-practices/rules/server-parallel-fetching.md +83 -0
- package/.codex/skills/react-best-practices/rules/server-serialization.md +38 -0
- package/.codex/skills/receiving-code-review/SKILL.md +252 -0
- package/.codex/skills/refactoring/SKILL.md +217 -0
- package/.codex/skills/repo-orientation/SKILL.md +156 -0
- package/.codex/skills/requesting-code-review/SKILL.md +397 -0
- package/.codex/skills/resend/SKILL.md +177 -0
- package/.codex/skills/resend/references/react-email.md +287 -0
- package/.codex/skills/resend/references/receive-email.md +248 -0
- package/.codex/skills/resend/references/send-email.md +318 -0
- package/.codex/skills/root-cause-tracing/SKILL.md +192 -0
- package/.codex/skills/root-cause-tracing/find-polluter.sh +63 -0
- package/.codex/skills/safe-implementation/SKILL.md +205 -0
- package/.codex/skills/session-management/SKILL.md +10 -0
- package/.codex/skills/sharing-skills/SKILL.md +214 -0
- package/.codex/skills/skill-creator/SKILL.md +156 -0
- package/.codex/skills/source-code-research/SKILL.md +293 -0
- package/.codex/skills/source-code-research/references/analysis-tips.md +43 -0
- package/.codex/skills/source-code-research/references/anti-patterns.md +36 -0
- package/.codex/skills/source-code-research/references/common-patterns.md +57 -0
- package/.codex/skills/source-code-research/references/example-workflow.md +60 -0
- package/.codex/skills/source-code-research/references/further-reading.md +5 -0
- package/.codex/skills/source-code-research/references/source-structure.md +45 -0
- package/.codex/skills/stitch/SKILL.md +147 -0
- package/.codex/skills/stitch/mcp.json +9 -0
- package/.codex/skills/structured-edit/SKILL.md +181 -0
- package/.codex/skills/subagent-driven-development/SKILL.md +237 -0
- package/.codex/skills/supabase/SKILL.md +130 -0
- package/.codex/skills/supabase/mcp.json +27 -0
- package/.codex/skills/supabase-postgres-best-practices/AGENTS.md +1490 -0
- package/.codex/skills/supabase-postgres-best-practices/SKILL.md +65 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/advanced-full-text-search.md +55 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/advanced-jsonb-indexing.md +49 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/conn-idle-timeout.md +46 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/conn-limits.md +44 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/conn-pooling.md +41 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/conn-prepared-statements.md +46 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/data-batch-inserts.md +54 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/data-n-plus-one.md +53 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/data-pagination.md +50 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/data-upsert.md +50 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/lock-advisory.md +56 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/lock-deadlock-prevention.md +68 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/lock-short-transactions.md +50 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/lock-skip-locked.md +54 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/monitor-explain-analyze.md +45 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/monitor-pg-stat-statements.md +55 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/monitor-vacuum-analyze.md +55 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/query-composite-indexes.md +44 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/query-covering-indexes.md +40 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/query-index-types.md +45 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/query-missing-indexes.md +43 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/query-partial-indexes.md +45 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/schema-data-types.md +46 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/schema-foreign-key-indexes.md +59 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/schema-lowercase-identifiers.md +55 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/schema-partitioning.md +55 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/schema-primary-keys.md +61 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/security-privileges.md +54 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/security-rls-basics.md +50 -0
- package/.codex/skills/supabase-postgres-best-practices/rules/security-rls-performance.md +57 -0
- package/.codex/skills/swarm-coordination/SKILL.md +179 -0
- package/.codex/skills/swarm-coordination/references/architecture.md +39 -0
- package/.codex/skills/swarm-coordination/references/delegation-worker-protocol.md +145 -0
- package/.codex/skills/swarm-coordination/references/dependency-graph.md +50 -0
- package/.codex/skills/swarm-coordination/references/drift-check.md +90 -0
- package/.codex/skills/swarm-coordination/references/integration-beads.md +20 -0
- package/.codex/skills/swarm-coordination/references/launch-flow.md +186 -0
- package/.codex/skills/swarm-coordination/references/reconciler.md +172 -0
- package/.codex/skills/swarm-coordination/references/tier-enforcement.md +78 -0
- package/.codex/skills/swarm-coordination/references/tmux-integration.md +134 -0
- package/.codex/skills/swift-concurrency/SKILL.md +266 -0
- package/.codex/skills/swift-concurrency/references/actors.md +640 -0
- package/.codex/skills/swift-concurrency/references/async-algorithms.md +822 -0
- package/.codex/skills/swift-concurrency/references/async-await-basics.md +249 -0
- package/.codex/skills/swift-concurrency/references/async-sequences.md +670 -0
- package/.codex/skills/swift-concurrency/references/core-data.md +533 -0
- package/.codex/skills/swift-concurrency/references/glossary.md +128 -0
- package/.codex/skills/swift-concurrency/references/linting.md +142 -0
- package/.codex/skills/swift-concurrency/references/memory-management.md +542 -0
- package/.codex/skills/swift-concurrency/references/migration.md +1076 -0
- package/.codex/skills/swift-concurrency/references/performance.md +574 -0
- package/.codex/skills/swift-concurrency/references/sendable.md +578 -0
- package/.codex/skills/swift-concurrency/references/tasks.md +604 -0
- package/.codex/skills/swift-concurrency/references/testing.md +565 -0
- package/.codex/skills/swift-concurrency/references/threading.md +452 -0
- package/.codex/skills/swiftui-expert-skill/SKILL.md +329 -0
- package/.codex/skills/swiftui-expert-skill/references/animation-advanced.md +351 -0
- package/.codex/skills/swiftui-expert-skill/references/animation-basics.md +284 -0
- package/.codex/skills/swiftui-expert-skill/references/animation-transitions.md +326 -0
- package/.codex/skills/swiftui-expert-skill/references/image-optimization.md +286 -0
- package/.codex/skills/swiftui-expert-skill/references/layout-best-practices.md +312 -0
- package/.codex/skills/swiftui-expert-skill/references/liquid-glass.md +377 -0
- package/.codex/skills/swiftui-expert-skill/references/list-patterns.md +153 -0
- package/.codex/skills/swiftui-expert-skill/references/modern-apis.md +400 -0
- package/.codex/skills/swiftui-expert-skill/references/performance-patterns.md +377 -0
- package/.codex/skills/swiftui-expert-skill/references/scroll-patterns.md +305 -0
- package/.codex/skills/swiftui-expert-skill/references/sheet-navigation-patterns.md +292 -0
- package/.codex/skills/swiftui-expert-skill/references/state-management.md +447 -0
- package/.codex/skills/swiftui-expert-skill/references/text-formatting.md +285 -0
- package/.codex/skills/swiftui-expert-skill/references/view-structure.md +276 -0
- package/.codex/skills/systematic-debugging/SKILL.md +402 -0
- package/.codex/skills/task-planning/SKILL.md +205 -0
- package/.codex/skills/test-driven-development/SKILL.md +388 -0
- package/.codex/skills/test-strategy/SKILL.md +186 -0
- package/.codex/skills/testing-anti-patterns/SKILL.md +320 -0
- package/.codex/skills/testing-skills-with-subagents/SKILL.md +405 -0
- package/.codex/skills/tilth-cli/SKILL.md +180 -0
- package/.codex/skills/tool-priority/SKILL.md +299 -0
- package/.codex/skills/ui-inspiration-scout/SKILL.md +203 -0
- package/.codex/skills/ui-ux-research/SKILL.md +35 -0
- package/.codex/skills/using-git-worktrees/SKILL.md +259 -0
- package/.codex/skills/using-skills/SKILL.md +117 -0
- package/.codex/skills/v0/SKILL.md +158 -0
- package/.codex/skills/v0/mcp.json +6 -0
- package/.codex/skills/v1-run/SKILL.md +175 -0
- package/.codex/skills/v1-run/mcp.json +6 -0
- package/.codex/skills/vercel-deploy-claimable/SKILL.md +124 -0
- package/.codex/skills/vercel-deploy-claimable/scripts/deploy.sh +249 -0
- package/.codex/skills/verification/SKILL.md +191 -0
- package/.codex/skills/verification-before-completion/SKILL.md +236 -0
- package/.codex/skills/visual-analysis/SKILL.md +154 -0
- package/.codex/skills/web-design-guidelines/SKILL.md +46 -0
- package/.codex/skills/writing-plans/SKILL.md +320 -0
- package/.codex/skills/writing-skills/SKILL.md +287 -0
- package/.codex/skills/writing-skills/anthropic-best-practices.md +1173 -0
- package/.codex/skills/writing-skills/graphviz-conventions.dot +172 -0
- package/.codex/skills/writing-skills/persuasion-principles.md +220 -0
- package/.codex/skills/writing-skills/references/anti-patterns.md +25 -0
- package/.codex/skills/writing-skills/references/claude-search-optimization.md +140 -0
- package/.codex/skills/writing-skills/references/discovery-workflow.md +11 -0
- package/.codex/skills/writing-skills/references/file-organization.md +32 -0
- package/.codex/skills/writing-skills/references/flowcharts-and-examples.md +57 -0
- package/.codex/skills/writing-skills/references/rationalization-hardening.md +75 -0
- package/.codex/skills/writing-skills/references/testing-skill-types.md +52 -0
- package/.template-manifest.json +631 -0
- package/AGENTS.md +719 -0
- package/AGENTS.override.md.example +7 -0
- package/CHANGELOG.md +28 -0
- package/LICENSE +21 -0
- package/README.md +641 -0
- package/bin/codexkit +148 -0
- package/install/bead-close.sh +20 -0
- package/install/bead-search.sh +18 -0
- package/install/bead-start.sh +20 -0
- package/install/bead-sync.sh +19 -0
- package/install/bead-verify.sh +20 -0
- package/install/generate-manifest.sh +55 -0
- package/install/install-global.sh +150 -0
- package/install/install-project.sh +704 -0
- package/install/install-remote.sh +152 -0
- package/install/patch.sh +478 -0
- package/install/plugin.sh +565 -0
- package/install/run-codex.sh +68 -0
- package/install/template.sh +620 -0
- package/install/validate.sh +653 -0
- package/package.json +39 -0
- package/templates/global/.codex-config-template.toml +87 -0
- package/templates/global/AGENTS.override.md +18 -0
- package/templates/global/README.md +29 -0
- package/templates/project/.codex-config-template.toml +26 -0
- package/templates/project/AGENTS.md.template +27 -0
- package/templates/project/README.md +24 -0
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tilth-cli
|
|
3
|
+
description: AST-aware code navigation via tilth CLI. Use when subagents need structural code search, smart file reading, or codebase mapping — complements MCP tilth (which only the main agent can access).
|
|
4
|
+
version: 1.0.0
|
|
5
|
+
tags: [code-navigation, search, subagent]
|
|
6
|
+
dependencies: []
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# tilth CLI for Subagents
|
|
10
|
+
|
|
11
|
+
> **Why this exists:** tilth MCP tools (`tilth_tilth_search`, `tilth_tilth_read`, etc.) are only available to the main agent. Subagents cannot access MCP tools but CAN use Bash. This skill teaches subagents to call tilth directly from the command line.
|
|
12
|
+
|
|
13
|
+
## When to Use
|
|
14
|
+
|
|
15
|
+
- When subagents need structural code search (they cannot access tilth MCP tools)
|
|
16
|
+
- When you need `--map` for codebase skeleton (CLI-only feature, not in MCP)
|
|
17
|
+
- For any agent that has Bash access but not tilth MCP
|
|
18
|
+
|
|
19
|
+
## When NOT to Use
|
|
20
|
+
|
|
21
|
+
- Main agent should prefer tilth MCP tools — they have session dedup and hash-anchored editing
|
|
22
|
+
- For trivial lookups where grep/read suffices
|
|
23
|
+
|
|
24
|
+
## Prerequisites
|
|
25
|
+
|
|
26
|
+
tilth must be available. Use `npx -y tilth` if not globally installed:
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
npx -y tilth <query> [options]
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## How tilth CLI Works
|
|
33
|
+
|
|
34
|
+
tilth has **one command** with **smart auto-detection**. Pass a query and it figures out what to do:
|
|
35
|
+
|
|
36
|
+
| Query Pattern | Detection | Action |
|
|
37
|
+
| ------------- | -------------------------------- | ------------------------------------------------------- |
|
|
38
|
+
| `src/auth.ts` | File path (exists on disk) | **Read file** — smart outline for large, full for small |
|
|
39
|
+
| `handleAuth` | Symbol name (camelCase, etc.) | **Symbol search** — AST definitions + usages |
|
|
40
|
+
| `"*.test.ts"` | Glob pattern (contains `*`, `?`) | **File listing** — matched paths with token estimates |
|
|
41
|
+
| `"TODO fix"` | Text (doesn't match above) | **Text search** — literal content matches |
|
|
42
|
+
|
|
43
|
+
## Core Operations
|
|
44
|
+
|
|
45
|
+
### 1. Read a File
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
npx -y tilth src/index.ts # Smart view (outline if large, full if small)
|
|
49
|
+
npx -y tilth src/index.ts --full # Force full content
|
|
50
|
+
npx -y tilth src/index.ts --section 45-89 # Exact line range
|
|
51
|
+
npx -y tilth src/index.ts --section "## Config" # By heading
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
Output: numbered lines (`N content`). Large files get a structural outline; use `--section` to drill into specific ranges.
|
|
55
|
+
|
|
56
|
+
### 2. Search for Symbols
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
npx -y tilth initCommand --scope src/ # Find definition + all usages
|
|
60
|
+
npx -y tilth handleAuth --scope src/auth/ # Scoped to subdirectory
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Returns: definitions first (with expanded source), then usages with context lines.
|
|
64
|
+
|
|
65
|
+
### 3. Search for Text
|
|
66
|
+
|
|
67
|
+
```bash
|
|
68
|
+
npx -y tilth "TODO" --scope src/ # Literal text search
|
|
69
|
+
npx -y tilth "version" --scope src/ # Finds all occurrences
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
tilth auto-detects text vs symbol. Identifiers (camelCase, snake_case) → symbol search. Multi-word or quoted strings → text search.
|
|
73
|
+
|
|
74
|
+
### 4. List Files (Glob)
|
|
75
|
+
|
|
76
|
+
```bash
|
|
77
|
+
npx -y tilth "*.test.ts" --scope src/ # List test files
|
|
78
|
+
npx -y tilth "*.ts" --scope src/commands/ # List TS files in subdir
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
Returns: matched file paths with token size estimates.
|
|
82
|
+
|
|
83
|
+
### 5. Codebase Map (CLI-Only)
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
npx -y tilth --map --scope src/ # Structural skeleton
|
|
87
|
+
npx -y tilth --map --scope . # Whole project
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Returns: directory tree with exported symbols per file. **CLI-only** — not available in MCP mode.
|
|
91
|
+
|
|
92
|
+
## Available Flags
|
|
93
|
+
|
|
94
|
+
| Flag | Purpose | Example |
|
|
95
|
+
| ------------------- | -------------------------------------- | -------------------- |
|
|
96
|
+
| `--scope <DIR>` | Restrict search to directory | `--scope src/` |
|
|
97
|
+
| `--section <RANGE>` | Line range or heading for file reads | `--section 45-89` |
|
|
98
|
+
| `--full` | Force full file content (skip outline) | `--full` |
|
|
99
|
+
| `--budget <N>` | Max tokens in response | `--budget 2000` |
|
|
100
|
+
| `--json` | Machine-readable JSON output | `--json` |
|
|
101
|
+
| `--map` | Generate codebase structure map | `--map --scope src/` |
|
|
102
|
+
|
|
103
|
+
**Note:** `--kind`, `--deps`, `--expand`, and multi-symbol comma syntax are MCP-only features. The CLI does not support them.
|
|
104
|
+
|
|
105
|
+
## MCP vs CLI Comparison
|
|
106
|
+
|
|
107
|
+
| Feature | MCP (main agent) | CLI (all agents) |
|
|
108
|
+
| ------------------------------------- | ---------------- | ------------------- |
|
|
109
|
+
| Session dedup (`[shown earlier]`) | Yes | No |
|
|
110
|
+
| Hash-anchored editing (`tilth_edit`) | Yes | No |
|
|
111
|
+
| Blast-radius analysis (`tilth_deps`) | Yes | No |
|
|
112
|
+
| Multi-symbol search (`sym1,sym2`) | Yes | No |
|
|
113
|
+
| `--kind` flag (content/regex/callers) | Yes | No |
|
|
114
|
+
| `--expand` control | Yes | No |
|
|
115
|
+
| `--map` codebase skeleton | No | Yes |
|
|
116
|
+
| Subagent access | No (main only) | Yes (any with Bash) |
|
|
117
|
+
| Process overhead | Once (~17ms) | Per call (~17ms) |
|
|
118
|
+
|
|
119
|
+
## Output Format Examples
|
|
120
|
+
|
|
121
|
+
### File read (small file)
|
|
122
|
+
|
|
123
|
+
```
|
|
124
|
+
# src/config.ts (45 lines, ~380 tokens) [full]
|
|
125
|
+
|
|
126
|
+
1 import { z } from 'zod';
|
|
127
|
+
2 export const schema = z.object({
|
|
128
|
+
...
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
### Symbol search
|
|
132
|
+
|
|
133
|
+
```
|
|
134
|
+
# Search: "initCommand" in src/ — 6 matches (2 definitions, 4 usages)
|
|
135
|
+
|
|
136
|
+
### Definitions (2)
|
|
137
|
+
## commands/init.ts:515-961 [definition]
|
|
138
|
+
→ [515-961] export async function initCommand(...)
|
|
139
|
+
|
|
140
|
+
### Usages — same package (4)
|
|
141
|
+
## index.ts:10 [usage]
|
|
142
|
+
→ [10] import { initCommand } from "./commands/init.js";
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
### Codebase map
|
|
146
|
+
|
|
147
|
+
```
|
|
148
|
+
# Map: src/ (depth 3)
|
|
149
|
+
index.ts (~1214 tokens)
|
|
150
|
+
commands/
|
|
151
|
+
init.ts: initCommand, detectMode, ...
|
|
152
|
+
upgrade.ts: checkVersion, upgradeCommand, ...
|
|
153
|
+
utils/
|
|
154
|
+
errors.ts: resolveProjectPath, showError, ...
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
## Usage Tips
|
|
158
|
+
|
|
159
|
+
- **Search first, read second** — symbol search finds definitions AND shows expanded source
|
|
160
|
+
- **Use `--section` for large files** — outline tells you line ranges; drill in with `--section 44-89`
|
|
161
|
+
- **Use `--scope`** to narrow searches — avoids scanning irrelevant directories
|
|
162
|
+
- **Use `--budget`** when you need concise output (limits token count)
|
|
163
|
+
- **~17ms per call** — fast enough for interactive use, but avoid unnecessary repeated calls
|
|
164
|
+
|
|
165
|
+
## Example Subagent Dispatch
|
|
166
|
+
|
|
167
|
+
```typescript
|
|
168
|
+
task({
|
|
169
|
+
subagent_type: "general",
|
|
170
|
+
prompt: `Use tilth CLI for code navigation (run via: npx -y tilth).
|
|
171
|
+
|
|
172
|
+
Find the definition of \`initCommand\` and understand how it's called:
|
|
173
|
+
npx -y tilth initCommand --scope src/
|
|
174
|
+
|
|
175
|
+
Then read the relevant file section:
|
|
176
|
+
npx -y tilth src/commands/init.ts --section 515-600
|
|
177
|
+
|
|
178
|
+
[rest of task instructions]`,
|
|
179
|
+
});
|
|
180
|
+
```
|
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tool-priority
|
|
3
|
+
description: Use when choosing between tools or need tool reference - covers LSP, search, swarm, memory, and research tools with correct syntax
|
|
4
|
+
version: 1.0.0
|
|
5
|
+
tags: [workflow, context]
|
|
6
|
+
dependencies: []
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Tool Priority Skill
|
|
10
|
+
|
|
11
|
+
## When to Use
|
|
12
|
+
|
|
13
|
+
- You need to decide which tool to use for a task or recall tool syntax
|
|
14
|
+
- You are about to edit code and want the correct discovery/order of operations
|
|
15
|
+
|
|
16
|
+
## When NOT to Use
|
|
17
|
+
|
|
18
|
+
- You already know the exact tool and syntax required
|
|
19
|
+
- The task is purely conceptual with no tool usage
|
|
20
|
+
|
|
21
|
+
## Priority Order
|
|
22
|
+
|
|
23
|
+
**LSP → Search → Swarm → Memory → File Operations**
|
|
24
|
+
|
|
25
|
+
1. **LSP** - Semantic code intelligence (9 operations via unified tool)
|
|
26
|
+
2. **tilth** (MCP) - AST-aware code search + smart file reading. Replaces grep/glob/read for code navigation when available
|
|
27
|
+
3. **grep** - Fast text search (logs, config, code patterns). Replaces bash rg/grep
|
|
28
|
+
4. **glob** - File discovery by name pattern. Replaces bash find/ls
|
|
29
|
+
5. **skill** - Load skills for specialized knowledge
|
|
30
|
+
6. **task** - Parallel subagent execution
|
|
31
|
+
7. **Swarm tool** - swarm (plan, monitor, delegate, sync operations)
|
|
32
|
+
8. **Memory tools** - memory-search, memory-read, memory-update, memory-admin
|
|
33
|
+
9. **Research tools** - context7, websearch, codesearch, grepsearch
|
|
34
|
+
10. **read/edit/write** - File operations (always read before edit)
|
|
35
|
+
|
|
36
|
+
**Golden Rule**: Always `read` before `edit` to verify content.
|
|
37
|
+
|
|
38
|
+
## Choosing the Right Tool
|
|
39
|
+
|
|
40
|
+
Ask: **"Am I looking for semantic understanding or just text?"**
|
|
41
|
+
|
|
42
|
+
### Code Understanding (Use LSP)
|
|
43
|
+
|
|
44
|
+
The `lsp` tool provides 9 operations via a unified interface:
|
|
45
|
+
|
|
46
|
+
| Need | Operation | Example |
|
|
47
|
+
| -------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------- |
|
|
48
|
+
| Type info at cursor | `hover` | `lsp({ operation: "hover", filePath: "src/file.ts", line: 42, character: 10 })` |
|
|
49
|
+
| Jump to definition | `goToDefinition` | `lsp({ operation: "goToDefinition", filePath: "src/file.ts", line: 42, character: 10 })` |
|
|
50
|
+
| Find all usages | `findReferences` | `lsp({ operation: "findReferences", filePath: "src/file.ts", line: 42, character: 10 })` |
|
|
51
|
+
| File structure | `documentSymbol` | `lsp({ operation: "documentSymbol", filePath: "src/file.ts", line: 1, character: 1 })` |
|
|
52
|
+
| Workspace search | `workspaceSymbol` | `lsp({ operation: "workspaceSymbol", filePath: "src/file.ts", line: 1, character: 1, query: "UserService" })` |
|
|
53
|
+
| Find implementations | `goToImplementation` | `lsp({ operation: "goToImplementation", filePath: "src/file.ts", line: 42, character: 10 })` |
|
|
54
|
+
| Call hierarchy | `prepareCallHierarchy` | `lsp({ operation: "prepareCallHierarchy", filePath: "src/file.ts", line: 42, character: 10 })` |
|
|
55
|
+
| Incoming calls | `incomingCalls` | `lsp({ operation: "incomingCalls", filePath: "src/file.ts", line: 42, character: 10 })` |
|
|
56
|
+
| Outgoing calls | `outgoingCalls` | `lsp({ operation: "outgoingCalls", filePath: "src/file.ts", line: 42, character: 10 })` |
|
|
57
|
+
|
|
58
|
+
**Critical**: Run ALL 9 LSP operations before editing. See AGENTS.md for the full checklist.
|
|
59
|
+
|
|
60
|
+
### Text Search (Use grep)
|
|
61
|
+
|
|
62
|
+
| Need | Pattern | Example |
|
|
63
|
+
| ----------------- | ---------------- | ------------------------------------------ |
|
|
64
|
+
| Function calls | `functionName\(` | `grep({ pattern: "fetchUser\(" })` |
|
|
65
|
+
| Import statements | `import.*from` | `grep({ pattern: "import.*from.*react" })` |
|
|
66
|
+
| Error messages | `FATAL\|ERROR` | `grep({ pattern: "ERROR\|FATAL" })` |
|
|
67
|
+
| TODO comments | `TODO\|FIXME` | `grep({ pattern: "TODO\|FIXME" })` |
|
|
68
|
+
| Hook usage | `useState\(` | `grep({ pattern: "useState\(" })` |
|
|
69
|
+
| Debug logs | `console\.log` | `grep({ pattern: "console\.log" })` |
|
|
70
|
+
|
|
71
|
+
### Load Skills (Use skill tool)
|
|
72
|
+
|
|
73
|
+
Load specialized knowledge before starting work:
|
|
74
|
+
|
|
75
|
+
```typescript
|
|
76
|
+
// Essential skills for most work
|
|
77
|
+
skill({ name: "verification-before-completion" });
|
|
78
|
+
skill({ name: "test-driven-development" });
|
|
79
|
+
|
|
80
|
+
// Domain-specific skills
|
|
81
|
+
skill({ name: "beads" }); // Task tracking
|
|
82
|
+
skill({ name: "beads-bridge" }); // Swarm coordination
|
|
83
|
+
skill({ name: "swarm-coordination" }); // Parallel execution
|
|
84
|
+
skill({ name: "frontend-design" }); // UI implementation
|
|
85
|
+
skill({ name: "prd" }); // Requirements documents
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### Parallel Execution (Use Task tool)
|
|
89
|
+
|
|
90
|
+
Launch multiple subagents simultaneously:
|
|
91
|
+
|
|
92
|
+
```typescript
|
|
93
|
+
// Workers run in parallel when multiple Task calls in one message
|
|
94
|
+
Task({
|
|
95
|
+
subagent_type: "explore",
|
|
96
|
+
description: "Find patterns",
|
|
97
|
+
prompt: `Find auth patterns in codebase...`,
|
|
98
|
+
});
|
|
99
|
+
|
|
100
|
+
Task({
|
|
101
|
+
subagent_type: "scout",
|
|
102
|
+
description: "Research docs",
|
|
103
|
+
prompt: `Research best practices for...`,
|
|
104
|
+
});
|
|
105
|
+
// Results return when both complete
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
**Subagent types**: `general`, `explore`, `scout`, `review`, `plan`
|
|
109
|
+
|
|
110
|
+
### Swarm Coordination Tools
|
|
111
|
+
|
|
112
|
+
| Tool | Purpose | Key Operations |
|
|
113
|
+
| --------- | -------------------------- | ------------------------------------- |
|
|
114
|
+
| **swarm** | Unified swarm coordination | `plan`, `monitor`, `delegate`, `sync` |
|
|
115
|
+
|
|
116
|
+
**swarm operations:**
|
|
117
|
+
|
|
118
|
+
- `plan`: Task analysis (actions: analyze, classify, check, allocate)
|
|
119
|
+
- `monitor`: Progress tracking (actions: progress_update, render_block, status, clear)
|
|
120
|
+
- `delegate`: Create delegation packets for workers
|
|
121
|
+
- `sync`: Beads state sync and export flow (actions: push, pull, create_shared, update_shared)
|
|
122
|
+
|
|
123
|
+
### Memory Tools
|
|
124
|
+
|
|
125
|
+
| Tool | Purpose | When to Use |
|
|
126
|
+
| ----------------- | ------------------------- | ----------------------------------- |
|
|
127
|
+
| **memory-search** | Find past learnings | "Have we solved this before?" |
|
|
128
|
+
| **memory-read** | Load specific memory file | "What did we decide about X?" |
|
|
129
|
+
| **memory-update** | Save context | "Document this for future sessions" |
|
|
130
|
+
| **observation** | Record decisions/patterns | "This is worth remembering" |
|
|
131
|
+
|
|
132
|
+
### Research Tools
|
|
133
|
+
|
|
134
|
+
| Tool | Purpose | When to Use |
|
|
135
|
+
| ----------------- | --------------------------------------------------------------- | ----------------------- |
|
|
136
|
+
| **context7** | Library documentation lookup. Replaces manual doc searching | API reference, examples |
|
|
137
|
+
| **websearch** | Web search. Replaces browser for current info | Docs not in Context7 |
|
|
138
|
+
| **codesearch** | Code examples from GitHub. Replaces manual GitHub search | Real-world patterns |
|
|
139
|
+
| **grepsearch** | Cross-repo code patterns. Replaces browsing GitHub for examples | grep.app search |
|
|
140
|
+
| **webfetch** | Fetch specific URL content. Replaces curl/browser | User-provided links |
|
|
141
|
+
| **review (Task)** | Second opinion | Validate approach |
|
|
142
|
+
|
|
143
|
+
**context7 operations:**
|
|
144
|
+
|
|
145
|
+
- `resolve`: Find library ID from name (e.g., "react" → "/reactjs/react.dev")
|
|
146
|
+
- `query`: Get documentation for a library topic
|
|
147
|
+
|
|
148
|
+
### With tilth MCP (When Available)
|
|
149
|
+
|
|
150
|
+
tilth provides AST-aware code intelligence. When installed, prefer tilth tools over built-in equivalents:
|
|
151
|
+
|
|
152
|
+
| Need | Without tilth | With tilth | Why tilth wins |
|
|
153
|
+
| --------------- | -------------------- | ------------------------------- | ------------------------------------------------------- |
|
|
154
|
+
| Find symbol | `grep` + `read` | `tilth_search` (expand: 2) | Returns definitions with inline source — no second read |
|
|
155
|
+
| Read large file | `read` (full) | `tilth_read` | Auto-outlines, shows structure; section drill-down |
|
|
156
|
+
| Find files | `glob` | `tilth_files` | Adds token estimates per file |
|
|
157
|
+
| Find callers | `lsp(incomingCalls)` | `tilth_search(kind: "callers")` | Cross-language, structural matching |
|
|
158
|
+
| Blast radius | Manual tracing | `tilth_deps` | Shows imports + downstream callers automatically |
|
|
159
|
+
|
|
160
|
+
**WHEN to use tilth_deps**: Before renaming, removing, or changing the signature of an export.
|
|
161
|
+
**SKIP**: When adding new code, fixing internal bugs, or just reading.
|
|
162
|
+
|
|
163
|
+
**IMPORTANT**: Expanded tilth_search results include full source code — do NOT re-read files already shown in search output.
|
|
164
|
+
|
|
165
|
+
## Workflow Pattern
|
|
166
|
+
|
|
167
|
+
```typescript
|
|
168
|
+
// Step 1: Load skills
|
|
169
|
+
skill({ name: "verification-before-completion" });
|
|
170
|
+
skill({ name: "beads" });
|
|
171
|
+
|
|
172
|
+
// Step 2: Find it (text search)
|
|
173
|
+
grep({ pattern: "functionName", path: "src/" });
|
|
174
|
+
|
|
175
|
+
// Step 3: Understand it (LSP - ALL 9 operations)
|
|
176
|
+
lsp({ operation: "documentSymbol", filePath: "src/file.ts", line: 1, character: 1 });
|
|
177
|
+
lsp({ operation: "goToDefinition", filePath: "src/file.ts", line: 42, character: 10 });
|
|
178
|
+
lsp({ operation: "findReferences", filePath: "src/file.ts", line: 42, character: 10 });
|
|
179
|
+
lsp({ operation: "hover", filePath: "src/file.ts", line: 42, character: 10 });
|
|
180
|
+
// ... remaining 5 operations
|
|
181
|
+
|
|
182
|
+
// Step 4: Check memory
|
|
183
|
+
memory_search({ query: "auth patterns" });
|
|
184
|
+
|
|
185
|
+
// Step 5: Read before edit
|
|
186
|
+
read({ filePath: "/absolute/path/to/file.ts" });
|
|
187
|
+
|
|
188
|
+
// Step 6: Modify
|
|
189
|
+
edit({ filePath: "/absolute/path/to/file.ts", oldString: "...", newString: "..." });
|
|
190
|
+
|
|
191
|
+
// Step 7: Verify
|
|
192
|
+
bash({ command: "npm run typecheck && npm run lint" });
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
## Tool Comparison
|
|
196
|
+
|
|
197
|
+
### grep vs LSP
|
|
198
|
+
|
|
199
|
+
| Scenario | Use | Why |
|
|
200
|
+
| ------------------ | --------------------------- | ------------------------------------------- |
|
|
201
|
+
| "Find all X" | `grep` | Fast text search, includes comments/strings |
|
|
202
|
+
| "Where is X used?" | `lsp` with `findReferences` | Semantic, tracks actual code dependencies |
|
|
203
|
+
| "What type is X?" | `lsp` with `hover` | Type system intelligence |
|
|
204
|
+
| "Find TODOs" | `grep` | Text search across all files |
|
|
205
|
+
|
|
206
|
+
### When to Use What
|
|
207
|
+
|
|
208
|
+
**Start with LSP when:**
|
|
209
|
+
|
|
210
|
+
- Understanding code structure
|
|
211
|
+
- Before any edit (ALL 9 operations)
|
|
212
|
+
- Tracing dependencies
|
|
213
|
+
- Getting type information
|
|
214
|
+
|
|
215
|
+
**Start with grep when:**
|
|
216
|
+
|
|
217
|
+
- Quick exploration ("are there any X?")
|
|
218
|
+
- Finding error patterns, logs, configs
|
|
219
|
+
- Searching across file types (JSON, YAML, etc.)
|
|
220
|
+
|
|
221
|
+
**Use skill when:**
|
|
222
|
+
|
|
223
|
+
- Starting any significant work
|
|
224
|
+
- Need specialized knowledge
|
|
225
|
+
- Following established patterns
|
|
226
|
+
|
|
227
|
+
**Use Task when:**
|
|
228
|
+
|
|
229
|
+
- Multiple independent research questions
|
|
230
|
+
- Parallel implementation tasks
|
|
231
|
+
- 3+ files need simultaneous work
|
|
232
|
+
|
|
233
|
+
## Common Mistakes
|
|
234
|
+
|
|
235
|
+
❌ **Wrong**: Edit without LSP
|
|
236
|
+
|
|
237
|
+
```typescript
|
|
238
|
+
// DON'T: Edit without understanding structure
|
|
239
|
+
edit({ filePath: "src/file.ts", oldString: "...", newString: "..." });
|
|
240
|
+
```
|
|
241
|
+
|
|
242
|
+
✅ **Right**: LSP before edit
|
|
243
|
+
|
|
244
|
+
```typescript
|
|
245
|
+
// DO: Run all 9 LSP operations first
|
|
246
|
+
lsp({ operation: "documentSymbol", filePath: "src/file.ts", line: 1, character: 1 });
|
|
247
|
+
lsp({ operation: "goToDefinition", filePath: "src/file.ts", line: 10, character: 5 });
|
|
248
|
+
// ... 7 more operations
|
|
249
|
+
read({ filePath: "src/file.ts" });
|
|
250
|
+
edit({ filePath: "src/file.ts", oldString: "...", newString: "..." });
|
|
251
|
+
```
|
|
252
|
+
|
|
253
|
+
❌ **Wrong**: Old LSP syntax
|
|
254
|
+
|
|
255
|
+
```typescript
|
|
256
|
+
// DON'T: This syntax doesn't exist
|
|
257
|
+
lsp_lsp_hover((filePath = "src/file.ts"), (line = 42), (character = 10));
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
✅ **Right**: Correct LSP syntax
|
|
261
|
+
|
|
262
|
+
```typescript
|
|
263
|
+
// DO: Use operation parameter
|
|
264
|
+
lsp({ operation: "hover", filePath: "src/file.ts", line: 42, character: 10 });
|
|
265
|
+
```
|
|
266
|
+
|
|
267
|
+
## Quick Reference
|
|
268
|
+
|
|
269
|
+
```
|
|
270
|
+
BEFORE EDITING:
|
|
271
|
+
lsp({ operation: "documentSymbol", ... }) → File structure
|
|
272
|
+
lsp({ operation: "goToDefinition", ... }) → Where defined
|
|
273
|
+
lsp({ operation: "findReferences", ... }) → All usages
|
|
274
|
+
lsp({ operation: "hover", ... }) → Type info
|
|
275
|
+
lsp({ operation: "goToImplementation", ... }) → Implementations
|
|
276
|
+
lsp({ operation: "prepareCallHierarchy", ... }) → Call hierarchy
|
|
277
|
+
lsp({ operation: "incomingCalls", ... }) → What calls this
|
|
278
|
+
lsp({ operation: "outgoingCalls", ... }) → What this calls
|
|
279
|
+
lsp({ operation: "workspaceSymbol", ... }) → Workspace search
|
|
280
|
+
|
|
281
|
+
SEARCHING:
|
|
282
|
+
grep({ pattern: "...", path: "src/" }) → Text search
|
|
283
|
+
glob({ pattern: "**/*.ts" }) → File discovery
|
|
284
|
+
|
|
285
|
+
PARALLEL WORK:
|
|
286
|
+
Task({ subagent_type: "explore", ... }) → Parallel subagent
|
|
287
|
+
swarm({ operation: "sync", action: "push" }) → Sync to todos
|
|
288
|
+
swarm({ operation: "monitor", action: "progress_update" }) → Track progress
|
|
289
|
+
|
|
290
|
+
RESEARCH:
|
|
291
|
+
context7({ operation: "resolve", libraryName: "..." })
|
|
292
|
+
context7({ operation: "query", libraryId: "...", topic: "..." })
|
|
293
|
+
websearch({ query: "..." })
|
|
294
|
+
Task({ subagent_type: "review", description: "Second opinion", prompt: "Review the approach." })
|
|
295
|
+
|
|
296
|
+
MEMORY:
|
|
297
|
+
memory_search({ query: "..." }) → Find past learnings
|
|
298
|
+
observation({ type: "learning", ... }) → Record for future
|
|
299
|
+
```
|
|
@@ -0,0 +1,203 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: ui-inspiration-scout
|
|
3
|
+
description: Find external UI inspiration grounded in the current codebase's design patterns. Use when you need designer-style reference hunting before implementing or revising a UI.
|
|
4
|
+
version: 1.0.0
|
|
5
|
+
tags: [ui, design, research]
|
|
6
|
+
dependencies: []
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# UI Inspiration Scout
|
|
10
|
+
|
|
11
|
+
## When to Use
|
|
12
|
+
|
|
13
|
+
- Exploring visual directions for a new component, page, flow, or design system
|
|
14
|
+
- Looking for external references that fit an existing product style
|
|
15
|
+
- Avoiding generic AI-slop by grounding inspiration in real product patterns
|
|
16
|
+
- Preparing a shortlist of references before `/prompts:design` or implementation
|
|
17
|
+
|
|
18
|
+
## When NOT to Use
|
|
19
|
+
|
|
20
|
+
- Pure code implementation tasks with no design exploration step
|
|
21
|
+
- Accessibility-only audits with no inspiration or visual direction work
|
|
22
|
+
- Library/API documentation lookups that are not about UI patterns
|
|
23
|
+
|
|
24
|
+
## Outcome
|
|
25
|
+
|
|
26
|
+
Produce a codebase-grounded inspiration brief, not a random link dump.
|
|
27
|
+
|
|
28
|
+
The result should include:
|
|
29
|
+
|
|
30
|
+
1. Current codebase UI signals
|
|
31
|
+
2. Search brief and constraints
|
|
32
|
+
3. External inspiration shortlist with verified links
|
|
33
|
+
4. What to borrow, adapt, and avoid
|
|
34
|
+
5. Suggested next command
|
|
35
|
+
|
|
36
|
+
## Workflow
|
|
37
|
+
|
|
38
|
+
### 1. Ground in the codebase first
|
|
39
|
+
|
|
40
|
+
Before searching externally, inspect the existing UI surface:
|
|
41
|
+
|
|
42
|
+
- design tokens and CSS variables
|
|
43
|
+
- Tailwind or CSS conventions
|
|
44
|
+
- key page/component patterns
|
|
45
|
+
- density, tone, hierarchy, card treatment, nav patterns, and motion style
|
|
46
|
+
- reusable primitives or design-system conventions already in use
|
|
47
|
+
|
|
48
|
+
Look at the actual code before proposing references.
|
|
49
|
+
|
|
50
|
+
Useful local targets:
|
|
51
|
+
|
|
52
|
+
- `tailwind.config.*`
|
|
53
|
+
- `components.json`
|
|
54
|
+
- `globals.css`
|
|
55
|
+
- `src/components/**/*`
|
|
56
|
+
- `src/app/**/*`
|
|
57
|
+
- `app/**/*`
|
|
58
|
+
- `pages/**/*`
|
|
59
|
+
|
|
60
|
+
Extract a short UI signature:
|
|
61
|
+
|
|
62
|
+
- product type
|
|
63
|
+
- interface type
|
|
64
|
+
- visual tone
|
|
65
|
+
- layout style
|
|
66
|
+
- interaction style
|
|
67
|
+
- keep / change / avoid constraints
|
|
68
|
+
|
|
69
|
+
### 2. Build the search brief
|
|
70
|
+
|
|
71
|
+
Turn the codebase signature plus the user request into a short search brief:
|
|
72
|
+
|
|
73
|
+
- target surface: component, page, flow, system
|
|
74
|
+
- domain: fintech, SaaS, commerce, media, etc.
|
|
75
|
+
- style direction: editorial, minimal, brutalist, premium, playful, utilitarian, etc.
|
|
76
|
+
- implementation constraints: mobile-first, dark mode, dense tables, card-heavy, no large rewrites, etc.
|
|
77
|
+
|
|
78
|
+
Do not search with vague terms like `beautiful dashboard`.
|
|
79
|
+
Prefer specific combinations such as:
|
|
80
|
+
|
|
81
|
+
- `B2B analytics dashboard dense data minimal`
|
|
82
|
+
- `editorial pricing page luxury serif dark mode`
|
|
83
|
+
- `mobile settings flow calm utility ios-like`
|
|
84
|
+
|
|
85
|
+
### 3. Search external sources deliberately
|
|
86
|
+
|
|
87
|
+
Preferred order:
|
|
88
|
+
|
|
89
|
+
1. Exa or web/image search for current visual references
|
|
90
|
+
2. Ref/docs/source search for implementation-adjacent design examples
|
|
91
|
+
3. Context7 only when a UI library/framework pattern needs authoritative docs
|
|
92
|
+
|
|
93
|
+
Typical sources:
|
|
94
|
+
|
|
95
|
+
- Dribbble
|
|
96
|
+
- Mobbin
|
|
97
|
+
- Awwwards
|
|
98
|
+
- Land-book / Landingfolio style galleries
|
|
99
|
+
- High-quality product sites
|
|
100
|
+
- Official component library examples
|
|
101
|
+
|
|
102
|
+
Rules:
|
|
103
|
+
|
|
104
|
+
- Cite verified URLs only
|
|
105
|
+
- Prefer recent, implementation-relevant references over flashy concept art
|
|
106
|
+
- Select references that match the existing codebase trajectory, not a total redesign unless requested
|
|
107
|
+
- Avoid copyrighted copying; extract patterns, not clones
|
|
108
|
+
|
|
109
|
+
### 4. Use `ui-ux-pro-max` as an optional enhancer
|
|
110
|
+
|
|
111
|
+
If the local skill `$ui-ux-pro-max` is available, use it after codebase grounding to widen:
|
|
112
|
+
|
|
113
|
+
- palette options
|
|
114
|
+
- typography pairings
|
|
115
|
+
- style alternatives
|
|
116
|
+
- stack-specific implementation guidance
|
|
117
|
+
|
|
118
|
+
Use it to enrich the search brief, not to replace codebase analysis.
|
|
119
|
+
|
|
120
|
+
Good pattern:
|
|
121
|
+
|
|
122
|
+
1. inspect current UI locally
|
|
123
|
+
2. define search brief
|
|
124
|
+
3. optionally run `ui-ux-pro-max` design-system search
|
|
125
|
+
4. search external references
|
|
126
|
+
5. synthesize a shortlist tied back to the repo
|
|
127
|
+
|
|
128
|
+
### 5. Synthesize, do not dump
|
|
129
|
+
|
|
130
|
+
Return 3-5 references max.
|
|
131
|
+
|
|
132
|
+
For each reference include:
|
|
133
|
+
|
|
134
|
+
- source
|
|
135
|
+
- URL
|
|
136
|
+
- why it matches this codebase
|
|
137
|
+
- what to borrow
|
|
138
|
+
- what to avoid copying
|
|
139
|
+
|
|
140
|
+
Then propose 2-3 design directions:
|
|
141
|
+
|
|
142
|
+
- safest evolution
|
|
143
|
+
- stronger visual push
|
|
144
|
+
- optional wildcard direction
|
|
145
|
+
|
|
146
|
+
### 6. Hand off cleanly
|
|
147
|
+
|
|
148
|
+
Finish with:
|
|
149
|
+
|
|
150
|
+
- recommended direction
|
|
151
|
+
- implementation guardrails
|
|
152
|
+
- next command:
|
|
153
|
+
- `/prompts:design` for detailed design output
|
|
154
|
+
- `/prompts:ui-review` for critique of an existing screen
|
|
155
|
+
- `/prompts:start` if the direction is already settled
|
|
156
|
+
|
|
157
|
+
## Output Template
|
|
158
|
+
|
|
159
|
+
```markdown
|
|
160
|
+
## Codebase UI Signature
|
|
161
|
+
- Product/UI type:
|
|
162
|
+
- Current patterns:
|
|
163
|
+
- Keep:
|
|
164
|
+
- Change:
|
|
165
|
+
- Avoid:
|
|
166
|
+
|
|
167
|
+
## Search Brief
|
|
168
|
+
- Query themes:
|
|
169
|
+
- Constraints:
|
|
170
|
+
- Source preference:
|
|
171
|
+
|
|
172
|
+
## Inspiration Shortlist
|
|
173
|
+
1. [Title](https://...)
|
|
174
|
+
- Match:
|
|
175
|
+
- Borrow:
|
|
176
|
+
- Avoid:
|
|
177
|
+
|
|
178
|
+
## Directions
|
|
179
|
+
### Direction A
|
|
180
|
+
### Direction B
|
|
181
|
+
### Direction C
|
|
182
|
+
|
|
183
|
+
## Recommendation
|
|
184
|
+
- Best fit:
|
|
185
|
+
- Why:
|
|
186
|
+
- Next step:
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
## Anti-Patterns
|
|
190
|
+
|
|
191
|
+
- Starting from Dribbble before reading the actual UI code
|
|
192
|
+
- Dumping 10+ links with no synthesis
|
|
193
|
+
- Recommending a full visual reset when the user asked for iteration
|
|
194
|
+
- Mixing incompatible visual languages with no rationale
|
|
195
|
+
- Using Context7 as a moodboard search tool instead of authoritative UI-library docs
|
|
196
|
+
|
|
197
|
+
## Verification
|
|
198
|
+
|
|
199
|
+
- Did you read the current UI code first?
|
|
200
|
+
- Are all cited links verified?
|
|
201
|
+
- Does every reference include a match rationale?
|
|
202
|
+
- Did you distinguish what to borrow from what to avoid?
|
|
203
|
+
- Is the recommendation implementable in this repo's current stack?
|