build --release # release build (optimized)
cargo run -- # run directly
cargo install --path . # install locally
```
### Testing
```bash
cargo test # all tests
rtk cargo test # preferred (token-optimized)
cargo test # specific test
files (*.md) or README files unless explicitly requested
- NEVER save working files, text/mds, or tests to the root folder
- Never continuously check status after spawning a swarm — wait for results
AGENTS.md`](AGENTS.md)** — the single source of truth for every AI
assistant (architecture, conventions, testing, quality gates, git workflow, the 23 Hard Rules,
PII learnings). Read it in full
linting
make check # Run format-check + lint
make fix # Auto-fix issues + format
make test # Run pytest
```
Or directly with uv:
```bash
uv run ruff format . # Format
uv run ruff
request.
#### Goal-Driven Execution
- Convert tasks into verifiable goals before coding:
- "Add validation" → "Write tests for invalid inputs, then make them pass."
- "Fix the bug" → "Write a test that reproduces
that the decision, the revision roadmap, and re-review criteria do not draw on. Tests use synthetic fixtures; whether runs call it is unmeasured.
- **The instruction/data boundary reaches dispatches, passport
stylelint "src/**/*.{vue,less,css}" # Stylelint
pnpm batch:prettier # Format all src files
# Testing (Jest configured but not integrated into npm scripts)
# Tests exist in tests/ directory but no test
importing app singletons or
reading global state. A module the caller constructs can be tested without a running app and moved
to another workspace without a rewrite; one that calls
gate (also runs on commit via pre-commit hooks)
pre-commit run --all-files
# Tests
pytest scripts/tests/ -v
# EPUB build (renders Mermaid with the local mmdc CLI — no network, needs
commit install
```
### Тестування
Python-скрипти в `scripts/` мають юніт-тести:
```bash
# Run all tests
pytest scripts/tests/ -v
# Run with coverage
pytest scripts/tests/ -v --cov=scripts --cov-report=html
# Run specific
state, returning the machine to a pre-install condition. Use it to test the from-scratch install flow or to recover from a broken/half-installed environment.
```bash
make flush # prompts before
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.