# Source Mirror

> Clone/update project-local source mirrors under .agent-sources, keep them out of commits, and read docs/source before making API claims.

- Skill: `joelhooks/source-mirror` (Agent Skill)
- Install (CLI): `npx skillmds@latest add joelhooks/source-mirror`
- Raw SKILL.md: https://api.skillmd.com/api/skills/joelhooks/source-mirror/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: joelhooks (https://skillmd.com/u/joelhooks)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/joelhooks/source-mirror

---


# 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:

```bash
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:

```txt
.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.