# Octopus Architecture

Review system architecture, simplify boundaries, or compare interface designs from...

- Repository: https://github.com/nyldn/claude-octopus (4351 stars)
- Category: Design
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add nyldn/claude-octopus --skill octopus-architecture -g -a claude-code -y`
Codex: `npx skills add nyldn/claude-octopus --skill octopus-architecture -g -a codex -y`
Cursor: `npx skills add nyldn/claude-octopus --skill octopus-architecture -g -a cursor -y`
Gemini CLI: `npx skills add nyldn/claude-octopus --skill octopus-architecture -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add nyldn/claude-octopus`

## Description

Review system architecture, simplify boundaries, or compare interface designs from repository evidence

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Architecture review

Load `skills/blocks/engineering-method-selection.md` from the installed plugin
and apply only the methods relevant to this task. Preserve this entry point's
execution contract and output format. Read referenced skills as instructions;
do not invoke the current command recursively or add provider calls from a seat.

Run this method on the current host. A routine architecture review makes zero additional provider dispatches.
`--peer-review`, an explicit independent-review
request, or an existing risk policy may add one bounded external reviewer through
Octopus routing. Report incomplete independent coverage if that reviewer cannot
read the source or does not return a grounded contribution.

## Method

Read and apply `skills/blocks/architecture-simplification.md` from the installed
plugin root. Pin the source revision and inspect implementation, callers, tests,
recent churn, and failure behavior before recommending a boundary.

For a single simplification, produce one evidence-backed interface. For a design
choice, produce two alternatives from the same immutable requirements:

- Draft A minimizes caller knowledge and configuration.
- Draft B makes the next demonstrated extension easier.

Label two host-generated drafts as correlated alternatives from one model. If an
independent reviewer is authorized, send it the same source and requirements but
not Draft A before its first response. Transport diversity does not prove model
family diversity. Unknown family means unknown independence.

## Completion

Return `Evidence`, `Caller contract`, `Proposed interface`, `Migration`, `Test
impact`, and `Decision`. The decision is `keep`, `simplify`, or `investigate`.
`simplify` requires exact source evidence and a concrete caller example. A design
review never authorizes an automatic refactor.

## LSP Integration

The rest: https://github.com/nyldn/claude-octopus/blob/HEAD/.claude/skills/skill-architecture/SKILL.md