Zig Project Architecture

Zig Project Architecture

Core Principles

• No hidden behavior — No hidden allocations, no hidden control flow, no macros
• Explicit allocators — Pass allocator as parameter, never use global allocator
• Comptime over macros — Use comptime for generics and metaprogramming
• Error unions — Use !T for explicit error handling, avoid anyerror
• defer/errdefer — Resource cleanup at scope exit
• No backwards compatibility — Delete, don't deprecate. Change directly
• LiteLLM for LLM APIs — Use LiteLLM proxy for all LLM integrations

No Backwards Compatibility

Delete unused code. Change directly. No compatibility layers.

// ❌ BAD: Deprecated function kept around
/// Deprecated: Use newFunction instead
pub fn oldFunction() void {
    @compileLog("oldFunction is deprecated");
    newFunction();
}

// ❌ BAD: Alias for renamed functions
pub const old_name = new_name; // "for backwards compatibility"

// ❌ BAD: Unused parameters
fn process(_: *const Config, data: []const u8) !void {
    _ = data;
}

// ✅ GOOD: Just delete and update all usages
pub fn newFunction() void {
    // ...
}

// ✅ GOOD: Remove unused parameters entirely