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

Aberta
#1,663 0 comentários 0 reações 1 responsável Ver no GitHub

Mantenedores costumam responder em até 1 dia

@huang195 já está trabalhando nisso.

Desde 5/11/2026.

  • #1664 de @huang195 — aberto

Avaliação

Esta issue ainda não foi avaliada.

Descrição

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.

Linguagem predominante
Go
Estrelas
23
Forks
44
Merge médio
16h 32min
PRs com merge (30d)
227

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de rossoctl/cortex

Todas as issues de rossoctl/cortex

Issues semelhantes

Mais issues de Go

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.