Add sub agents

Author: jgeudens

.claude/agents/build.md

@@ -0,0 +1,15 @@
+---
+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
+---
+
+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:
+  ninja -C build
+
+Report only errors and warnings. If the build succeeds, say so briefly.

.claude/agents/quality.md

@@ -0,0 +1,17 @@
+---
+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
+---
+
+Run quality checks from the project root.
+
+For a specific file (faster):
+  clang-format -i <file>
+  ./scripts/run_clang_tidy.sh <file>
+  ./scripts/run_clazy.sh <file>
+
+For all files (slow):
+  ./scripts/run_precommit.sh
+
+Report only violations with file, line, and error message. If all checks pass, say so briefly.

.claude/agents/test-runner.md

@@ -0,0 +1,10 @@
+---
+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
+---
+
+Run the test suite from the project root:
+  ctest --test-dir build --output-on-failure
+
+Report only failing tests with their error messages. If all tests pass, say so briefly with the count.

CLAUDE.md

@@ -40,7 +40,7 @@ clang-format -i src/path/to/file.cpp
 
 ```text
 src/
-├── communication/   Modbus protocol layer (ModbusPoll, ModbusMaster, ModbusConnection)
+├── communication/   Communication (using external adapters)
 ├── models/          Data models (SettingsModel, GraphDataModel, DiagnosticModel, Device, Connection)
 ├── datahandling/    Expression parsing, graph data processing
 ├── importexport/    CSV export, MBS project files, MBC device config import
@@ -82,5 +82,10 @@ Enforced by `.clang-format` (Mozilla-based, C++20):
 
 ## Development
 
-- Use a subagent to run the test suite and report only the failing tests with their error messages.
-- Use a subagent to run the quality checks (clang, clazy) and report only the violations with their error messages.
+Three sub-agents are defined in `.claude/agents/` to keep build/test/lint output out of the main context:
+
+- **`@agent-build`** — runs cmake + ninja; reports only errors and warnings.
+- **`@agent-test-runner`** — runs ctest; reports only failing tests with their error messages.
+- **`@agent-quality`** — runs clang-format, clang-tidy, and clazy; reports only violations.
+
+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.