Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/weaverse/pilot/agents-mdgit clone --depth 1 https://github.com/Weaverse/pilotWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.04400 | $0.04400 |
| Opus 5 | $0.02200 | $0.02200 |
| Sonnet 5 | $0.00880 | $0.00880 |
| Haiku 4.5 | $0.00440 | $0.00440 |
Grade A, and why
pilot AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 450 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
This file provides guidance to AI agents (Claude, GitHub Copilot, Cursor, etc.) when working with code in this repository.
Canonical agent instructions:
AGENTS.mdis the source of truth and may always be updated. RootCLAUDE.mdis a relative symlink to it and must never become a separate copy. Push completed instruction changes to the repository's default branch.
Spec Maintenance
- Search existing specs and linked issues before creating a spec.
- Update the closest canonical spec; merge overlapping specs when they describe the same user outcome and implementation boundary.
- Create a new spec only when no existing spec can absorb the work without mixing independent outcomes.
- When a dated spec is updated or merged, rename it to the current date (and current month bucket when present), preserve
Created, refreshLast Updated, and update backlinks and generated indexes in the same change.
Companion Guides
.agents/weaverse.md— required reading before changing any component schema, section, or the component registry. Covers the generated component manifest, sensitivity marking, and safe composition.DESIGN.md— brand tokens, accessibility requirements, component rules, and prohibited patterns.
Weaverse schema changes must be accompanied by a regenerated manifest:
npm run weaverse:manifest # regenerate .weaverse/component-manifest.json
npm run weaverse:audit # check registrations and setting sensitivity
CI fails when the committed manifest is stale.
Project Overview
This is Pilot, a Shopify Hydrogen theme powered by Weaverse - a visual page builder for Hydrogen storefronts. The project is built with React 19, TypeScript, React Router 7, and Tailwind CSS v4. It runs on Node.js 20+ and uses Biome for linting/formatting.
Architecture Overview
Route Structure
Routes are defined in app/routes.ts using React Router v7's programmatic routing with Hydrogen's hydrogenRoutes wrapper (migrated from flat file-based routing in v7.0.0). All routes support internationalization via the :locale? prefix:
- Homepage:
routes/home.tsx - Products:
routes/products/product.tsx(:productHandle) - Collections:
routes/collections/collection.tsx(:collectionHandle) - Account:
routes/account/*(layout-based with nested routes) - API routes:
routes/api/* - Cart operations:
routes/cart/* - Policies & Pages:
routes/pages/regular-page.tsx,routes/policies/policy.tsx - Blogs:
routes/blogs/blog.tsx,routes/blogs/article.tsx - SEO:
routes/seo/robots.ts,routes/seo/sitemap.ts
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 450 lines · 4,400 tokens per session scan A bc4d35c12ece
pilot AGENTS.md is an instructions file published in the GitHub repository Weaverse/pilot (192 stars, last pushed 6d ago), licensed MIT. It adds 4,400 tokens to every session, about $0.0220 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
weaverse AGENTS.md
Instructions for Weaverse/weaverse, covering agents.md - weaverse sdks development guide, project overview, quick reference, single package commands and monorepo architecture.
weaverse copilot-instructions.md
Instructions for Weaverse/weaverse, covering copilot instructions, coding standards, typescript guidelines, react guidelines and error handling.
weaverse writing.instructions.md
Instructions for Weaverse/weaverse: When generating content for blogs, documentation, or any other text-based content in markdown files, please follow these guidelines.
weaverse commit-message.instructions.md
Instructions for Weaverse/weaverse: Write a clear and concise description of the code, including its purpose and functionality. Make sure to include any important details or context that would help someone understand the code. Make the commit short and descriptive, summarizing the changes made in a few words. Do not…
shopify-hydrogen-skills AGENTS.md
AGENTS.md instructions for Weaverse/shopify-hydrogen-skills, covering agents.md, what this repo is, installation, repository structure and live docs strategy.
weaverse CLAUDE.md
Instructions for Weaverse/weaverse, a project described as: Open-source SDKs / toolkit for seamless integration and development of Shopify Hydrogen themes and headless commerce solutions.