What the developer wrote
Authored by Marko Bencun
AGENTS: run make commands serially
Otherwise the dev-machine can easily lock up.
What changed, and why it matters
This commit only updates developer documentation (AGENTS.md). It adds a warning that running multiple make commands in parallel can lock up a development machine, and instructs developers to run them one at a time. There is no code change and no security relevance.
No security action needed. Treat as a normal documentation/process improvement.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The diff adds three lines to AGENTS.md advising against make -j without a job count and against running multiple top-level make targets concurrently. It is purely a documentation/process note for developers to avoid local build-system resource exhaustion. No firmware, bootloader, factory-setup, or tooling code is modified.
Changed components
Inspect captured patch +7 / −0
diff --git a/AGENTS.md b/AGENTS.md
index bfec916..7c5e5a5 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -54,6 +54,13 @@ an explicit shell as the command, e.g. `./scripts/dev_exec.sh bash -lc 'cat vers
- If you modify `messages/*.proto`, run `make generate-protobufs` before direct Rust `cargo`
commands. Plain `cargo test`/`cargo check` does not regenerate the protobuf outputs.
+You may use `make -j$(nproc)` to speed up compilation. Do not use `make -j` without specfiying the
+number of processing units.
+
+Never run multiple `make` commands in parallel. For example, instead of
+`make -j$(nproc) firmware bootloader factory-setup`, run them one after the other: `make -j$(nproc) firmware; make -j$(nproc) bootloader; make -j$(nproc) factory-setup`.
+
+
## Coding Style & Naming Conventions
`.clang-format` (Chromium base, 4-space indent, Linux braces) and `.clang-tidy` govern C/C++. Use
`snake_case` for symbols, `PascalCase` for types, and `ALL_CAPS` for macros. Python utilities follow
Why this scored 15/100
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.