Skip to content

Refactor CLAUDE.md documentation - #118

Merged
MJohnson459 merged 3 commits into
mainfrom
claude/compassionate-brown-1te8gl
Sep 29, 2026
Merged

MJohnson459 merged 3 commits into
mainfrom
claude/compassionate-brown-1te8gl

Conversation

@MJohnson459

Copy link
Copy Markdown
Contributor

Summary

Streamlined and reorganized the CLAUDE.md project conventions file to improve clarity and maintainability.

Key Changes

  • Consolidated and refined command documentation for pixi tasks
  • Reorganized sections for better logical flow
  • Removed redundant or outdated guidance
  • Improved formatting and readability of the conventions guide

Notes

This is a documentation-only change that does not affect any source code, build artifacts, or runtime behavior. The file remains the authoritative reference for Claude Code interactions with this repository.

https://claude.ai/code/session_011Ly1jZnCmZq3aaa2iKM9Zz

Keeps the commands, the load-bearing rules and the silent-failure traps;
moves rationale, measurements and milestone history behind pointers to
docs/fleet, docs/design, docs/tuning and the package READMEs, which
already hold them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011Ly1jZnCmZq3aaa2iKM9Zz
A change touching only markdown, docs/, design/ or LICENSE cannot alter
what builds or what the tests see; docs.yml still checks the prose.
mote_bringup/wifi/README.md is re-included because test_wifi_roaming.py
reads it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011Ly1jZnCmZq3aaa2iKM9Zz
#120 added a 330-word 'Fleet: loading a promoted map' section to the old
file. Its narrative already lives in docs/fleet/README.md §11; the rules
it carried become bullets under Map registry. The 'next bringup' line
and the DDS total (~27) are corrected, and a short 'Editing this file'
rule says what belongs here so the next feature adds bullets, not a
section.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011Ly1jZnCmZq3aaa2iKM9Zz
@MJohnson459
MJohnson459 merged commit 8e717fb into main Sep 29, 2026
5 checks passed
@MJohnson459
MJohnson459 deleted the claude/compassionate-brown-1te8gl branch September 29, 2026 21:00
MJohnson459 pushed a commit that referenced this pull request Sep 29, 2026
#118 replaced CLAUDE.md with a rules-and-pointers file. This branch's two
edits to the old file become bullets in the new one: the conformance test
needs jsonschema (dev env) and no longer carries a strict xfail, and #616
is settled, leaving #629 as the one open disagreement with zone/v0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011Ly1jZnCmZq3aaa2iKM9Zz
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.

2 participants