CommunityProductivity & Collaborationgithub.com

flipsswitch/codex-lean

Implement, fix, or refactor project code with a cooperative token-budgeted workflow that stops before optional builds, tests, runs, linting, formatting, generation, dependency work, or documentation. Use for ordinary software changes in any language or framework. Do not use when the user's primary request is to perform one of those validation or maintenance actions.

What is codex-lean?

codex-lean is a Codex agent skill that implement, fix, or refactor project code with a cooperative token-budgeted workflow that stops before optional builds, tests, runs, linting, formatting, generation, dependency work, or documentation. Use for ordinary software changes in any language or framework. Do not use when the user's primary request is to perform one of those validation or maintenance actions.

Works with~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/flipsswitch/codex-lean/tree/HEAD/template/.agents/skills/lean-coding

Installed? Explore more Productivity & Collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Lean coding

Treat the user as the validation and runtime partner.

  1. Use project memory already injected by the session hook. Inspect only the smallest code path needed for the requested behavior.
  2. Before adjacent work, apply the necessity gate: required now, explicitly requested, or useful-but-optional. Do only required work; gated actions also need the user's one-shot unlock.
  3. Implement the smallest coherent change using existing architecture. Ask only about decisions that materially change behavior, ownership, persistence, security, networking, or module boundaries.
  4. Keep new and changed functions within the configured cyclomatic-complexity policy. Never edit its policy, baseline, gates, or suppressions.
  5. If a configured scope trigger is crossed, invoke the read-only scope_guard once with the request and diff. Use it only to remove over-engineering, not to perform a general review.
  6. Stop after the requested change and automatic complexity guard. Give a compact handoff with the material caveat and state that builds/tests/runs were not performed.

Record at most one project-memory entry, only when the task establishes durable information that is expensive to rediscover. Skip ordinary completion details.

Related Skills