Skip to content

nghyane/luma / .agents/skills/cross-platform

cross-platform

Verified

Guidelines for writing platform-specific code in Luma. Use when adding or modifying code that behaves differently on Unix vs Windows, including shell commands, file paths, process spawning, or platform-specific tests.

Cross-Platform Code in Luma

Compile-time selection

Prefer compile-time platform selection over runtime branching:

// Preferred
#[cfg(unix)]
fn shell_command() -> &'static str { "sh" }

#[cfg(windows)]
fn shell_command() -> &'static str { "cmd" }

// Avoid
fn shell_command() -> &'static str {
    if cfg!(windows) { "cmd" } else { "sh" }
}

Use #[cfg(unix)], #[cfg(windows)], or module-level #[cfg(...)] attributes.

Module layout

Platform-specific code lives in separate files:

src/tool/shell/
  mod.rs        ← public API, platform-agnostic
  unix.rs       ← #[cfg(unix)]
  windows.rs    ← #[cfg(windows)]

The parent module exposes a single unified API. Callers never import platform modules directly.

Tests

Guard platform-specific tests at compile time:

#[cfg(test)]
mod tests {
    #[cfg(unix)]
    #[test]
    fn unix_specific_behavior() { ... }

    #[cfg(windows)]
    #[test]
    fn windows_specific_behavior() { ... }
}

Do not duplicate test logic when expectations can be shared across platforms.

finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 319kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 319kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 319kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall