Docs: Fix stale claims in CLAUDE.md and remove duplicated text

Offen
#1,663 0 Kommentare 0 Reaktionen 1 zugewiesene Person Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

@huang195 arbeitet bereits daran.

Seit 05.11.2026.

  • #1664 von @huang195 — offen

Bewertung

Dieses Issue wurde noch nicht bewertet.

Beschreibung

CLAUDE.md is 130 KB, about 49k tokens. Claude Code sends it on every request in this repo, and it is in every cache rebuild. On the maintainer's own traffic it is about 13% of Opus spend.

An audit against main (af397ebb) found three problems:

  1. About 25 claims are no longer true. Examples:
    • go vet "gates only 7 of 11 modules". All 11 are vetted.
    • The podman build examples fail without GO_BUILD_TAGS.
    • ROUTES_CONFIG_PATH is not read by any code.
    • Route hosts use filepath.Match. They use gobwas/glob.
    • The Catalog pane opens with P. It opens with C.
    • The hot-reload exclusion list is incomplete.
  2. About 35 KB repeats docs/. The session API section repeats docs/session-api.md. The mTLS sections repeat docs/framework-architecture.md §8a.
  3. About 10 KB is history only: past measurements and bug narratives that give an agent no rule.

Fix: correct the false claims. Move the session API details that only CLAUDE.md has into docs/session-api.md. Then remove the duplicates and the history. Target: about 37% smaller, with no facts lost.

Vorherrschende Sprache
Go
Sterne
23
Forks
44
Ø Merge
16 Std. 32 Min.
Gemergte PRs (30 T.)
227

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus rossoctl/cortex

Alle Issues in rossoctl/cortex

Ähnliche Issues

Weitere Issues zu Go

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.