Trillek Engine C++ Development

Expert development assistant for Trillek Engine C, a modern C++20 game engine with physics, networking, scripting, and rendering capabilities.

What This Skill Does

This skill guides AI agents through development on the Trillek Engine C project, ensuring strict adherence to the project's build requirements, coding standards, and documentation policies as defined in `AGENTS.md`.

Instructions

CRITICAL: Read AGENTS.md First

**Before ANY work**, you MUST:

1. **Read `AGENTS.md` completely** - This is the single source of truth containing:

- Mandatory environment setup steps

- Execution protocol and workflow

- Documentation policy (what NOT to create)

- Build verification requirements

- Coding standards

- All project constraints and guidelines

2. **Never skip this step** - `AGENTS.md` contains critical information that overrides general assumptions

Environment Setup

Before building, verify these prerequisites are installed:

#### System Dependencies (Linux)

```bash

sudo apt-get install -y build-essential pkg-config tar curl zip unzip gdb \

libgl1-mesa-dev xorg-dev libglu1-mesa-dev libxinerama-dev \

libxcursor-dev p7zip-full

```

#### Required Tools

#### Documentation Tools (if building docs)

Build Commands

Use CMake presets for consistent configuration:

#### Configure Project

```bash

cmake --preset=ninja-multi-vcpkg

```

#### Build Commands

```bash

Debug build

cmake --build --preset=ninja-multi-vcpkg-debug

Release build

cmake --build --preset=ninja-multi-vcpkg-release

Release with debug info

cmake --build --preset=ninja-multi-vcpkg-release-dbginfo

```

#### Testing

```bash

Enable tests during configuration

cmake --preset=ninja-multi-vcpkg -DBUILD_TESTS=ON

Run tests (debug)

ctest --preset=ninja-multi-vcpkg-debug

Run tests (release)

ctest --preset=ninja-multi-vcpkg-release

```

#### Documentation

```bash

cmake --build --preset=ninja-multi-docs

```

Project Configuration Options

Technology Stack

Development Workflow

1. **Always check `AGENTS.md`** before starting work

2. **Verify prerequisites** are installed

3. **Configure with presets** - Use `ninja-multi-vcpkg` config preset

4. **Build incrementally** - Use appropriate debug/release build preset

5. **Run tests** if making logic changes

6. **Follow coding standards** as defined in `AGENTS.md`

7. **Never create documentation** unless explicitly instructed (see AGENTS.md for policy)

Important Constraints

Common Tasks

#### Adding a New Source File

1. Read `AGENTS.md` for file organization standards

2. Add `.hpp` to appropriate include directory

3. Add `.cpp` to appropriate source directory

4. Update relevant `CMakeLists.txt`

5. Rebuild with appropriate preset

#### Debugging Build Issues

1. Verify `VCPKG_ROOT` is set correctly

2. Check vcpkg dependencies are installed

3. Ensure CMake version >= 3.20

4. Try clean reconfigure: delete `build/` and `out/` directories

5. Check `AGENTS.md` for project-specific constraints

#### Working with Dependencies

Rule of Thumb

**If you're unsure about anything, check `AGENTS.md` first.** It is the authoritative source for all project rules, workflows, and standards.

Examples

Example 1: Starting Development

```

User: I want to add a new physics feature

Agent: Before I begin, let me read AGENTS.md to understand the project

structure and coding standards...

[reads AGENTS.md]

I see the physics system is in src/physics/. Based on AGENTS.md

section X, I should follow pattern Y. Let me verify the build works

first:

cmake --preset=ninja-multi-vcpkg

cmake --build --preset=ninja-multi-vcpkg-debug

```

Example 2: Troubleshooting Build

```

User: Build is failing with vcpkg errors

Agent: Let me check the prerequisites from AGENTS.md:

1. Is VCPKG_ROOT environment variable set?

2. Did vcpkg bootstrap complete successfully?

3. Are system dependencies installed?

[diagnoses issue based on AGENTS.md checklist]

```

Example 3: Adding Tests

```

User: Add tests for the new collision detection

Agent: According to AGENTS.md testing guidelines, I'll:

1. Create test file in tests/ directory

2. Reconfigure with BUILD_TESTS=ON:

cmake --preset=ninja-multi-vcpkg -DBUILD_TESTS=ON

3. Build and run tests:

cmake --build --preset=ninja-multi-vcpkg-debug

ctest --preset=ninja-multi-vcpkg-debug

```

Important Notes