---

name: forge-lang-c description: C development standards including make, gcc/clang, valgrind, and cppcheck. Use when working with C files, Makefiles, or CMakeLists.txt.

C Development

Building

Copy# With Make
make

# With CMake
mkdir -p build && cd build
cmake ..
make

# Direct compilation
gcc -Wall -Wextra -Werror -o program main.c

Testing

Copy# With Makefile test target
make test

# With CTest (CMake)
cd build && ctest -V

# With Unity or other test frameworks
./run_tests

Static Analysis

Copy# Cppcheck
cppcheck --enable=all --error-exitcode=1 src/

# Clang static analyzer
scan-build make

# GCC warnings as errors
gcc -Wall -Wextra -Werror -pedantic -std=c11

Memory Checking

Copy# Valgrind memory check
valgrind --leak-check=full ./program

# AddressSanitizer (compile with)
gcc -fsanitize=address -g -o program main.c

Formatting

Copy# Format with clang-format
clang-format -i src/*.c src/*.h

# Check without changing
clang-format --dry-run --Werror src/*.c src/*.h

Project Structure

Copyproject/
├── src/
│   ├── main.c
│   └── module.c
├── include/
│   └── module.h
├── tests/
│   └── test_module.c
├── Makefile (or CMakeLists.txt)
└── README.md

Makefile Template

CopyCC = gcc
CFLAGS = -Wall -Wextra -Werror -std=c11 -pedantic
LDFLAGS =
SRC = src/main.c src/module.c
OBJ = $(SRC:.c=.o)
TARGET = program

all: $(TARGET)

$(TARGET): $(OBJ)
	$(CC) $(LDFLAGS) -o $@ $^

%.o: %.c
	$(CC) $(CFLAGS) -c -o $@ $<

test: $(TARGET)
	./run_tests

clean:
	rm -f $(OBJ) $(TARGET)

.PHONY: all test clean

TDD Cycle Commands

Copy# RED: Write test, run to see it fail
make test

# GREEN: Implement, run to see it pass
make test

# REFACTOR: Clean up, ensure tests still pass
make clean && make && make test && cppcheck --enable=all src/