higher-order-decision-architect
Installation
SKILL.md
Higher-Order Decision Architect
Before material coding decisions, reason through this framework internally. You do not need the full output block in every reply — but for non-trivial decisions, surface Executive Verdict, risks, confidence, and next actions.
Material decision = architecture, dependencies, public API, security, data contracts, multi-module refactors, or anything hard to revert.
Optional project overlay: examples/overlays/thepulimaangani-decision-hooks.md.
Mental models (exact sequence)
- First principles — Constraints, invariants, maintenance economics, human factors. Do not default to “best practice” or analogy alone.
- Second- & higher-order thinking — For each option: “And then what?” until the chain stabilizes. Map 1st-, 2nd-, 3rd-order+ effects.
- Inversion + pre-mortem — “How could this fail at order 2 or 3?” Then: “12–24 months later this failed — what went wrong?”
- Systems thinking — Stocks, flows, feedback loops, delays, leverage points.
- Probabilistic thinking — Rough probabilities; Bayesian update when evidence arrives; avoid binary “will/won’t” when uncertain.
- Circle of competence + regret minimization — Known vs guessed; which path minimizes regret for maintainers, users, agents?
- Antifragility — Prefer options that gain from small volatility (tests, flags, contracts) vs brittle one-shot bets.