Skip to content

CLAUDE.md: Restructure as lean index with @imports#51

Merged
AntonioCS merged 2 commits intomainfrom
chore/restructure-claude-md
Feb 8, 2026
Merged

CLAUDE.md: Restructure as lean index with @imports#51
AntonioCS merged 2 commits intomainfrom
chore/restructure-claude-md

Conversation

@AntonioCS
Copy link
Copy Markdown
Owner

Summary

  • Restructure CLAUDE.md from 435 lines to 67 lines (85% reduction)
  • Move architecture reference to docs/architecture.md (loaded via @ import)
  • Code conventions already covered by /makebind skill - remove duplication
  • Fix stale content in both CLAUDE.md and SKILL.md

Changes

  • CLAUDE.md: Lean index with key commands, main.mk flags summary, contributor workflow
  • docs/architecture.md: NEW - core structure, module loading, loading order, complete module list, full assertion function list
  • SKILL.md: Fix stale test framework reference, add missing module categories
  • .gitignore: Granular docs ignoring instead of blanket docs

Stale content fixed

  • tests/make_testing.mktest_runner.mk + asserts.mk
  • Missing databases/, infrastructure/ module categories added
  • Assertion functions: 3 → 10 (complete list)
  • Makefile.tpl.mk location corrected (templates/, not root)
  • Missing core/util/git.mk added

Test plan

  • No Make code changed - documentation only
  • Verify @docs/architecture.md import works in fresh Claude session
  • Verify /makebind skill covers all removed code convention content

Trello: https://trello.com/c/Y3cez4LU

🤖 Generated with Claude Code

Reduce from 435 to 67 lines by separating concerns:
- Architecture details moved to docs/architecture.md
- Code conventions already covered by /makebind skill
- CLAUDE.md keeps: overview, commands, contributor workflow

Also fixes stale content in SKILL.md and architecture.md:
- tests/make_testing.mk -> test_runner.mk + asserts.mk
- Add missing databases/, infrastructure/ module categories
- Complete assertion function list (3 -> 10)
- Fix Makefile.tpl.mk location (templates/, not root)
- Add missing core/util/git.mk
@AntonioCS AntonioCS merged commit 6ba06c8 into main Feb 8, 2026
1 check passed
@AntonioCS AntonioCS deleted the chore/restructure-claude-md branch February 8, 2026 09:23
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