From 852a65a6f6f1d3e517405fe761e3d67c923267cc Mon Sep 17 00:00:00 2001 From: CroneKorkN Date: Sun, 10 May 2026 21:32:08 +0200 Subject: [PATCH] =?UTF-8?q?AGENTS.md:=206th=20rule=20=E2=80=94=20try=20`cc?= =?UTF-8?q?c=20search`=20before=20`grep`=20for=20concept=20queries?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- AGENTS.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 659a31e..4e6052b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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.`. +6. **Search semantically.** This repo is indexed with + [`ccc`](https://github.com/cocoindex-io/cocoindex-code) — try + `ccc search '' --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