Skip to content

feat: split Claude Code project instructions into memory / rules / skills#459

Closed
akison1129 wants to merge 2 commits into
TraderAlice:masterfrom
akison1129:feat/claude-config-split
Closed

feat: split Claude Code project instructions into memory / rules / skills#459
akison1129 wants to merge 2 commits into
TraderAlice:masterfrom
akison1129:feat/claude-config-split

Conversation

@akison1129

Copy link
Copy Markdown

Summary

  • Split the large OpenAlice CLAUDE.md (~10k tokens always-loaded) into concise
    project memory (CLAUDE.md, ~3.3k), path-scoped rules (.claude/rules/:
    git-workflow always-on, uta/ui lazy-loaded), and task skills
    (.claude/skills/: uta-test-scenarios, openalice-session-start, openalice-demo-mode)
  • Add shared .claude/rules/ tracking (.gitignore: !.claude/rules/) so rules
    ship to cloud sessions like skills already do
  • Restore/align docs/uta-live-testing.md as the canonical UTA scenario source
    (S1–S14); the skill is its operational digest
  • Merge includes latest master; conflict resolution re-split against the current
    upstream CLAUDE.md (external-PR quarantine-and-scan policy, contributors
    section, bootstrap.mjs/dugite notes, data/+workspaces root model all preserved)

Validation

  • /context shows reduced always-loaded memory (project CLAUDE.md ~10k → 3.3k + 0.9k rule)
  • UTA path-scoped rule loads only for services/uta/** (canary: verbatim heading quoted)
  • Non-UTA session does not load the UTA rule (canary negative confirmed)
  • git status --short clean

Notes

  • No application source code changed (docs / Claude Code configuration only)
  • No pnpm install, build, or test run — not applicable to this change

🤖 Generated with Claude Code

akison1129 and others added 2 commits July 5, 2026 03:13
Restructure the 31.9KB CLAUDE.md (~10k tokens always-on) into a 3-tier
layout (~3.1k tokens always-on):

- CLAUDE.md: overview, quick start, pre-commit scopes, structure map,
  key architecture, conventions (2.6k tokens)
- .claude/rules/: git-workflow (always), uta + ui (path-scoped lazy)
- .claude/skills/: uta-test-scenarios, openalice-session-start,
  openalice-demo-mode (loaded on invocation)

Also:
- .gitignore: un-ignore .claude/rules/ so rules ship to cloud sessions
- docs/uta-live-testing.md: restore S1-S14 catalog (recovered from a
  stray sandbox clone; was referenced by CLAUDE.md but missing here)

Path-scoped rule loading verified both directions via canary test.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Conflict resolution: CLAUDE.md re-split against the latest upstream
version (318 commits, TraderAlice#324 -> f6fb7fb). Upstream additions relocated
into the 3-tier layout:

- CLAUDE.md: cross-platform bootstrap.mjs/dugite section, portable
  data/ + global workspaces/ root model, logging convention fix
  (pino unused), templates list (finance-research removed)
- .claude/rules/git-workflow.md: external-PR policy updated from
  REFUSE to quarantine-and-scan; Recognizing-contributors section
  added (IP-clean rule: no Co-Authored-By for humans)

Verified: heading-level reconciliation of all upstream content,
path-scoped rule lazy-loading both directions, /context clean.
@vercel

vercel Bot commented Jul 5, 2026

Copy link
Copy Markdown

@akison1129 is attempting to deploy a commit to the luokerenx4's Team Team on Vercel.

A member of the Team first needs to authorize it.

@luokerenx4

Copy link
Copy Markdown
Contributor

Dear we dont accept the edits on dev workflow. You remind me to simplify the agents.md now so thanks for your help. We close the PR for recent attach from anoy github account. BUT I love your contribution. Happy to see you in our Discord or other community like QQ. : )

@luokerenx4 luokerenx4 closed this Jul 8, 2026
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