{
  "markdown": "# DinoQuinten's Claude Code plugins\n\nA multi-plugin [Claude Code marketplace](https://docs.claude.com/en/docs/claude-code/plugins). Each plugin ships independently and is versioned on its own cadence.\n\n## Plugins\n\n| Plugin | Version | What it does |\n|---|---|---|\n| [`cleancode`](#cleancode) | `v0.3.2` | 15 plain-language clean-code rules with auto-fix for silent errors, method chains, messy tests, long functions, folder structure, and more |\n| [`sdd`](#sdd-system-and-database-design) *(system-and-database-design)* | `v0.2.0` | Architect and database-design coach grounded in DDIA, *Fundamentals of Software Architecture*, and Kimball's *Data Warehouse Toolkit* — produces design docs, Mermaid / Excalidraw / DBML diagrams, and architecture reviews |\n\n## Install\n\nFrom Claude Code, add the marketplace once:\n\n```\n/plugin marketplace add DinoQuinten/claude-plugins\n```\n\nThen install either (or both) plugins:\n\n```\n/plugin install cleancode@dinoquinten-plugins\n/plugin install sdd@dinoquinten-plugins\n```\n\nFor Codex CLI users, install the downstream rule packs directly in a project:\n\n```\nnpx cleancode-codex init\nnpx sdd-codex init\n```\n\n---\n\n## `cleancode`\n\nA Claude Code plugin that enforces clean code principles across your entire project and **actually fixes the code for you** — not just reports what's wrong. Locks in the same rules for Claude Code, Cursor, and Codex so every AI assistant follows the same standards from the first session onward.\n\n**Plain language first.** Every rule is written so anyone — not just senior engineers — can follow it. The formal textbook name is in parentheses so experts still recognize it: \"Don't Reach Through Objects (Law of Demeter)\", \"Check Inputs Early, Never Hide Errors (Fail Fast)\".\n\nBased on: *Clean Code: A Handbook of Agile Software Craftsmanship* (Robert C. Martin), *Code Complete 2nd Ed.* (McConnell), *The Art of Clean Code* (Mayer), *OOP vs. Functional Programming*.\n\n**15 plain-language rules, 13 skills, 1 background reviewer, and 2 hooks.**\n\n| Skill | Command | What it does |\n|---|---|---|\n| **Init** | `/cleancode:init` | Sets up clean code rules for your project — generates `.cleancode-rules.md`, `CLAUDE.md`, `.cursorrules`, `AGENTS.md` |\n| **Analyze** | `/cleancode:analyze [file]` | Scans code for violations — file length, function length, nesting, naming, missing interfaces |\n| **Rewrite** | `/cleancode:rewrite [file]` | Produces a clean version of messy code, preserving all behavior |\n| **Teach** | `/cleancode:teach [rule]` | Explains any clean code principle with a book citation and example |\n| **Setup Platform** | `/cleancode:setup [cursor\\|codex\\|all]` | Writes platform-native config files from `.cleancode-rules.md` |\n| **Refactor** | `/cleancode:refactor [file] [name]` | Applies one named refactoring (Extract Function, Replace Switch with Table, Guard Clauses, Strategy, …) |\n| **Test** | `/cleancode:test [file] [fix]` | Flags tests missing Arrange / Act / Assert, bad names, multi-assertion bodies; `fix` rewrites them |\n| **Untangle** | `/cleancode:untangle [file] [fix]` | Finds `a.b().c().d()` chains and god-class imports; `fix` introduces helper methods |\n| **Safety** | `/cleancode:safety [file] [fix]` | Finds empty catches, missing guards, division without zero-check; `fix` adds guard clauses and surfaces errors |\n| **Structure** | `/cleancode:structure [file] [fix]` | Suggests Strategy / Command / Factory / State patterns when they'd help; `fix` applies them |\n| **Todo** | `/cleancode:todo [scan\\|add\\|list\\|close]` | Tracks known clean-code issues in `.cleancode-todo.md` at project root |\n| **Health** | `/cleancode:health [save]` | Project-wide dashboard with a Cleanliness Score out of 100 — read only |\n| **Fix** | `/cleancode:fix [file] [critical-only\\|all]` | One-shot: runs analyze, then delegates to each fixer skill in severity order |\n\n**Auto-runs on every project open** — the `SessionStart` hook checks for `.cleancode-rules.md` and prompts to initialize if missing.\n\n**Background reviewer** — the `cleancode-reviewer` agent silently checks all code Claude writes and appends non-blocking suggestions.\n\n**Report or fix, your choice.** Every detection skill defaults to a report. Add `fix` to apply changes. The reviewer agent stays read-only — nothing is ever rewritten without an explicit `/cleancode:*` command.\n\n**Also available for Codex CLI.** The same 15 rules ship as a Codex CLI installer — run `npx cleancode-codex init` in any project to write `AGENTS.md` and `.cleancode-rules.md`. See [`codex/README.md`](./codex/README.md).\n\nFull details, rule list, language support, and troubleshooting live in the plugin's own docs at [tag `cleancode/v0.3.2`](https://github.com/DinoQuinten/claude-plugins/blob/cleancode/v0.3.2/README.md).\n\n---\n\n## `sdd` (system-and-database-design)\n\nInstalled as `sdd@dinoquinten-plugins`; all commands use the `/sdd:` prefix. Folder name and full descriptive title remain `system-and-database-design` — only the plugin namespace is shortened.\n\nA Claude Code plugin that helps you design real-world software architecture and databases. Ships with 39 curated reference chunks distilled from three canonical texts:\n\n- **Designing Data-Intensive Applications** (Kleppmann) — data systems, consistency, replication, partitioning\n- **Fundamentals of Software Architecture** (Richards & Ford) — architecture styles, characteristics, fitness functions\n- **The Data Warehouse Toolkit** (Kimball) — dimensional modeling, star schemas, SCDs\n\n…plus authored chunks covering topics the books don't: API design, observability, security, ML/AI serving, real-time systems, compliance. **You do not need the source books.** Zero setup — no dependencies, no downloads, no build step.\n\n| Skill | Command | What it does |\n|---|---|---|\n| **Design System** | `/sdd:design-system <requirement>` | Full design doc with components, trade-offs, and capacity math |\n| **Design Database** | `/sdd:design-database <domain>` | Schema recommendation (SQL or NoSQL) with ER-style breakdown |\n| **Review Architecture** | `/sdd:review-architecture <path or text>` | Critique via fitness functions and checklists (scale, security, reliability, compliance, anti-patterns) |\n| **Diagram** | `/sdd:diagram <desc> --format=mermaid\\|excalidraw\\|dbml` | Generates diagrams in your tool of choice |\n| **Design Principles** | *(auto-triggered)* | Kicks in when you mention CAP, consistency, sharding, consensus, etc. |\n\nA lightweight `SessionStart` hook announces the plugin at the start of each session.\n\n**Also available for Codex CLI.** The design-principles subset ships as a Codex CLI installer — run `npx sdd-codex init` in any project to write `AGENTS.md` and `.sdd-principles.md`. See [`codex-sdd/README.md`](./codex-sdd/README.md).\n\nFull details in [`system-and-database-design/README.md`](./system-and-database-design/README.md).\n\n---\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n",
  "bytes": 6901,
  "sha": "40f8c2fbb7181f1ba8cd48a1972e17fe7178ad27535e0b562213840677bafbd0",
  "repo_slug": "dinoquinten/cleancode-assistant",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_dinoquinten_cleancode_assistant_clean_co_a3f975bb/readme"
}