eng-holistic-systems
Holistic Systems Thinking
Intent
- Understand the true user goal, success metrics, and non-negotiable constraints.
- Trace data/control flow across clients, services, contracts, and on-chain/off-chain boundaries.
- Surface hidden couplings, scalability ceilings, and rollback requirements early.
Inputs to Gather
- Problem statement in your own words plus measurable success criteria.
- Existing architecture sketches (runtime, deployment, data lifecycle) and ownership boundaries.
- Operational constraints: latency/throughput budgets, privacy rules, platform limitations, on-chain gas caps, store policies, etc.
- Known risks: single points of failure, stale assumptions, migrations in flight.
Workflow
- Map the ecosystem
- List upstream/downstream systems, contracts, and user touchpoints affected.
- Identify invariants that must hold and where they can break.
- Reason about change scope
- Partition work into independently testable slices with explicit integration seams.
- Decide where to place new logic (client/server/worker/contract) based on latency, trust, and deployability.
- Plan resiliency
- Define failure detection signals, graceful degradation, and rollback/feature-flag hooks.
- Highlight areas needing schema/version negotiation.
- Record decisions for execution
- Capture the chosen approach, tradeoffs, and open questions inside the ticket/PR description before implementation.
Verification
- Confirm each requirement maps to at least one planned change and validation step.
- Share the plan with a peer or stakeholder; ensure assumptions and risks are acknowledged.
- Revisit this skill after implementation planning to see if new dependencies appeared; update the plan accordingly.
More from tjboudreaux/cc-plugin-engineering-excellence
eng-tdd
Enforces disciplined RED-GREEN-REFACTOR cycle—write failing test first, watch it fail, write minimal code to pass, then refactor.
2eng-verification
Mandatory checklist before claiming work is complete—run the evidence-producing command, inspect output, and only then state a result.
2eng-performance
Guard latency, memory, battery, bandwidth, and gas/compute budgets by measuring before and after every change.
2eng-user-impact
Anchor every engineering decision in user value, measurable outcomes, accessibility, and cross-platform experience coherence.
2meta-superpowers
Startup protocol for every task—discover applicable skills, run them, announce usage, and follow required workflows (brainstorming, TodoWrite checklists, etc.).
2eng-observability
Design every change with traceability, diagnostics, and fast incident triage in mind across mobile, web, and web3 stacks.
2