Skip to content

chore: split CLAUDE.md into subdirectory files for cli/ and web/#932

Merged
Aureliolo merged 1 commit intomainfrom
chore/split-claude-md
Mar 30, 2026
Merged

chore: split CLAUDE.md into subdirectory files for cli/ and web/#932
Aureliolo merged 1 commit intomainfrom
chore/split-claude-md

Conversation

@Aureliolo
Copy link
Copy Markdown
Owner

Summary

  • Extract CLI reference (flags, hints, env vars, exit codes, config subcommands, per-command flags, package structure) to cli/CLAUDE.md
  • Extract web dashboard content (commands, package structure, design system component inventory, token rules, TS6/Storybook 10 post-training reference) to web/CLAUDE.md
  • Root CLAUDE.md keeps one-liner pointers to each subdirectory file
  • Result: 40.5k -> 22.7k chars (44% reduction) -- eliminates the "large CLAUDE.md will impact performance" warning
  • Claude Code auto-loads subdirectory CLAUDE.md files when working in those directories, so no information is lost

Test plan

  • Verify root CLAUDE.md no longer triggers the large file warning on next session
  • Verify cli/CLAUDE.md loads when working on CLI code
  • Verify web/CLAUDE.md loads when working on web dashboard code
  • Verify no content was lost -- all sections present in either root or subdirectory files

Review coverage

Quick mode (docs-only changes, no agents needed).

🤖 Generated with Claude Code

Root CLAUDE.md was 40.5k chars, triggering the "large CLAUDE.md" performance
warning. Extracted CLI reference (flags, hints, env vars, exit codes, config,
per-command flags) to cli/CLAUDE.md and web dashboard content (commands, package
structure, design system component inventory, token rules, TS6/Storybook 10
post-training reference) to web/CLAUDE.md. Root keeps one-liner pointers.

Result: 40.5k -> 22.7k chars (44% reduction). Claude Code auto-loads
subdirectory CLAUDE.md files when working in those directories, so no
information is lost.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 30, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: a012ae88-fec4-4538-a7c9-759b34cd2e1d

📥 Commits

Reviewing files that changed from the base of the PR and between 37cb296 and 5673279.

📒 Files selected for processing (3)
  • CLAUDE.md
  • cli/CLAUDE.md
  • web/CLAUDE.md
📜 Recent review details
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (9)
  • GitHub Check: Socket Security: Project Report
  • GitHub Check: Dashboard Test
  • GitHub Check: Build Web
  • GitHub Check: Build Backend
  • GitHub Check: Build Sandbox
  • GitHub Check: CLI Test (macos-latest)
  • GitHub Check: CLI Test (windows-latest)
  • GitHub Check: Dependency Review
  • GitHub Check: Analyze (python)
🧰 Additional context used
🧠 Learnings (37)
📓 Common learnings
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to cli/cmd/**/*.go : Per-command flags are documented in the CLAUDE.md guidelines section. Each command has its own set of flags (e.g., init, start, stop, status, logs, update, cleanup, backup, wipe, doctor, version, uninstall).
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to cli/cmd/**/*.go : Per-command flags are documented in the CLAUDE.md guidelines section. Each command has its own set of flags (e.g., init, start, stop, status, logs, update, cleanup, backup, wipe, doctor, version, uninstall).

Applied to files:

  • cli/CLAUDE.md
  • CLAUDE.md
📚 Learning: 2026-03-15T18:17:43.675Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-15T18:17:43.675Z
Learning: Applies to cli/** : CLI: Go 1.26+, dependencies in cli/go.mod (Cobra, charmbracelet/huh).

Applied to files:

  • cli/CLAUDE.md
  • CLAUDE.md
📚 Learning: 2026-03-15T21:32:02.880Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-15T21:32:02.880Z
Learning: Applies to .github/workflows/cli.yml : CLI workflow: Go lint (golangci-lint + go vet) + test (-race -coverprofile) + build (cross-compile: linux/darwin/windows × amd64/arm64) + govulncheck + fuzz testing (main-only, 30s/target, continue-on-error, matrix over 4 packages). cli-pass gate includes fuzz as informational. GoReleaser release on v* tags. Cosign keyless signing of checksums.txt. SLSA L3 provenance attestations. Sigstore bundle (.sigstore.json) attached. Post-release appends checksums/verification/provenance to draft release notes.

Applied to files:

  • cli/CLAUDE.md
📚 Learning: 2026-03-15T21:32:02.880Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-15T21:32:02.880Z
Learning: Applies to cli/**/*.go : Go CLI (Go 1.26+) uses Cobra for commands, charmbracelet/huh for interactive CLI, charmbracelet/lipgloss for styled output. Cross-platform builds (linux/darwin/windows × amd64/arm64). GoReleaser for releases with cosign keyless signing of checksums.txt. SLSA L3 provenance attestations via actions/attest-build-provenance.

Applied to files:

  • cli/CLAUDE.md
  • CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to cli/go.mod : CLI: Go 1.26+, dependencies in `cli/go.mod` (Cobra, charmbracelet/huh, charmbracelet/lipgloss, sigstore-go, go-containerregistry, go-tuf).

Applied to files:

  • cli/CLAUDE.md
📚 Learning: 2026-03-15T21:32:02.880Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-15T21:32:02.880Z
Learning: Applies to cli/go.mod : Go CLI dependencies: Go 1.26+, Cobra (commands), charmbracelet/huh (interactive CLI), charmbracelet/lipgloss (styled output).

Applied to files:

  • cli/CLAUDE.md
📚 Learning: 2026-03-21T14:12:17.848Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-21T14:12:17.848Z
Learning: Applies to cli/go.mod : CLI uses Go 1.26+. Dependencies: Cobra, charmbracelet/huh, charmbracelet/lipgloss, sigstore-go, go-containerregistry, go-tuf

Applied to files:

  • cli/CLAUDE.md
📚 Learning: 2026-03-21T12:54:22.557Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-21T12:54:22.557Z
Learning: Go 1.26+ required; CLI dependencies in `cli/go.mod` (Cobra, charmbracelet/huh, charmbracelet/lipgloss, sigstore-go, go-containerregistry, go-tuf)

Applied to files:

  • cli/CLAUDE.md
📚 Learning: 2026-03-21T14:12:17.848Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-21T14:12:17.848Z
Learning: CLI workflow (`cli.yml`): Go lint/test/build (cross-compile) + govulncheck + fuzz. GoReleaser release on `v*` tags with cosign signing + SLSA provenance

Applied to files:

  • cli/CLAUDE.md
  • CLAUDE.md
📚 Learning: 2026-03-16T19:52:03.656Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-16T19:52:03.656Z
Learning: Applies to cli/**/*.go : Lint CLI Go code with golangci-lint and go vet; test with go test -race; check vulnerabilities with govulncheck

Applied to files:

  • cli/CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to cli/cmd/**/*.go : All CLI commands accept persistent flags with precedence: flag > env var > config > default. Global flags: `--data-dir`, `--skip-verify`, `--quiet`, `--verbose`, `--no-color`, `--plain`, `--json`, `--yes`, `--help-all`.

Applied to files:

  • cli/CLAUDE.md
  • CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to cli/cmd/config*.go : Config subcommands: `show`, `get <key>`, `set <key> <value>`, `unset <key>`, `list`, `path`, `edit`. Settable keys: auto_apply_compose, auto_cleanup, auto_pull, auto_restart, auto_start_after_wipe, auto_update_cli, backend_port, channel, color, docker_sock, hints, image_tag, log_level, output, sandbox, timestamps, web_port.

Applied to files:

  • cli/CLAUDE.md
  • CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.468Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.468Z
Learning: Build CLI with `go -C cli build -o synthorg ./main.go`. Run tests with `go -C cli test ./...`. Lint with `go -C cli tool golangci-lint run`.

Applied to files:

  • cli/CLAUDE.md
  • CLAUDE.md
📚 Learning: 2026-03-15T20:45:14.430Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-15T20:45:14.430Z
Learning: Shell commands: for Go CLI work, cd cli is an exception because Go tooling requires working directory to be the module root. Go commands require `cd cli` for other work, never use `cd`.

Applied to files:

  • cli/CLAUDE.md
  • CLAUDE.md
📚 Learning: 2026-03-21T12:54:22.557Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-21T12:54:22.557Z
Learning: Applies to cli/**/*.go : Use Cobra for CLI command structure, charmbracelet/huh for interactive prompts, and charmbracelet/lipgloss for terminal styling

Applied to files:

  • cli/CLAUDE.md
  • CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to cli/internal/config/**/*.go : Config-driven overrides: `color never` implies `--no-color`, `color always` forces color on non-TTYs, `output json` implies `--json`, `hints` mode is config-only (always/auto/never).

Applied to files:

  • cli/CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/package.json : Web dashboard: Node.js 22+, TypeScript 6.0+, dependencies in `web/package.json`. Major packages: React 19, react-router, shadcn/ui, Radix UI, Tailwind CSS 4, Zustand, tanstack/react-query, CodeMirror 6, Storybook 10, MSW, Vitest, Playwright, ESLint.

Applied to files:

  • CLAUDE.md
  • web/CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to .github/CHANGELOG.md : Changelog: `.github/CHANGELOG.md` (auto-generated, do not edit).

Applied to files:

  • CLAUDE.md
📚 Learning: 2026-03-19T07:12:14.508Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-19T07:12:14.508Z
Learning: Applies to src/synthorg/**/*.py : Package structure: src/synthorg/ organized as: api/ (REST+WebSocket, Litestar), auth/ (auth subpackage), backup/ (scheduled/manual backups), budget/ (cost tracking, CFO), cli/ (superseded by Go CLI), communication/ (message bus, meetings), config/ (YAML loading), core/ (domain models, resilience config), engine/ (orchestration, task state, coordination, approval gates, stagnation detection, context budget, compaction), hr/ (hiring, performance, promotion), memory/ (pluggable backend, Mem0, retrieval, consolidation), persistence/ (operational data, SQLite, settings), observability/ (logging, correlation, sinks), providers/ (LLM abstraction, LiteLLM, auth types, presets, runtime CRUD), settings/ (runtime-editable, typed definitions, encryption, config bridge), security/ (SecOps, rule engine, output scanning, progressive trust, autonomy levels), templates/ (company templates, personalities), tools/ (registry, built-in tools, git, sandbox, code_runner, MCP...

Applied to files:

  • CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/src/**/*.{ts,tsx} : ALWAYS reuse existing components from `web/src/components/ui/` before creating new ones. These are the shared building blocks.

Applied to files:

  • CLAUDE.md
  • web/CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/src/**/*.{ts,tsx} : A PostToolUse hook (`scripts/check_web_design_system.py`) runs automatically on every Edit/Write to `web/src/` files. It catches hardcoded hex colors, hardcoded font-family, new components without Storybook stories, duplicate patterns, and complex `.map()` blocks. Fix all violations before proceeding.

Applied to files:

  • CLAUDE.md
  • web/CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/src/**/*.{ts,tsx} : Do NOT recreate status dots inline -- use `<StatusBadge>`. Do NOT build card-with-header layouts from scratch -- use `<SectionCard>`. Do NOT create metric displays with inline styling -- use `<MetricCard>`.

Applied to files:

  • CLAUDE.md
  • web/CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/src/components/ui/**/*.{ts,tsx} : New components must use design tokens exclusively -- no hardcoded colors, fonts, or spacing. Import `cn` from `@/lib/utils` for conditional class merging.

Applied to files:

  • CLAUDE.md
  • web/CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/src/components/ui/**/*.{ts,tsx} : When a new shared component is needed: place it in `web/src/components/ui/` with a `.stories.tsx` file alongside it with all states (default, hover, loading, error, empty). Export props as a TypeScript interface.

Applied to files:

  • CLAUDE.md
  • web/CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/src/**/*.{ts,tsx} : Use Tailwind semantic classes (`text-foreground`, `bg-card`, `text-accent`, `text-success`, `bg-danger`, etc.) or CSS variables (`var(--so-accent)`). NEVER hardcode hex values in `.tsx`/`.ts` files.

Applied to files:

  • CLAUDE.md
  • web/CLAUDE.md
📚 Learning: 2026-03-15T21:20:09.993Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-15T21:20:09.993Z
Learning: Applies to web/src/components/** : Vue components organized by feature (agents/, approvals/, budget/, common/, dashboard/, layout/, messages/, org-chart/, tasks/).

Applied to files:

  • CLAUDE.md
📚 Learning: 2026-03-15T18:17:43.675Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-15T18:17:43.675Z
Learning: Applies to web/** : Web dashboard: Node.js 20+, dependencies in web/package.json (Vue 3, PrimeVue, Tailwind CSS, Pinia, VueFlow, ECharts, Axios, vue-draggable-plus, Vitest, fast-check, ESLint, vue-tsc).

Applied to files:

  • CLAUDE.md
  • web/CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/src/**/*.{ts,tsx} : Use density-aware tokens (`p-card`, `gap-section-gap`, `gap-grid-gap`) or standard Tailwind spacing. NEVER hardcode pixel values for layout spacing.

Applied to files:

  • CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/src/**/*.stories.{ts,tsx} : Storybook 10: ESM-only, no CJS support. Packages removed: `storybook/addon-essentials`, `storybook/addon-interactions`, `storybook/test`, `storybook/blocks`. Use `storybook/test` (not `storybook/test`), `storybook/actions` (not `storybook/addon-actions`).

Applied to files:

  • CLAUDE.md
  • web/CLAUDE.md
📚 Learning: 2026-03-14T15:43:05.601Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-14T15:43:05.601Z
Learning: Applies to web/package.json : Web dashboard Node.js 20+; dependencies in web/package.json (Vue 3, PrimeVue, Tailwind CSS, Pinia, VueFlow, ECharts, Axios, vue-draggable-plus, Vitest, ESLint, vue-tsc)

Applied to files:

  • CLAUDE.md
  • web/CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/.storybook/main.ts : Storybook 10: Use `defineMain` from `storybook/react-vite/node` and `definePreview` from `storybook/react-vite` (must still include explicit `framework` field). Type-safe config.

Applied to files:

  • CLAUDE.md
  • web/CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/tsconfig.json : TypeScript 6.0: `types` defaults to `[]` and no longer auto-discovers `types/*`; must explicitly list needed types. `DOM.Iterable` merged into `DOM` -- use `"lib": ["ES2025", "DOM"]`.

Applied to files:

  • CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/tsconfig.json : TypeScript 6.0: `moduleResolution: "classic"` and `"node10"` removed -- use `"bundler"` or `"nodenext"`. `strict` defaults to `true`. `noUncheckedSideEffectImports` defaults to `true`.

Applied to files:

  • CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Applies to web/src/**/*.stories.{ts,tsx} : Storybook 10: Backgrounds API changed -- use `parameters.backgrounds.options` (object keyed by name) + `initialGlobals.backgrounds.value`.

Applied to files:

  • CLAUDE.md
  • web/CLAUDE.md
📚 Learning: 2026-03-30T14:15:14.467Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-30T14:15:14.467Z
Learning: Run web dashboard unit tests with `npm --prefix web run test` (Vitest, coverage scoped to files changed vs origin/main). Run e2e tests with `npm --prefix web run e2e`. Update Playwright baselines with `npm --prefix web run e2e:update`.

Applied to files:

  • CLAUDE.md
📚 Learning: 2026-03-14T15:43:05.601Z
Learnt from: CR
Repo: Aureliolo/synthorg PR: 0
File: CLAUDE.md:0-0
Timestamp: 2026-03-14T15:43:05.601Z
Learning: Applies to docs/** : Docs source in docs/ (Markdown, built with Zensical); design spec in docs/design/ (7 pages: index, agents, organization, communication, engine, memory, operations)

Applied to files:

  • web/CLAUDE.md
🔇 Additional comments (4)
cli/CLAUDE.md (1)

7-113: Documentation split looks correct and complete for CLI reference.

The extracted command/reference sections are clear and consistent with the CLI guidance. No blocking issues found.

web/CLAUDE.md (2)

39-117: Design-system extraction is clear and actionable.

The mandatory reuse/token/enforcement sections are well-structured and preserve key guardrails after the split.


139-139: The import paths in Line 139 are correct per official Storybook 10 documentation. No action needed.

The scoped package names (@storybook/react-vite/node and @storybook/react-vite) match the official Storybook API reference and are the canonical paths for defineMain and definePreview in Storybook 10 with React + Vite.

			> Likely an incorrect or invalid review comment.
CLAUDE.md (1)

49-53: Root-level pointers are concise and consistent with the split-doc approach.

These updates keep root guidance lightweight while preserving discoverability of CLI/Web details.

Also applies to: 107-108, 114-117


Walkthrough

The pull request consolidates documentation by moving detailed CLI and Web Dashboard information from the main CLAUDE.md file into two new specialized documentation files: cli/CLAUDE.md and web/CLAUDE.md. The main CLAUDE.md file is updated to replace extensive command references, design system specifications, and technical reference sections with condensed pointers to the new files. The new cli/CLAUDE.md file documents CLI building, testing, package structure, global flags, environment variables, exit codes, and per-command flags. The new web/CLAUDE.md file documents the web dashboard's frontend stack, development scripts, package structure, and design system requirements including component reuse guidance and automated enforcement via a PostToolUse hook. Net changes total +255 lines and -232 lines in the main file.

Suggested labels

autorelease: tagged

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely summarizes the main change: splitting CLAUDE.md into subdirectory files for cli/ and web/.
Description check ✅ Passed The description is directly related to the changeset, providing a clear summary of extracted content, the reduction in file size, and testing plans.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request refactors the project's documentation by moving detailed instructions and reference material for the CLI and Web Dashboard from the root CLAUDE.md into dedicated CLAUDE.md files within their respective directories. This change improves the organization of the documentation and reduces the size of the main entry point. I have no feedback to provide.

@github-actions
Copy link
Copy Markdown
Contributor

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Snapshot Warnings

⚠️: No snapshots were found for the head SHA 5673279.
Ensure that dependencies are being submitted on PR branches. Re-running this action after a short time may resolve the issue. See the documentation for more information and troubleshooting advice.

Scanned Files

None

@Aureliolo Aureliolo merged commit f5cfe07 into main Mar 30, 2026
44 checks passed
@Aureliolo Aureliolo deleted the chore/split-claude-md branch March 30, 2026 16:35
Aureliolo added a commit that referenced this pull request Mar 31, 2026
🤖 I have created a release *beep* *boop*
---


##
[0.5.2](v0.5.1...v0.5.2)
(2026-03-31)


### Features

* harden activity feed API
([#838](#838),
[#839](#839),
[#840](#840))
([#937](#937))
([c0234ad](c0234ad))
* provider usage metrics, model capabilities, and active health probing
([#935](#935))
([1434c9c](1434c9c))
* runtime sink configuration via SettingsService
([#934](#934))
([16c3f23](16c3f23))
* Settings page comprehensive redesign
([#936](#936))
([#939](#939))
([6d9ac8b](6d9ac8b))


### Maintenance

* bump astro from 6.1.1 to 6.1.2 in /site in the all group
([#940](#940))
([ffa24f0](ffa24f0))
* bump pygments from 2.19.2 to 2.20.0
([#931](#931))
([9993088](9993088))
* bump the all group with 2 updates
([#942](#942))
([aea37f8](aea37f8))
* bump typescript-eslint from 8.57.2 to 8.58.0 in /web in the all group
([#941](#941))
([24f024c](24f024c))
* split CLAUDE.md into subdirectory files for cli/ and web/
([#932](#932))
([f5cfe07](f5cfe07))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
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