Context
Tracks Stackbilt-dev/tarotscript#376 — once tarotscript adds ARD skeleton cards, the scaffold pipeline needs to hydrate the {{WORKER_DESCRIPTION}}, representativeQueries, and updatedAt template vars at generation time.
ARD spec: https://blog.stackbilt.dev/post/ard-mcp-agentic-resource-discovery
Problem
The workers-skeleton.deck ARD card (tarotscript#376) will emit a /.well-known/ai-catalog.json route with template placeholders. Without this downstream change, every generated scaffold will ship a stub catalog with empty/placeholder representativeQueries — which defeats the value of ARD for discoverability.
What to do in scaffold_create
When materializing a scaffold:
- Inject
{{WORKER_NAME}} — already available from the scaffold request
- Inject
{{WORKER_URL}} — derive from {worker-name}.{account}.workers.dev or let users override post-deploy
- Inject
{{WORKER_DESCRIPTION}} — use the user's project description verbatim (already passed to scaffold_create)
- Generate
representativeQueries — 3–5 natural-language queries an agent might ask to discover this worker, derived from the project description via a lightweight LLM call (Workers AI, free tier, llama-3.3-70b-fp8-fast)
- Set
updatedAt — current ISO timestamp at scaffold generation time
The representativeQueries generation can be a simple zero-shot prompt: "Given this Cloudflare Worker description, generate 4 natural-language queries an AI agent might ask to discover and select this service. Return JSON array of strings."
Dependency
Blocked on: Stackbilt-dev/tarotscript#376 (ARD skeleton cards)
Priority
Follows tarotscript#376 — file now, implement after the deck cards land.
Context
Tracks Stackbilt-dev/tarotscript#376 — once tarotscript adds ARD skeleton cards, the scaffold pipeline needs to hydrate the
{{WORKER_DESCRIPTION}},representativeQueries, andupdatedAttemplate vars at generation time.ARD spec: https://blog.stackbilt.dev/post/ard-mcp-agentic-resource-discovery
Problem
The
workers-skeleton.deckARD card (tarotscript#376) will emit a/.well-known/ai-catalog.jsonroute with template placeholders. Without this downstream change, every generated scaffold will ship a stub catalog with empty/placeholderrepresentativeQueries— which defeats the value of ARD for discoverability.What to do in
scaffold_createWhen materializing a scaffold:
{{WORKER_NAME}}— already available from the scaffold request{{WORKER_URL}}— derive from{worker-name}.{account}.workers.devor let users override post-deploy{{WORKER_DESCRIPTION}}— use the user's project description verbatim (already passed to scaffold_create)representativeQueries— 3–5 natural-language queries an agent might ask to discover this worker, derived from the project description via a lightweight LLM call (Workers AI, free tier, llama-3.3-70b-fp8-fast)updatedAt— current ISO timestamp at scaffold generation timeThe
representativeQueriesgeneration can be a simple zero-shot prompt: "Given this Cloudflare Worker description, generate 4 natural-language queries an AI agent might ask to discover and select this service. Return JSON array of strings."Dependency
Blocked on: Stackbilt-dev/tarotscript#376 (ARD skeleton cards)
Priority
Follows tarotscript#376 — file now, implement after the deck cards land.