softaworks/agent-toolkit / skills/reducing-entropy
reducing-entropy
VerifiedManual-only skill for minimizing total codebase size. Only activate when explicitly requested by user. Measures success by final code amount, not effort. Bias toward deletion.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 4.7 KB |
| SKILL.md | skill md | 2.5 KB |
| adding-reference-mindsets.md | markdown | 3.3 KB |
| references/data-over-abstractions.md | markdown | 1.8 KB |
| references/design-is-taking-apart.md | markdown | 2.2 KB |
| references/expensive-to-add-later.md | markdown | 2.4 KB |
| references/simplicity-vs-easy.md | markdown | 1.7 KB |
references/data-over-abstractions.md
View on GitHub---
description: 100 functions on one data structure beats 10 functions on 10 structures. Generic data and operations enable composition.
---
# Data-Oriented Design
## The Core Principle
> "It is better to have 100 functions operate on one data structure than 10 functions on 10 data structures."
Generic operations on generic data structures beat specialized operations on specialized structures.
## Why Custom Abstractions Hurt
Every custom type, wrapper class, or specialized structure:
- Adds a concept to understand
- Requires its own operations
- Limits composition with other code
- Creates maintenance burden
A `Map<String, Value>` can be processed by hundreds of existing functions. A `SettingsManager` class can only be processed by the methods you write for it.
## Information Over Objects
Model the information domain, not the behavior.
- What data exists?
- What are the essential relationships?
- What transformations do you need?
Then use generic structures (maps, vectors, sets) to represent that information. The behavior comes from functions that operate on data - not from methods bound to custom objects.
## Practical Application
Before creating a new class/type, ask:
- Could this be a map/dict with well-known keys?
- Could this be a simple tuple/record?
- Do I need custom behavior, or just data?
If you just need data, use data structures. Save custom types for when you genuinely need custom behavior that can't be a function.
**The power is in the combinations, not the custom constructs.**
## External References
- [The Value of Values](https://www.infoq.com/presentations/Value-Values/) - Rich Hickey on data vs objects
- [Data-Oriented Design](https://www.dataorienteddesign.com/dodbook/) - Richard Fabian's book on DOD
- [CppCon 2014: Mike Acton "Data-Oriented Design"](https://www.youtube.com/watch?v=rX0ItVEVjHc) - Practical DOD in game engines
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |