Menu
Design or refine software architecture.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Apply the Systems Thinking workflow from AGENTS.md when a task may be misframed, under-specified, or tangled with adjacent concerns.
Test hypotheses through experiments and disposable tools.
Research the workspace for a topic. Report patterns in the corpus.
Open the files, directories, and links relevant to the current context.
Iteratively improve writing.
Delegate task(s) to background sub-agent(s).
| name | systems-design |
| description | Design or refine software architecture. |
Use @../refactor/SKILL.md.
Model the system as a sequence of stages from input to output.
Split stages where data changes meaning, ownership, or crosses an effect boundary.
Define explicit input and output types for each stage.
Make each stage either a transform or an effect.
Place persistent state behind stage boundaries: files, queues, or databases.
Define stage boundaries as contracts with substitutable implementations.
Use the most specific concrete implementation within each stage.
Keep transform stages referentially transparent.
Test effect stages through substitutable boundary implementations.
