Skip to content

chore: Refactors Claude files - #29

Merged
wcislom merged 1 commit into
mainfrom
chore/cleanup
Oct 31, 2026
Merged

wcislom merged 1 commit into
mainfrom
chore/cleanup

Conversation

@wcislom

@wcislom wcislom commented Oct 31, 2026

Copy link
Copy Markdown
Owner

Why

docs/architecture.md is imported into CLAUDE.md, so every Claude Code session loads it in full. /usage flagged it
at ~5k tokens per request. Most of that was the repository tree and the ADR summary table, which a task rarely needs.

What

  • The repository layout moves to docs/repository-layout.md. It is not imported;
    CLAUDE.md says when to open it.
  • The ADR summaries move to docs/adr/README.md, which replaces the Title column with Decision.
  • architecture.md keeps the containers, dependency rules, service registration, key flow and limitations.
    No normative text changed, only where it lives.

@wcislom
wcislom merged commit 0869336 into main Oct 31, 2026
3 checks passed
@wcislom
wcislom deleted the chore/cleanup branch October 31, 2026 11:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant