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

Ouverte
#1,663 0 commentaires 0 réactions 1 personne assignée Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

@huang195 y travaille déjà.

Depuis le 5/11/2026.

  • #1664 par @huang195 — ouverte

Évaluation

Cette issue n'a pas encore été évaluée.

Description

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.

Langage dominant
Go
Étoiles
23
Forks
44
Merge moyen
16 h 32 min
PR mergées (30 j)
227

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de rossoctl/cortex

Toutes les issues de rossoctl/cortex

Issues similaires

Plus d'issues Go

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.