Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 8 additions & 28 deletions .claude/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,34 +4,14 @@ When the user types `/graphify`, use the installed graphify skill or instruction

# Index trust protocol

Guidance for using the Repowise/graphify indexes below. **This section is
repo-owned and lives ABOVE the `REPOWISE:START` marker on purpose.** An
earlier version of it sat inside the auto-generated block, and `repowise init`
silently dropped it when Repowise 0.45.0 regenerated that block with a leaner
template — 52 lines deleted, no warning, no diff anyone was watching. Anything
inside those markers belongs to the generator and can vanish on any re-index;
guidance we depend on has to live out here. Do not move it back down.

- **`verified: true` means the bytes were checked against the live tree.**
Never follow it with a Read of the same lines.
- **`symbol_bodies`, `quotes`, and `code_rationale` entries are live source.**
Use them instead of opening the file.
- **The only re-read triggers** are `bounds: "approximate"`,
`_meta.stale_warning`, `search_method: "bm25"`, and `confidence: "low"`.
`index_behind: true` alone is informational — the served content is
unaffected by the drift.
- **Not valid reasons to re-read:** "just to be safe"; "to see full context"
(use the skeleton or a range read); "the file might have changed"
(`verified` already checked). These are the failure mode this section
exists to name — each one converts a served, verified answer back into a
full-file Read and spends the context the index was there to save.
- **Pre-edit, not instead-of-edit.** These tools decide *which* files to read
and edit. Claude Code requires a raw Read of any file you will Edit, and
that Read is correct and expected.
- **For exhaustive literal sweeps** (rename every call site) plain `Grep` is
unbeatable — use it. Reach for `get_context(include=["callers"])` when you
want the `callers_total` / `callers_truncated` honesty signal instead of a
maybe-incomplete grep.
Guidance for the Repowise/graphify indexes below. **Repo-owned, lives ABOVE the `REPOWISE:START` marker on purpose** — content inside those markers belongs to the generator and can vanish on any re-index. Do not move it back down.

- **`verified: true`** means the bytes were checked against the live tree — never re-Read those lines.
- **`symbol_bodies`, `quotes`, `code_rationale`** are live source — use them instead of opening the file.
- **Re-read only on:** `bounds: "approximate"`, `_meta.stale_warning`, `search_method: "bm25"`, or `confidence: "low"`. `index_behind: true` alone is informational.
- **Not valid reasons to re-read:** "just to be safe", "to see full context" (use the skeleton or a range read), "the file might have changed" (`verified` already checked).
- **Pre-edit, not instead-of-edit.** These tools decide *which* files to read/edit; a raw Read before any Edit is still required.
- **For exhaustive literal sweeps** (rename every call site), plain `Grep` is unbeatable. Use `get_context(include=["callers"])` when you want the `callers_total`/`callers_truncated` honesty signal instead of a maybe-incomplete grep.

<!-- REPOWISE:START — Do not edit below this line. Auto-generated by Repowise. -->
## Codebase Intelligence for agentic-dev-team (Repowise)
Expand Down
176 changes: 72 additions & 104 deletions CLAUDE.md

Large diffs are not rendered by default.

Loading
Loading