AGENTS.md: 6th rule — try ccc search before grep for concept queries

The repo is indexed with cocoindex-code; semantic search beats grep for
"where is X / which bundle does Y" questions where you don't know the
exact identifier. Without `--path '**'` ccc scopes to the current
working directory, which is rarely what you want when navigating
ckn-bw — call it out so agents don't get confusing empty results.
This commit is contained in:
CroneKorkN 2026-05-10 21:32:08 +02:00
parent 09d236ded5
commit 852a65a6f6
Signed by: cronekorkn
SSH key fingerprint: SHA256:v0410ZKfuO1QHdgKBsdQNF64xmTxOF8osF1LIqwTcVw

View file

@ -12,7 +12,7 @@ not project documentation. Onboarding lives **here**, in `AGENTS.md`.
## Quickstart for agents
Five rules; follow these and you won't break things:
Six rules; follow these and you won't break things:
1. **Read-only by default.** Never run `bw apply`, `bw run`, or
`bw lock` without explicit user request — even with `-i`. Stick
@ -38,6 +38,12 @@ Five rules; follow these and you won't break things:
5. **Prefer adding helpers to `libs/`** over duplicating logic across
bundles. Repo-wide helpers go in
[`libs/`](libs/AGENTS.md), reachable as `repo.libs.<x>`.
6. **Search semantically.** This repo is indexed with
[`ccc`](https://github.com/cocoindex-io/cocoindex-code) — try
`ccc search '<concept>' --path '**'` before `grep` for
"where is X / which bundle does Y" questions. Without
`--path '**'`, results are filtered to the current working
directory's subtree.
## Layout