| name | source-mirror |
| description | Clone/update project-local source mirrors under .agent-sources, keep them out of commits, and read docs/source before making API claims. |
Source Mirror
Use when researching Cloudflare Agents SDK, Think, Effect, prior inspiration repos, or any external source before implementation.
Rules
- Clone source repos into project-local
.agent-sources/.
- Keep
.agent-sources/ out of commits via .git/info/exclude, not project .gitignore, unless Joel explicitly wants it committed.
- Prefer shallow clones for speed.
- Read source/docs before claiming API behavior. Vibes are a footgun.
Cloudflare Agents mirror
Expected setup:
mkdir -p .agent-sources
git clone --depth 1 --filter=blob:none https://github.com/cloudflare/agents.git .agent-sources/cloudflare-agents
printf '\n.agent-sources/\n' >> .git/info/exclude
Useful paths:
.agent-sources/cloudflare-agents/docs/**.agent-sources/cloudflare-agents/docs/think/**.agent-sources/cloudflare-agents/packages/agents/src/**.agent-sources/cloudflare-agents/packages/think/src/**.agent-sources/cloudflare-agents/examples/**
Effect source
Before writing, reviewing, or refactoring Effect code, hydrate/search official Effect source through the pi-effect/effect-source workflow.
Expected path:
.agent-sources/effect
Research receipt
Capture source-backed findings in .brain/resources/ with:
- local mirror path
- repo URL
- observed commit when useful
- files read
- answer / tradeoffs
- open questions
Do not let chat be the only record.
