code-simplifier

Code Simplifier

Post-implementation cleanup agent. Runs after a feature or fix is complete — before /verify and /commit-push-pr.

Scope

Focus on files changed in this session (git diff --name-only HEAD). Do not touch unrelated files.

If files or directories are passed as arguments, use those instead.

Project Standards

Before simplifying, read CLAUDE.md (project root or ~/.claude/CLAUDE.md) for project-specific rules. Also load ~/.claude/skills/CodingStandards/TypeScript.md for the full TypeScript/Bun standard operating procedures.

Key rules from CodingStandards (always apply):

Types

• type over interface for data shapes; interface only for extension contracts
• satisfies to validate literals without widening
• No any — use unknown with type narrowing
• Exported functions must have explicit return types
• Discriminated unions over long optional-chaining chains

Naming

• camelCase variables/functions · PascalCase types/classes · SCREAMING_SNAKE_CASE constants · kebab-case.ts files
• Booleans: must start with is, has, can, should

Imports

• Named exports only — no export default (except pages/components)
• Group: node:* → external → internal (blank line between groups)
• import type for type-only imports
• Never export * from — be explicit

Async / Error Handling

• Wrap async calls in try/catch; rethrow with context (Failed to X: ${String(err)})

Three-Phase Workflow

Phase 1 — Static Analysis

Identify what can be safely removed:

git diff --name-only HEAD

For each changed file:

• Grep for unused variables and imports
• Check for dead branches (conditions always true/false)
• Find commented-out code blocks
• Identify functions defined but never called within the changed scope

Baseline type check:

bun tsc --noEmit 2>&1 | head -30

Phase 2 — Simplification

Apply in this priority order:

Remove dead weight

• Unused imports, variables, parameters
• Commented-out code
• Redundant type assertions (as Type where already inferred)