systems-thinking

Evaluate software changes against system architecture and coding conventions.

8|1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/bostonaholic/team --skill systems-thinking-bostonaholic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systems-thinking
Source: https://github.com/bostonaholic/team/tree/main/skills/systems-thinking
Command: npx skills add https://github.com/bostonaholic/team --skill systems-thinking-bostonaholic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill addresses the tendency to implement changes in isolation, which often leads to broken dependencies, inconsistent patterns, and technical debt by ignoring the broader system context.

Core Features & Use Cases

  • Blast Radius Analysis: Evaluates how a change impacts callers, consumers, and sibling implementations rather than just the modified lines.
  • Convention Enforcement: Ensures new code adheres to established naming, layout, and error-handling patterns within the codebase.
  • Use Case: When refactoring a core utility function, use this skill to identify all downstream consumers and sibling implementations that must be updated to maintain system consistency.

Quick Start

Apply the systems-thinking lens to evaluate the architectural impact and potential blast radius of the proposed changes in the current feature branch.

Frequently Asked Questions about systems-thinking

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify the blast radius of a code change before refactoring?

Blast radius analysis evaluates how a change impacts callers, consumers, and sibling implementations rather than just the modified lines. This framework identifies all downstream dependencies that require updates to maintain system consistency.

What is systems thinking in software architecture and when do I need it?

Systems thinking in software architecture is a reasoning framework for evaluating changes against established conventions. You need it during research, design, planning, and implementation to prevent broken dependencies and technical debt from isolated changes.

How to enforce coding conventions across sibling components during a refactor?

Enforce coding conventions by applying a reasoning loop that validates new code adheres to established naming, layout, and error-handling patterns. This ensures all co-changing surfaces are addressed within the same slice.

Why does refactoring a core utility function break downstream consumers?

Refactoring breaks downstream consumers when changes are implemented in isolation, ignoring broader system context. A reasoning framework identifies all sibling implementations and dependent surfaces that must be updated simultaneously.

Can I use architectural reasoning to validate code review changes?

Yes, architectural reasoning validates code review changes by evaluating proposed modifications against existing system architecture. It operates during implementation to confirm all co-changing surfaces are addressed within the same development slice.

What are the limitations of evaluating code changes in isolation?

Evaluating code changes in isolation leads to broken dependencies, inconsistent patterns, and technical debt. Without analyzing the blast radius, you miss downstream consumers and sibling implementations that require concurrent updates.