git404hub

what is de-complect fr?

danverbraganza/de-complect — explained in plain English

Analysis updated 2026-07-25

3ShellAudience · developerComplexity · 1/5LicenseSetup · easy

tl;dr

An AI agent skill that finds and removes tangled complexity from design docs and code branches, untangling mixed concerns so each stands alone.

vibe map

mindmap
  root((repo))
    What it does
      Untangles design docs
      Simplifies code branches
      Writes simplification memos
    How it works
      One skill file
      Activates on cleanup request
      Preserves original intent
    Install options
      Shell command
      Just tool
      Skill managers
    Use cases
      Design doc review
      Pre-merge code cleanup
      Quality pass
    Audience
      AI coding agents
      Claude Code users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Clean up a design doc before sharing it with your team.

VIBE 2

Run a quality pass on a feature branch before merging.

VIBE 3

Get a memo explaining what was untangled and why.

VIBE 4

Surface correctness bugs separately from complexity removal.

what's the stack?

ShellClaude Code

how it stacks up fr

danverbraganza/de-complectbechsteindigital/claude-shiploophamen/ship-feature
Stars333
LanguageShellShellShell
Setup difficultyeasymoderatemoderate
Complexity1/54/53/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Install with a single shell command that downloads the skill into your Claude skills directory.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

{"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}

prompts (copy fr)

prompt 1
I have a design document that feels tangled. Use the de-complect skill to untangle independent concerns and give me a rewritten version with a simplification memo.
prompt 2
Before I merge this feature branch, run the de-complect skill to make small behavior-preserving cuts that remove tangled complexity from my code.
prompt 3
Review this specification for complection, where are independent concerns woven together? Untangle them and explain what you changed.
prompt 4
Use de-complect to clean up this branch. Remember: moving a check into a helper doesn't count as removing it. Show me what can actually be cut.

Frequently asked questions

what is de-complect fr?

An AI agent skill that finds and removes tangled complexity from design docs and code branches, untangling mixed concerns so each stands alone.

What language is de-complect written in?

Mainly Shell. The stack also includes Shell, Claude Code.

What license does de-complect use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is de-complect to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is de-complect for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.