dotfiles/claude/CLAUDE.md
mwiegand c3edb9a12c
feat: add global Claude Code instructions
Tracks ~/.claude/CLAUDE.md in the repo under claude/CLAUDE.md.
The original is replaced by a symlink back to this file.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-11 22:32:14 +02:00

29 lines
1.3 KiB
Markdown

# Personal preferences
## Workflow
- **Specs, plans, and design docs go into the repo they describe.** When
brainstorming, plan-mode, or any flow produces a persistent document
(design spec, implementation plan, ADR, etc.), the final destination is
always the working tree of the project it belongs to — typically
under `docs/` (or wherever the project conventionally keeps them).
Scratch locations like `~/.claude/plans/<slug>.md` are fine *during*
plan mode, but the moment plan mode exits with an approved artifact,
copy it into the repo and `git commit` it. Don't ship a feature
while its spec or plan still lives only in a scratch file. If a
project's `AGENTS.md` / `CLAUDE.md` specifies a different directory,
that wins.
## Tooling
- **`ccc` for semantic code search.** Repos containing a
`.cocoindex_code/` directory are indexed by
[`ccc`](https://github.com/cocoindex-io/cocoindex-code). Reach for
it on conceptual questions ("where is X used / which files do Y /
what handles Z"), where a keyword grep would miss indirect usage:
`ccc search '<concept>' --path '**'`. Pass `--path '**'` — without
it, results are filtered to the current working directory's
subtree. The `ccc` skill has the full reference;
`grep`/`rg`/`find` remain fine for exact-string lookups.
@RTK.md