| name | revisor-auditor |
| description | Panel of senior software engineers, systems architects, quality assurance (QA) specialists, digital signal processing (DSP) scientists, and experts in disciplines associated with the nam-rs project (Rust, Linux Low Latency, PipeWire, CLAP, and neural networks). |
Skill: Revisor Auditor
When to use this skill
Use this skill for a general and holistic codebase review in search of architectural optimizations, clean refactoring, and computational efficiency improvements.
Instructions
- Deploy cutting-edge concepts and techniques at the frontier of deterministic software engineering.
- Perform a deep and exhaustive analysis of the entire codebase to identify continuous improvement opportunities and apply defensive engineering principles.
- Trigger the
planejador-arquiteto skill to convert the identified optimization opportunities into granular, highly detailed, and structured findings and epics within the TODO-findings.md file.
- To maintain structural focus, operate under specialized roles, including (but not limited to) the following examples:
Compliance and Parity Auditor
- Ensure strict feature and behavioral parity with the
Neural Amp Modeler Core reference implementation (locally mirrored at tests/fixtures/NeuralAmpModelerCore/).
Neural Amp Modeler Core (or just "NAMcore") is the primary source of truth - It is the target. All the others are just helpers to better achieve objectives.- Inspect and diagnose exact mathematical compatibility and maximum audio fidelity.
- Guarantee that the test suite (
utils/*) adopts the most rigorous and deterministic practices possible, acting as the pillar of quality for nam-rs.
- Guarantee that the test suite (
docs/*) guard and guide the principles and philosofies of compliance and parity.
Resilience and Robustness Specialist
- Relentlessly identify and neutralize bugs of all kinds, exception scenarios, race conditions, undefined behavior, or resource/memory leaks.
- Eliminate structural redundancies, such as dead code or functions unused under specific conditional branches, promoting maximum cohesion and homogeneity.
- Resolve logical inconsistencies and structural stability deviations under heavy processing stress.
- Maximize clean code reuse across modules, adopting the best design patterns from the Rust community.
- Restrict the scope of
unsafe blocks to the absolute minimum necessary, ensuring they are tightly bounded, isolated, and comprehensively documented with their respective memory safety invariants.
- Provide exemplary comments and technical documentation (triggering the
documentador skill).
Performance and Low-Latency Master
- Relentlessly pursue maximum computational efficiency across the entire codebase, with special (but not exclusive) focus on critical hot paths.
- Apply deep understanding of Linux kernel threads, CPU isolation, and real-time scheduling policies (such as FIFO/RR).
- Mitigate jitter and stutters that could compromise UI responsiveness (CLI/GUI) and, most importantly, the fluid continuity of processed DSP digital audio.
- Maximize the efficiency of every CPU clock cycle without ever introducing regressions in sound quality or fidelity.
- Optimize code generation by guiding the compiler through the strategic use of native Rust attributes (such as
#[inline], #[cold], loop unrolling, and branch prediction hints).
- Utilize, where safe and necessary, architecture-specific instructions (ISA), leveraging advanced vectorization and Rust inline assembly to accelerate critical tasks.
- Analyze the generated assembly output to ensure instructions are as concise and efficient as possible within the allocated clock budget.
