test file
uv run --group test pytest tests/unit_tests/test_specific.py
```
```bash
# Lint code
make lint
# Format code
make format
# Type checking
uv run --group lint mypy .
```
#### Key config files
- pyproject.toml: Main workspace
changed files and report findings directly, the way `/create-skill` reviews a skill, without invoking `$review-code` or any other skill. Review skills carry user-input gates that `codex exec` drops
written implementation plan
├── finishing-a-development-branch/ # Decide how to land completed work
├── receiving-code-review/ # Handle review feedback
├── requesting-code-review/ # Verify completed work before merging
├── subagent-driven-development
surface in tests or manual QA of the tab itself. Any AI review pass (Gemini Code Assist, `/create-pr` self-review, `/review-pr`) MUST flag a diff that adds/changes a tab `fragment
service entry points. This file (`CLAUDE.md`) is primarily guidance for AI coding agents (Claude Code, etc.), but a few sections are worth a human contributor's time:
>
> - **[Architecture Decisions](docs/architecture-decisions.md
machine-readable `checks:` block (hardcoded-path scan) in CI; and Claude Code's managed GitHub-App reviewer reads `REVIEW.md` directly. Adding or editing a lesson is a PR to `REVIEW.md
migration without documenting the security impact.
### Forbidden Phrases in Code
These phrases in comments or commit messages trigger mandatory review:
- "should work now" → must include test evidence
- "trivial change" → must
/improve` for one kind of engineering work. Use `/task-to-pr` to deliver one or more code changes. Use `/codex-issue-coordinator` only in Codex to coordinate a large GitHub issue batch through separate
codex-headless.ps1 "review the current repo and list the highest-risk files"
.\codex-headless.cmd "review the current repo and list the highest-risk files"
```
The wrapper runs `codex exec` from
Visualize architecture when clarity helps
5. **Don't reinvent the wheel** - Before writing new code, I check whether it already exists in the codebase or is solved by a well
spec in the same change.
2. **TDD.** Write the failing test, then the code. The test order documented
in §6 of `SPEC.md` is the implementation order. Don't skip ahead
Primary Role: Interactive Language Tutor
You are a personal language tutor, powered by Claude Code. Your mission is to help learners master their target language through **fun, interactive, systematic learning
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Project
Official MongoDB Kafka Connector — a Kafka Connect plugin that ships both
feature: `git worktree add -b feat/ ../cwm-feat- `
2. **Spawn a new Claude Code session** pointed at the worktree directory
3. **Feed it ALL relevant context** — point it at every file
code via the per-pattern `fix:` field, not via `dependencies:`.
`bin/validate-patterns` does not enforce the rules in this section — they are editorial guidance for authors and reviewers. The validator only
A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.
Where does it go?
At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.
What should it contain?
Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.
CLAUDE.md or AGENTS.md?
Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.