Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions .claude/agents/build.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@ name: build
description: Compile the project using cmake and ninja. Use when code changes need to be built or when checking for compilation errors.
tools: Bash
model: Haiku
effort: low
---

Build the project from the project root.

If the build directory doesn't exist yet, run:
mkdir -p build && cmake -GNinja -S . -B build

Then always run:
Run:
mkdir -p build
cmake -GNinja -S . -B build
ninja -C build

Report only errors and warnings. If the build succeeds, say so briefly.
1 change: 1 addition & 0 deletions .claude/agents/quality.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ name: quality
description: Run pre-commit quality checks (clang-format, clang-tidy, clazy) on source files. Use after making code changes before finishing a task.
tools: Bash
model: Haiku
effort: low
---

Run quality checks from the project root.
Expand Down
1 change: 1 addition & 0 deletions .claude/agents/test-runner.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ name: test-runner
description: Run the test suite with ctest. Use after making code changes to verify correctness. The project must be built first.
tools: Bash
model: Haiku
effort: low
---

Run the test suite from the project root:
Expand Down
6 changes: 3 additions & 3 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@

## Build

> **Preferred workflow:** use the sub-agents (`@agent-build`, `@agent-test-runner`, `@agent-quality`) defined in `.claude/agents/` — see the [Development](#development) section. The commands below are provided as reference and fallback only.

All commands run from the **project root** unless noted.

**Requirements:** Qt 6, C++20, Ninja. Compiler flags: `-Wall -Wextra -Werror`.
Expand Down Expand Up @@ -34,8 +36,6 @@ clang-format -i src/path/to/file.cpp
./scripts/run_clazy.sh src/path/to/file.cpp
```

**Always run pre-commit after making source file changes.** All three checks must pass before the work is done.

## Project Structure

```text
Expand Down Expand Up @@ -89,4 +89,4 @@ Several sub-agents are defined in `.claude/agents/` to keep build/test/lint outp
- **`@agent-quality`** - runs clang-format, clang-tidy, and clazy; reports only violations.
- **`@agent-code-reviewer`** - reviews code for quality, safety, and best practices; provides specific, actionable feedback.

Always use these agents rather than running the commands directly. After making source file changes: build, then run tests, then run quality checks - all must pass before the work is done.
Always use these agents rather than running the commands directly. After making source file changes: build, then run tests, then run quality checks, then run code review - all required steps must pass before the work is done.