GitHub - danverbraganza/de-complect: Removes "complections" which weave together unnecessary aspects of the code · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
danverbraganza
de-complect
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>3 Commits<br>3 Commits
.claude-plugin
.claude-plugin
.claude
.claude
skills/de-complect
skills/de-complect
.gitignore
.gitignore
LICENSE
LICENSE
README.md
README.md
install.sh
install.sh
justfile
justfile
View all files
Repository files navigation
de-complect Agent Skill
An Agent Skill that helps AI coding agents remove braided complexity from design documents and<br>implementation branches — the way Rich Hickey's Simple Made Easy means simple: one fold,<br>un-braided, not "familiar" or "fewer files."
Overview
This repository provides an Agent Skill for Claude Code and other compatible AI agents. It teaches<br>the agent to find where independent concerns are twisted together — defensive checks, sentinels,<br>tri-state configs, scattered validation, speculative abstraction, stored-but-derivable state — and<br>cut those braids so each concern hangs straight down.
It runs on two kinds of target:
A design document (plan, ADR, spec, handoff doc) — the deliverable is a disentangled rewrite<br>to a sibling .simplified.md, led by a simplification memo.
An implementation branch — after a feature lands, before merge — the deliverable is a series<br>of small, behavior-preserving cuts, each with a named surviving enforcer for every invariant it<br>removes.
This is a quality pass, not a bug hunt. It preserves the document's intent and scope, and<br>preserves code behavior; genuine correctness bugs are surfaced separately, never fixed here.
Installation
One-line install (curl | bash)
curl -fsSL https://raw.githubusercontent.com/danverbraganza/de-complect/main/install.sh | bash
This downloads the skill into ~/.claude/skills/de-complect/. Override the destination with<br>CLAUDE_SKILLS_DIR.
With just
just install
With a skill manager (agent-skills-manager / asm / sm)
The skill follows the standard skills//SKILL.md layout, so skill managers discover it<br>straight from the repo:
# asm (github.com/luongnv89/asm)<br>asm install github:danverbraganza/de-complect -p claude
# sm (pypi.org/project/agent-skill-manager)<br>sm install https://github.com/danverbraganza/de-complect -a claude-code
For the agent-skills-manager dashboard, open Install → From Git and paste<br>https://github.com/danverbraganza/de-complect, then pick de-complect.
As a Claude Code plugin
The repo doubles as its own single-plugin marketplace. From inside Claude Code:
/plugin marketplace add danverbraganza/de-complect<br>/plugin install de-complect@de-complect-marketplace
Then reload (/reload-plugins) and invoke the skill with /de-complect:de-complect.
Manually
Copy the skill directory into your skills directory — either global:
cp -r skills/de-complect/ ~/.claude/skills/de-complect/
or into a single project:
cp -r skills/de-complect/ /path/to/your/project/.claude/skills/de-complect/
Usage
Once installed, the skill activates when you ask an agent to "simplify", "de-complect", "untangle",<br>"remove cruft", "make erroneous states unrepresentable", or "clean up" a design doc or a branch —<br>or when a diff is thick with defensive checks, sentinels, and stored-but-derivable state.
Skill Contents
skills/<br>└── de-complect/<br>└── SKILL.md # The de-complect pass: radar, razors, process, and self-check gates
Key ideas
Simple ≠ easy — simple is one fold (objective); easy is near-at-hand (relative). Every<br>"simpler" claim is interrogated: does it reduce interleaving, or only familiarity and keystrokes?
Judge the artifact, not the construct — evaluate each braid by its cost to reasoning, change,<br>and debugging, not by whether it looks like a familiar shape.
No named survivor → not redundant → restore it — every removed guard must name what now<br>enforces its invariant.
Relocation is not removal — a check moved into a helper still called...