.claudeignore

# .claudeignore — paths Claude Code should not traverse, glob, or grep.
#
# Why this file exists
# --------------------
# .gitignore controls what Git tracks; it does NOT scope what Claude Code reads.
# AGH carries 24 GB of Turbo cache, 3.6 GB of vendored competitor repos under
# .resources/, multi-MB generated OpenAPI artifacts, and long-lived QA/runtime
# data under .compozy/. Without this file every broad Grep or Glob risks
# pulling that mass into context and degrading model performance.
#
# Keep this file calibrated to AGH reality, not a generic template.
# Reviewed alongside CLAUDE.md (see Standing Directives for cadence).
#
# When in doubt, prefer to exclude. Explicit Read on a specific path still
# works for subagents (e.g. cy-researcher Reads files under .resources/<repo>/
# by exact path, which is the intended workflow).

# ─── Build outputs ────────────────────────────────────────────────────────────
bin/
dist/
build/
out/
storybook-static/
*.tsbuildinfo
next-env.d.ts

# Go test/coverage binaries and Go build artifacts that escape /bin
coverage/
coverage.out
coverage.html
*.test
*.prof

# ─── Turbo / framework caches (24 GB!) ────────────────────────────────────────
.turbo/
.tanstack/
.next/
.source/           # Fumadocs generated content
.velite/           # Velite generated content
.vercel/

# ─── Generated code (regenerated by `make codegen`) ───────────────────────────
# DESIGN.md and openapi/agh.json are committed but multi-MB; agents should
# read DESIGN.md via the design skill and OpenAPI via the typed wrappers,
# not by globbing the raw JSON.
openapi/agh.json
openapi/compozy-daemon.json
web/src/generated/
web/src/routeTree.gen.ts
**/__generated__/

# ─── Dependencies and lockfiles ───────────────────────────────────────────────
node_modules/
vendor/
bun.lock
package-lock.json
yarn.lock
go.sum             # large; go.mod is the readable manifest

# ─── Vendored competitor repos (3.6 GB) ───────────────────────────────────────
# The cy-research-competitors / cy-researcher skill Reads specific files
# under .resources/<repo>/ by exact path — explicit Reads still work.
# This block prevents accidental wide-fanout Grep/Glob across all 21 repos.
.resources/

# ─── Local scratch / agent ephemera ───────────────────────────────────────────
.tmp/
ai-docs/
.firecrawl/
.peer-reviews/
.release-notes/
.husky/_/
.DS_Store

# ─── Skeeper sidecar internals (128 MB) ──────────────────────────────────────
# .skeeper.yml at root IS readable (config), the sidecar storage is not.
.skeeper/

# ─── AGH runtime / Compozy artifacts ──────────────────────────────────────────
# Keep PRD/TechSpec/task markdown readable — exclude only the heavy ephemera.
.compozy/runs/
.compozy/extensions/
.compozy/_archived/
.compozy/tasks/_archived/
.compozy/tasks/**/qa/evidence/
.compozy/tasks/**/qa/logs/
.compozy/tasks/**/qa/runs/
.compozy/tasks/**/qa/screenshots/
.compozy/tasks/**/qa/fixtures/
.compozy/tasks/**/qa/runtime-home-manual/
.compozy/tasks/**/qa/agh/
.compozy/tasks/**/qa/bootstrap-manifest.json
.compozy/tasks/**/qa/bootstrap.env
.compozy/tasks/**/qa/peer-review-*
.compozy/tasks/**/qa/peer-review.*
.compozy/tasks/**/qa/*.json
.compozy/tasks/**/qa/*.yaml
.compozy/tasks/**/qa/*.jsonl
.compozy/tasks/**/reviews-*/raw/
.compozy/tasks/**/reviews-*/**/*.log
.compozy/tasks/**/reviews-*/**/*.err
.compozy/tasks/**/reviews-*/peer-review/*.json
.compozy/tasks/**/reviews-*/peer-review/*.patch
.compozy/tasks/**/reviews-*/peer-review/*.txt
.compozy/tasks/**/_codex_*
.compozy/tasks/**/analysis/_codex_*
.compozy/tasks/**/analysis/claude-research-*
.compozy/tasks/**/_evidence/
.compozy/tasks/**/*.md.backup
.compozy/tasks/**/state.yaml

# ─── Codex loop artifacts ─────────────────────────────────────────────────────
.codex/hooks/
.codex/loops/
.codex/loop/
.codex/qa/
.codex/prompts/
.codex/security-reports/
.codex/ledger/
.codex/plans/
.codex/CONTINUITY*

# ─── Per-session agent memory (compaction-scoped, not for global context) ─────
# Active session's own ledger is re-read at every turn by the agent that
# owns it; other sessions' ledgers don't belong in broad searches.
.claude/ledger/
.claude/plans/

# ─── Environment / secrets ────────────────────────────────────────────────────
.env
.env.local
.env.*.local
*.pem
*.key

# ─── OS / editor noise ────────────────────────────────────────────────────────
*.log
*.swp
*.swo
.idea/
__pycache__/
*.py[cod]
*$py.class

# ─── Snapshots and large fixture data ─────────────────────────────────────────
**/__snapshots__/
**/*.snap

# ─── Lock file we DO want readable (override note) ────────────────────────────
# skills-lock.json (45 KB) stays readable — it's the source of truth for
# which skills/plugins this workspace pins.