danverbraganza/de-complect

{"i":0,"repo":"danverbraganza/de-complect","stars":3,"lang":"Shell","ok":true,"char_count":1740,"text":"This repository offers a skill for AI coding agents like Claude Code. The skill teaches the agent to find and remove tangled complexity from design documents and code branches. The name comes from the idea of complection, meaning things woven together, and the goal is to untangle independent concerns so each one stands on its own. It draws inspiration from a well-known talk called Simple Made Easy by Rich Hickey, where simple means having one fold rather than just being familiar.\n\nThe skill works on two kinds of targets. The first is a design document, such as a plan or specification. When applied, it produces a rewritten version of the document with a simplification memo explaining the changes. The second target is an implementation branch, examined before merging a feature. Here the skill makes small, behavior-preserving cuts to the code, ensuring that every removed guard or check has something else that still enforces the same rule.\n\nThis is described as a quality pass, not a bug hunt. The skill preserves the original intent of the document and the behavior of the code. If it finds actual correctness bugs, it surfaces them separately rather than fixing them itself. A key principle is that moving a check into a helper function does not count as removing it, since the same tangled logic still exists in a tidier form.\n\nInstallation offers several options. You can run a one-line shell command that downloads the skill into your Claude skills directory. You can also use a tool called just, install it through skill managers like asm or sm, add it as a Claude Code plugin, or simply copy the skill folder manually into your project. Once installed, the skill activates when you ask an agent to simplify, untangle, or clean up a document or branch.\n\nThe repository is small, containing a single skill file that defines the entire process. It is licensed under MIT and welcomes contributions, provided they keep the skill focused on disentangling rather than bug fixing.","error":null}