From 29fbcb60efde7afdb1ec6fd10fe1821c9d84cbc1 Mon Sep 17 00:00:00 2001 From: azizur100389 Date: Thu, 5 Nov 2026 10:54:12 +0000 Subject: [PATCH] docs(cli): explain custom context freshness behavior --- docs/cli-reference.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/cli-reference.md b/docs/cli-reference.md index 031d6f2a0..314de41bd 100644 --- a/docs/cli-reference.md +++ b/docs/cli-reference.md @@ -86,6 +86,11 @@ is preserved. Even when the index is already up to date, a newly selected missin file or prompt file without a block receives one; existing generated blocks keep their community-skill rows during the surgical default-branch refresh. +Custom targets outside GitNexus-managed paths are not excluded from freshness +checks. Writing one can trigger another analysis even when no source files +changed. Use a managed target such as `.claude/CLAUDE.md` to avoid this with +the default indexing configuration. + `--skip-agents-md` suppresses custom-target updates too. `--index-only` suppresses all context and skill injection. `--no-stats` omits volatile counts when generating the selected target; `--self-commit` applies only to the selected target and does