Dev Tasks

Common development maintenance tasks and tools: cleaning up code annotations, diagnosing problems, fixing security vulnerabilities, setting up development environments, and starting dev servers safely. Each sub-file is a self-contained procedure.

Topics

• Address FIXMEs: Find and resolve FIXME, TODO, and REFACTOR comments in specified files, prioritized by severity. Use when the user wants to clean up code annotations.
• Dev Serve: Start a dev server on a safe port with worktree-aware ownership, automatic port allocation, and race-condition handling. Use when starting a dev server or hitting "port already in use" / EADDRINUSE errors.
• Diagnose Root Cause: Hypothesis-driven debugging that identifies the root cause without applying fixes. Use when the user wants to understand why something is broken. (Moved to dev-methods.)
• macOS Source Code Volume: Create a case-sensitive APFS volume at /Volumes/src for source code. Use when setting up a macOS development environment.

See also

• LLM Environment Tools: CLI tools that improve AI agent effectiveness for development tasks.
• Fix npm Vulnerabilities: Minimal, controlled fixes for npm audit vulnerabilities. (Moved to the nodejs skill.)