Builder Start Here Specialist route for developers and agent-builders.
Language
Builder route map

Start with the human path, then let the machine path mirror it.

Use this route after the product story is already clear. Read the builder pack and phase-1 contract first, then use the static catalog, starters, pack, and bundle mirrors as the machine-readable version of the same route before you switch to local runtime exports.

Human path first: builder pack, contract, then runtime. If you still need the product pitch or the evidence trail, go back to Compare Preview and Proof first. Native Claude/Codex bundle candidates and listing-prep inputs only come after the route is clear, and none of them mean an official listing exists yet.

Both paths still stop at the same read-only, local-first boundary. No hosted control plane, no published listing, and no write-side MCP promise.

Local runtime export surfaces

PYTHONPATH=src uv run python -m dealwatch --help
PYTHONPATH=src uv run python -m dealwatch builder-starter-pack --json
PYTHONPATH=src uv run python -m dealwatch builder-client-config codex --json
PYTHONPATH=src uv run python -m dealwatch builder-client-config --all --json
PYTHONPATH=src uv run python -m dealwatch.mcp list-tools --json
PYTHONPATH=src uv run python -m dealwatch.mcp client-starters --json
PYTHONPATH=src uv run python -m dealwatch.mcp client-config --client codex --json
PYTHONPATH=src uv run python -m dealwatch.mcp serve --transport stdio

Follow the builder route in order

Human path: builder pack, contract, runtime. Machine path: catalog, starters, pack, bundle, contract, then local runtime exports.

1. Static client catalog

Open builder-client-catalog.json when you want prompt, skill, recipe, and example links in one machine-readable index.

2. Client starters mirror

Use builder-client-starters.json to inspect the per-client prompt path, skill path, launch command, and plugin boundary before local runtime wiring.

3. Builder starter pack

Use builder-starter-pack.json, GET /api/runtime/builder-starter-pack, or get_builder_starter_pack before deeper integration work.

4. All-clients bundle

Use builder-client-configs.json or python -m dealwatch builder-client-config --all --json when you want one copyable payload that covers every current client.

5. Phase-1 contract

Read dealwatch-api-mcp-substrate-phase1.md after the static mirrors so the promises, boundaries, and runtime surfaces stay tied to the same proof path.

6. Local runtime exports

Use python -m dealwatch builder-client-config codex --json, list-tools --json, and the HTTP or MCP export surfaces once you are ready to wire the local runtime.

7. Compare before writes

Use compare_preview before assuming any grocery URL deserves durable watch state.

Client map

These clients consume DealWatch truth. They are not the runtime base that DealWatch runs on.

Client Prompt starter Skill card Safe first flow
Claude Code docs/integrations/prompts/claude-code-starter.md docs/integrations/skills/claude-code-readonly-builder-skill.md get_runtime_readiness -> get_builder_starter_pack -> compare_preview
Codex docs/integrations/prompts/codex-starter.md docs/integrations/skills/codex-readonly-builder-skill.md get_runtime_readiness -> get_builder_starter_pack -> compare_preview
OpenHands docs/integrations/prompts/openhands-starter.md docs/integrations/skills/openhands-readonly-builder-skill.md get_runtime_readiness -> get_builder_starter_pack -> compare_preview
OpenCode docs/integrations/prompts/opencode-starter.md docs/integrations/skills/opencode-readonly-builder-skill.md get_runtime_readiness -> get_builder_starter_pack -> compare_preview
OpenClaw docs/integrations/prompts/openclaw-starter.md docs/integrations/skills/openclaw-readonly-builder-skill.md get_runtime_readiness -> get_builder_starter_pack -> compare_preview

Static builder mirrors

GitHub Pages now also serves static JSON mirrors for the client starters, builder starter pack, and the full all-clients config bundle, so a machine reader can study the repo-owned contract before starting the local runtime.

These static mirrors are public proof assets for prompt starters, skill cards, starter maps, and all-clients payloads; they are not a hosted runtime or a write-capable control plane.

Machine-readable client catalog

The public builders surface now also ships a static JSON catalog that mirrors the repo-owned client map without pretending the runtime itself is hosted.

Use it when an agent needs prompt, skill, recipe, and example links in one read before starting the local runtime.

Config recipe ledger

Claude Code, Codex, OpenHands, OpenCode, and OpenClaw now all have copyable local-config examples here, but they still sit on top of the same read-only DealWatch contract.

Client Recipe Example Source Syntax status
Claude Code docs/integrations/recipes/claude-code.md Example file Official docs Official
Codex docs/integrations/recipes/codex.md Example file Official docs Official
OpenHands docs/integrations/recipes/openhands.md Example file Official docs Official
OpenCode docs/integrations/recipes/opencode.md Example file Official docs Official
OpenClaw docs/integrations/recipes/openclaw.md Example file Official docs Official

Need a machine-readable handoff? The same builder page now points to both per-client and all-clients config export surfaces for CLI, HTTP, and MCP consumers.

Verified wrapper syntax now points back to the same repo-owned builder pack and local-first contract, but it still does not prove a published listing, hosted control plane, or write-side MCP.

Builder pack, native bundles, and crawlable entrypoints

Once the read-only route is clear, this frontdoor also exposes repo-owned builder-pack docs, native bundle candidates, listing-prep inputs, and crawlable machine entrypoints that stay tied back to the same local runtime contract.

Builder pack docs

Use the builder pack, prompt starters, skill cards, config recipes, and local config exports as the repo-owned frontdesk for every current DealWatch builder client.

Native bundle candidates

Claude Code and Codex now also have repo-owned native bundle artifacts in the shared builder pack. OpenHands has a submitted OpenHands/extensions receipt, OpenCode remains an ecosystem-listing candidate, and OpenClaw now has a live ClawHub skill.

Listing-prep inputs

Use the builders page, proof page, static mirrors, and social preview art as listing-prep inputs for future marketplace or ecosystem submissions. They are ready for copy review and screenshots, not proof that any listing is live.

SEO entrypoints

Search crawlers and LLM readers can now follow builders.html, llms.txt, sitemap.xml, feed.xml, and robots.txt as the same crawlable frontdoor into the route map.

These are builder-pack, native-bundle, and listing-prep materials layered behind the honest read-only route. Published marketplace listings and hosted control planes still remain outside this first slice.

Boundary reminder

A good builder frontdoor says both what to open next and what not to assume yet, so the page does not quietly turn into plugin theater.

Bundle candidates, not official listings

DealWatch now ships repo-owned builder-pack materials for every client, native bundle candidates for Claude Code and Codex, and listing-prep inputs for the broader ecosystem. That still does not mean any official marketplace or registry listing already exists.

No hosted control plane

These builder paths are local-first. They do not prove a hosted remote control plane is live today.

No write-side MCP promise

The current builder surface is read-only-first. Maintenance, cleanup, owner bootstrap, and maintainer-only browser debug commands stay outside the builder promise.

No recommendation overclaim

DealWatch now ships a local Compare Preview recommendation slice, but builder surfaces still do not expose autonomous or builder-facing buy / wait recommendation support.