docs: add CLAUDE.md — onboarding for future Claude Code sessions #31

altair823 · 2026-05-02T04:43:26Z

altair823 commented

2026-05-02 04:43:26 +00:00

요약

/init skill 으로 CLAUDE.md 생성. 코드베이스 작업 시 알아야 할 것들 — build/test/clippy 명령, facade 규칙, spec contract 위치, allowed/forbidden deps, versioning cascade, wire schema, post-merge HOTFIXES 패턴, 스모크 테스팅, 명명/경로, Gitea remote.

포함 안 한 것

README.md 가 이미 다루는 항목 (high-level 설명, 의존성 그래프, phase 로드맵, 디렉토리 트리) 은 link 만 하고 반복 안 함. 보편적 dev practice ("write tests for new features", "don't commit secrets" 등) 도 제외.

핵심 entry

-j 1 for cargo test --workspace — 18 integration test binary 가 lance + datafusion link 시 RAM 부족으로 SIGKILL. per-crate 는 parallel OK.
facade 규칙 — UI 는 kebab-app::*_with_config(cfg, …) 통해서만 Config 를 thread. bare form 은 XDG default 재로드해서 --config 무시. P3-5 / P4-3 두 regression 이 같은 패턴 (HOTFIXES.md).
frozen task spec + live HOTFIXES — 머지된 task spec 은 frozen historical contract. 라이브 deviation 은 HOTFIXES.md.
wire schema v1 — --json 출력의 schema_version 은 외부 통합 contract.
versioning cascade — parser/chunker/embedding/prompt/index version 변경은 §9 cascade rule.

검증

새 파일 1 개. 빌드/테스트 영향 없음.
길이 79 줄.

🤖 Generated with Claude Code

## 요약 `/init` skill 으로 CLAUDE.md 생성. 코드베이스 작업 시 알아야 할 것들 — build/test/clippy 명령, facade 규칙, spec contract 위치, allowed/forbidden deps, versioning cascade, wire schema, post-merge HOTFIXES 패턴, 스모크 테스팅, 명명/경로, Gitea remote. ## 포함 안 한 것 README.md 가 이미 다루는 항목 (high-level 설명, 의존성 그래프, phase 로드맵, 디렉토리 트리) 은 link 만 하고 반복 안 함. 보편적 dev practice ("write tests for new features", "don't commit secrets" 등) 도 제외. ## 핵심 entry - **`-j 1` for `cargo test --workspace`** — 18 integration test binary 가 lance + datafusion link 시 RAM 부족으로 SIGKILL. per-crate 는 parallel OK. - **facade 규칙** — UI 는 `kebab-app::*_with_config(cfg, …)` 통해서만 Config 를 thread. bare form 은 XDG default 재로드해서 `--config` 무시. P3-5 / P4-3 두 regression 이 같은 패턴 (HOTFIXES.md). - **frozen task spec + live HOTFIXES** — 머지된 task spec 은 frozen historical contract. 라이브 deviation 은 HOTFIXES.md. - **wire schema v1** — `--json` 출력의 `schema_version` 은 외부 통합 contract. - **versioning cascade** — parser/chunker/embedding/prompt/index version 변경은 §9 cascade rule. ## 검증 - 새 파일 1 개. 빌드/테스트 영향 없음. - 길이 79 줄. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

altair823 added 1 commit 2026-05-02 04:43:26 +00:00

docs: add CLAUDE.md — onboarding for future Claude Code sessions 37102c3013

Codebase-specific guidance only (build/test/clippy commands, the
facade rule, spec contract location, allowed/forbidden deps,
versioning cascade, wire schema, post-merge HOTFIXES pattern,
smoke testing, naming/paths, Gitea remote). Defers to README.md
for the high-level overview, dependency graph, phase roadmap,
and directory tree rather than restating them.

Generated by `/init` skill against the current main (post-rename).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

altair823 merged commit 643f97211d into main

2026-05-02 04:49:54 +00:00

altair823 deleted branch docs/init-claude-md

2026-05-02 04:49:55 +00:00

altair823 referenced this issue from a commit

2026-05-02 04:49:55 +00:00

Merge pull request 'docs: add CLAUDE.md — onboarding for future Claude Code sessions' (#31) from docs/init-claude-md into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: altair823-org/kebab#31