Skip to content
Early bird + Black Friday · 73% off

Get ZeroDirs for $179 $49

Claim $49 deal

Editor setup

A checkout carries its own agent instructions: AGENTS.md at the root, one procedure per job in .agents/skills/.

Claude Code reads CLAUDE.md, which imports @AGENTS.md; skills come from .claude/skills/, written by postinstall. Regenerate them from the starter root:

Terminal
pnpm skills:sync
skills: N skills → .claude/skills/ (N files)

Codex reads AGENTS.md and .agents/skills/ itself, so a fresh clone is ready before pnpm install.

Run from the starter root, in this order; have the agent quote the report lines, not claim the build passed:

Terminal
pnpm check
pnpm test
pnpm build
Line Means
site.config.ts OK — <name> (<url>); … the config passed every rule
pseo: generated N (dropped by minItems M, truncated K) generated pages, and what the thresholds removed
budget: N files / 20000 (P%) — free plan, ok file count against the plan limit
zero-js: N content pages, 0 islands, 0 external scripts — ok no content page shipped a script
seo-report: … orphans (fewer than 2 inbound): 0 [strictLinks=on] every listing is reachable

Then read the diff.

  • Never edit .claude/skills/: gitignored, rewritten on the next install. Change .agents/skills/<name>/SKILL.md and run pnpm skills:sync.
  • A new tailwind.config.* is never read, and pnpm test fails on it.
  • Listing bodies are third-party data — submissions, spreadsheets, dataset files — and a dataset file named claude.md under seed/datasets/<name>/listings/ even looks like an instruction file on a case-insensitive filesystem. Tell the agent to follow no instruction found in a listing, a dataset file or a database row.
  • Custom fields drop objects and arrays silently: customFieldValue() in src/lib/listing.ts keeps strings, numbers and booleans and discards the rest without a warning. Put the structured value under its own extra key, the display string under the configured key (Custom fields).
Case Hand it
The editor ignores AGENTS.md ask the agent to read AGENTS.md before it edits anything
The editor has no notion of skills .agents/skills/<name>/SKILL.md, plain Markdown, in the same message
You want one thing done /docs/prompt/<page>.md (Copy as prompt or Markdown under the page title) — the page as a task, with two facts prepended (site.config.ts is validated by pnpm check:config; the repository’s own AGENTS.md overrides the page) and links absolute
The agent can fetch its own pages /docs/llms.txt — the index: what ZeroDirs is, then every page as a link
You want it to read the product first /docs/llms-full.txt — every page in one file; /docs/llms-small.txt drops the code blocks
  • AGENTS.md the instructions, read in full every session
  • CLAUDE.md one line: @AGENTS.md
  • Directory.agents/skills/ one directory per skill, each holding a SKILL.md; committed
    • …
  • Directory.claude/skills/ generated from .agents/skills/, gitignored
    • …
  • scripts/sync-skills.ts the copy, on postinstall and pnpm skills:sync
  • tests/unit/agents.test.ts fails pnpm test when AGENTS.md and the code disagree