Name: template-simple-c
Author: mgreenly

Imported from mgreenly/template-simple-c (AGENTS.md). Install upstream with npx skills add mgreenly/template-simple-c. Copyright stays with the author.

This project is spec managed. Direct source code changes are not allowed without direct user instruction. Agents should never start the build loop this is strictly a human gated operation.

This project requires squash merges to main.

Toolchain

gcc 14, clang-format 19, clang-tidy 19, cppcheck 2.17, valgrind 3.24, lcov 2.0, GNU make 4.4.

Layout

src/ holds all our code. A package is a subdirectory, created only when large enough.
Headers sit beside their .c. Includes are quoted and relative to the including file. No -I.
src/<name>_test.c is the unit test for src/<name>.c, beside it. Every product file except main.c has one.
vendor/<name>/ holds third-party code, included with angle brackets via -isystem, built with relaxed flags.
System libraries come through pkg-config or -l, scoped to the targets that need them.

Rules

One build, -O2 -g, no debug mode. make release strips symbols into bin/hello.debug.
NDEBUG is never defined. Asserts are always live, so they must be cheap and side-effect free.
Magic numbers are named. Buffer sizes are enum constants.
No suppression comments of any kind. A finding that cannot be fixed is filed as an issue.

Test files

src/**/*_test.c

Gates

Run in this order. Each must exit 0. Silent on success.

make check-tools
make check-fmt
make check-build
make check-test
make check-analyze
make check-cppcheck
make check-tidy
make check-sanitize
make check-valgrind
make check-coverage

make check runs all of them and stops at the first failure. make help lists every target.

Commit conventions

<imperative summary, <=50 chars>

<optional: one or two lines on what changed and why>

Requirements: R-XXXX-XXXX, R-YYYY-YYYY

{ "ocm": "1", "id": "mgreenly-template-simple-c-template-simple-c", "kind": "skill", "name": "template-simple-c", "description": "This project is spec managed. Direct source code changes are not allowed without direct user instruction. Agents should never start the build loop this is strictly a human gated operation.", "publisher": "mgreenly", "version": "1.0.0", "capabilities": { "domains": [ "coding" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "This project is spec managed. Direct source code changes are not allowed without direct user instruction. Agents should never start the build loop this is strictly a human gated operation." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/mgreenly/template-simple-c", "path": "AGENTS.md", "ref": "7fe6a4ddf614d708b3a45379a971547ca1684560", "url": "https://github.com/mgreenly/template-simple-c/blob/7fe6a4ddf614d708b3a45379a971547ca1684560/AGENTS.md", "key": "mgreenly/template-simple-c/AGENTS.md" } }, "instructions": "This project is spec managed. Direct source code changes are not allowed\nwithout direct user instruction. Agents should never start the build loop\nthis is strictly a human gated operation.\n\nThis project requires squash merges to main.\n\n## Toolchain\n\ngcc 14, clang-format 19, clang-tidy 19, cppcheck 2.17, valgrind 3.24, lcov 2.0, GNU make 4.4.\n\n## Layout\n\n- `src/` holds all our code. A package is a subdirectory, created only when large enough.\n- Headers sit beside their `.c`. Includes are quoted and relative to the including file. No `-I`.\n- `src/<name>_test.c` is the unit test for `src/<name>.", "cost": { "context_tokens": 440 } }

template-simple-c

About

Toolchain

Layout

Rules

Test files

Gates

Commit conventions

Use it

Manifest

Reviews