Skip to content

docs: slim CLAUDE.md from 591 to 246 lines (TASK-528 PR 2) - #2716

Closed
lilyshen0722 wants to merge 1 commit into
folio/task-528-claude-md-docsfrom
folio/task-528-claude-md-shrink
Closed

lilyshen0722 wants to merge 1 commit into
folio/task-528-claude-md-docsfrom
folio/task-528-claude-md-shrink

Conversation

@lilyshen0722

Copy link
Copy Markdown
Contributor

Written by folio, a Commonly agent — https://commonly.me/v2/pods/6a692a1be833c668acdb84cf

PR 2 of the TASK-528 CLAUDE.md series. Stacked on #2702 (PR 1, docs-only). Draft, held. CTO takes this diff to Cofounder for Sam's yes before any gate.

What moved (verbatim, byte-identical to the source line ranges)

Source (CLAUDE.md at e0f0028) Destination
Product Vision & Architecture Philosophy (9–113) docs/architecture/product-vision.md
Active Implementation Tracks (138–160) docs/architecture/active-tracks.md
Knowledge-Base Discipline (216–294) docs/development/knowledge-base-discipline.md
Docker (299–313) docs/deployment/docker-dev.md
Kubernetes GKE (315–330) docs/deployment/kubernetes-gke-dev.md
Architecture Overview (439–480) docs/architecture/system-overview.md
Build-arg history (357–369), lint gate state (394–421), Agent Runtime quick rules (493–583) already in PR 1

CLAUDE.md keeps the Design Rules, Quick Start, the dev-command pointers, Testing Strategy, the GitHub identity section, and a one-line-per-rule index of the 37 Agent Runtime quick rules, each pointing at the full text in docs/agents/agent-runtime-quick-rules.md.

Result

  • CLAUDE.md: 591 → 246 lines (target ≤250).
  • Every non-blank moved line is found verbatim in docs/. Every markdown link in the changed files resolves.
  • Not run: no code change, so no test suite. The docs-only check is the grep above.

Review asks

  • Cofounder: the diff, for Sam's yes (the row's gate).
  • Sable: the gate, once the Cofounder approves.

🤖 Generated with Claude Code

PR 2 of the TASK-528 series, stacked on the docs-only PR 1. Each moved
block is byte-identical to its source range; checked with a line-by-line
grep against the docs tree. Nothing reworded, dropped or re-dated.

Moved out of CLAUDE.md:
- Product Vision & Architecture Philosophy (lines 9-113)
  -> docs/architecture/product-vision.md
- Active Implementation Tracks (138-160)
  -> docs/architecture/active-tracks.md
- Knowledge-Base Discipline (216-294)
  -> docs/development/knowledge-base-discipline.md
- Architecture Overview (439-480)
  -> docs/architecture/system-overview.md
- Docker (299-313) -> docs/deployment/docker-dev.md
- Kubernetes GKE (315-330) -> docs/deployment/kubernetes-gke-dev.md
- Build-arg history (357-369) -> docs/deployment/build-arg-history.md (PR 1)
- Lint gate state (394-421) -> docs/development/lint-gate-state.md (PR 1)
- Agent Runtime quick rules (493-583) -> docs/agents/agent-runtime-quick-rules.md (PR 1)

CLAUDE.md keeps the Design Rules, the Quick Start, Development Commands
pointers, the Testing Strategy, the GitHub identity section, and a
one-line-per-rule index of the Agent Runtime quick rules.

This is a draft. CTO takes it to Cofounder for Sam's yes before any gate.

Written by folio, a Commonly agent — https://commonly.me/v2/pods/6a692a1be833c668acdb84cf

Co-Authored-By: Claude Haiku 5.5 <noreply@anthropic.com>
Co-authored-by: folio <WyJmb2xpbyIsImRlZmF1bHQiXQ@agents.commonly.invalid>
Agent-Model: claude/claude-haiku-5-5/high
@coderabbitai

coderabbitai Bot commented Oct 25, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Comment @coderabbitai help to get the list of available commands.

@lilyshen0722

Copy link
Copy Markdown
Contributor Author

Closing as superseded. Main already slimmed CLAUDE.md to 247 lines in ba2e81a (#2953), which covers this PR's goal. This branch also sits on an old base and has no gate.

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