octopus-architecture

Generates system architecture designs through multi-AI consensus using the backend-architect persona.

Updated Aug 15, 2026
One-click install
npx skills add https://github.com/GongYuanCaiJi/dsh-claude-octopus --skill octopus-architecture-gongyuancaiji
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: octopus-architecture
Source: https://github.com/GongYuanCaiJi/dsh-claude-octopus/tree/main/.claude/skills/skill-architecture
Command: npx skills add https://github.com/GongYuanCaiJi/dsh-claude-octopus --skill octopus-architecture-gongyuancaiji

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designing system architecture alone risks blind spots and unchallenged assumptions. This Skill routes architecture requests through an orchestrated multi-AI workflow where external providers (Codex, Antigravity) and Claude independently evaluate the design before results are delivered. ## Core Features & Use Cases - Multi-provider architecture review: Spawns the backend-architect persona via orchestrate.sh so external models challenge and refine the design. - Enforced execution contract: Mandatory visual banner, provider availability check, and validation gates prevent skipping the orchestration step. - Broad design coverage: API design, microservices decomposition, event-driven architecture, database schema, and scalability planning. - Use Case: Ask to design a scalable notification system, and the Skill checks provider availability, runs the backend-architect persona through orchestrate.sh, verifies execution, and presents a consensus-informed architecture with attribution. ## Quick Start Ask the assistant to design the architecture for an event-driven messaging system using the octopus architecture skill.

Frequently Asked Questions about octopus-architecture

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

FAQPage Schema
How do I design system architecture with multiple AI models?▼

Invoke this skill with an architecture request; it runs orchestrate.sh to spawn the backend-architect persona, which gathers input from available external providers like Codex and Antigravity plus Claude, then presents a synthesized design.

What architecture tasks does the backend-architect persona handle?▼

It covers API design and RESTful patterns, microservices decomposition, distributed systems, event-driven architecture, database schema design, and scalability planning during the grasp and tangle phases.

Can I use this skill without external AI providers installed?▼

No. The execution contract checks provider availability first; if no external providers are available it stops and suggests running /octo:setup. At least one external provider must be present to proceed.

Why does the skill refuse to design architecture directly?▼

The enforced execution mode prohibits direct design or simulated workflows. It must invoke orchestrate.sh via the Bash tool and verify successful execution before presenting any results, ensuring multi-AI consensus actually occurred.

How does LSP integration improve architecture design?▼

The skill recommends using LSP tools like document symbols, find references, and diagnostics to ground designs in the existing codebase structure, verify interface contracts, and catch type mismatches before finalizing recommendations.