mikecubed

clean-code-codex

Core orchestrator for Clean Code Codex enforcement. Auto-invoked when writing, reviewing, refactoring, or testing code in TypeScript, Python, Go, Rust, or JavaScript. Dispatches to targeted check sub-skills based on detected language and operation type. Ensures modular, tested, maintainable output. Do NOT invoke for documentation-only edits, configuration files (JSON/YAML/TOML), or non-code content.

mikecubed 0 Updated 2mo ago

Resources

21
GitHub

Install

npx skillscat add mikecubed/clean-code-codex

Install via the SkillsCat registry.

SKILL.md

Clean Code Codex

A composable, multi-language, TDD-first clean code enforcement system for AI agents.
Merges the best of church/, clean-code-skills/, and claude-code-maestro/clean-code
while adding first-class TDD enforcement and extending language coverage to five languages.

Sub-skills

Skill Loads when Language refs
skills/conductor/SKILL.md Always No
skills/tdd-check/SKILL.md write, refactor, test Yes (5 languages)
skills/arch-check/SKILL.md review, refactor No
skills/type-check/SKILL.md review, write Yes (5 languages)
skills/naming-check/SKILL.md review, refactor Yes (5 languages)
skills/size-check/SKILL.md review, refactor No
skills/dead-check/SKILL.md review, refactor No
skills/test-check/SKILL.md review, test No
skills/sec-check/SKILL.md security, incident, new service No
skills/dep-check/SKILL.md review No
skills/obs-check/SKILL.md review No

Installation

Copy clean-code-codex/ to your project root or add the skills to your agent's skill path.
The conductor is the sole entry point; all other skills are loaded on demand.

Usage

The conductor auto-activates on any code write/review/refactor/test operation.
See README.md for full usage, CLI arguments, and waiver format.