Skip to content

akurganow/design-review

v0.4.0MIT

Reviews a software design for complexity with the red flags and principles of Ousterhout's A Philosophy of Software Design, each finding cited by chapter.

design-review

Reviews a software design for complexity with the red flags and principles of Ousterhout's A Philosophy of Software Design, each finding cited by chapter.

Install

Claude Code

/plugin marketplace add Akurganow/pegboard
/plugin install design-review@pegboard

Source: Claude Code documentation, https://code.claude.com/docs/en/discover-plugins. CI installs it on Ubuntu, macOS and Windows.

Codex

codex plugin marketplace add Akurganow/pegboard --ref main
codex plugin add design-review@pegboard

Source: Codex documentation, https://developers.openai.com/plugins/build/plugins, for marketplace add; Codex source, plugin_cmd.rs, for plugin add. CI installs it on Ubuntu, macOS and Windows.

Oh-My-Pi

omp plugin marketplace add Akurganow/pegboard
omp plugin install design-review@pegboard

Source: Oh-My-Pi documentation, docs/marketplace.md. CI installs it on Ubuntu, macOS and Windows.

Hermes

hermes plugins install Akurganow/pegboard/plugins/design-review --no-enable
hermes plugins list
hermes plugins enable design-review

Keep the plugins/design-review suffix: without it Hermes copies the whole repository, and its two-level scan finds no package.

Source: Hermes documentation, developer-guide/plugins/index.md, for the commands; Hermes source, plugins_cmd.py (_resolve_git_url), for the subdirectory form and what happens without it. CI installs it on Ubuntu and macOS.

Cursor

Cursor's documentation names no command that installs from a repository. It names three routes:

  • Public marketplace: open Customize, find the plugin, select Install. A plugin appears there only after Cursor reviews a submitted repository, and this repository claims no listing.
  • Team marketplace, on Teams and Enterprise plans: in Dashboard, Plugins & MCPs, Team Marketplaces, select Add Marketplace, then Import from Repo, and paste https://github.com/Akurganow/pegboard. Developers then install from Customize.
  • Local: copy bundles/design-review to ~/.cursor/plugins/local/design-review, then restart Cursor or run Developer: Reload Window.

Source: Cursor documentation, Plugins, read 2026-11-04, for the three routes; Plugins reference, read 2026-11-04, for the submission and review. CI does not install it.

OpenClaw

openclaw plugins install design-review --marketplace Akurganow/pegboard

Source: OpenClaw documentation, docs/cli/plugins/install.md. OpenClaw reads this repository's .claude-plugin/marketplace.json (OpenClaw source, marketplace.ts). CI does not install it.

Kiro

No install command is given. Kiro's documentation says Powers follow the Agent Plugins specification, and plugins/design-review/plugin.json carries every field the documentation requires. The documentation does not say how Kiro finds several packages in one repository. CI does not install it.

Source: Kiro documentation, Create a power and Installation, read 2026-11-04.

Usage

Describe the design, or paste it:

Review the design of our storage module. Callers must call open, configure
and start in that order before every read, and three services wrap it.

When the session has the repository, the red-flags skill reads the callers and the change history itself and asks you only for what the code cannot say. It answers in one reply: a verdict on your question, then findings ranked by how often each part is touched and what touching it costs. Each finding gives the place, the flag or principle with its chapter or section, the cause, the change and what the change costs. At most three questions come at the end.

What's inside

PathWhat it is
skills/red-flags/SKILL.mdthe procedure, the fourteen red flags and the sixteen principles with their sections
skills/red-flags/references/red-flags.mdwhat to look for under each red flag
skills/red-flags/references/complexity.mdthe definition of complexity, its weighting, and the studies on change history
skills/red-flags/references/principles.mddepth, the limit of general-purpose modules, pulling complexity down
skills/red-flags/references/decisions.mdthe criteria for together or apart, errors, design it twice, comments and names
skills/red-flags/references/positions.mdwhere the book takes a side, the other side, and the evidence on TDD and method length
skills/red-flags/references/sources.mdwhere each text was read, its kind and date, and what was not read
plugin.json in plugins/design-review/; .claude-plugin/, .codex-plugin/ and .cursor-plugin/ manifests in bundles/design-review/the Agent Plugins 1.0.0 manifest in the first build, one manifest per client in the second
LICENSEthe MIT license

The package has no script, hook, rule file or network access.

The book is under copyright. sources.md records the author's published extract of the second edition and two public translation repositories that carry the English, each named by commit, and no bought copy of either edition. Chapter quotations are a few sentences at most.

Boundaries

  • The review weighs one quality: complexity in the book's sense.
  • For method length, comments and test-driven development, a finding carries Robert Martin's reply from his written discussion with Ousterhout. The book's other positions carry no reply, because positions.md quotes no text of the other side for them.
  • The weights come from version history when the repository is at hand. The skill says this is its proxy for the book's time spent, and complexity.md records that no study read tests change frequency times complexity as a ranking.
  • A trade-off between two measured qualities belongs to the contradiction skill of triz-thinking. Many symptoms with one unclear cause belong to root-cause in toc-thinking. What a reader cannot hold in their head belongs to extraneous in cognitive-load. The skill offers a hand-over only to a skill that is installed.

License

MIT. See LICENSE.

Help

See SUPPORT.md. The pegboard marketplace lists the other packages.