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

Abierto
#1,663 0 comentarios 0 reacciones 1 asignado Ver en GitHub

Los mantenedores suelen responder en 1 día

@huang195 ya está trabajando en esto.

Desde el 5/11/2026.

  • #1664 de @huang195 — abierto

Evaluación

Este issue todavía no se ha evaluado.

Descripción

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.

Lenguaje dominante
Go
Estrellas
23
Forks
44
Merge medio
16 h 32 min
PR fusionados (30 d)
227

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de rossoctl/cortex

Todos los issues de rossoctl/cortex

Issues similares

Más issues de Go

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.