superpowers-sage:architecture-discovery

Map WordPress, Sage, Acorn, and Lando codebases into approved architecture specs.

13|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/codigodoleo/superpowers-sage --skill superpowers-sage-architecture-discovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpowers-sage:architecture-discovery
Source: https://github.com/codigodoleo/superpowers-sage/tree/main/skills/architecture-discovery
Command: npx skills add https://github.com/codigodoleo/superpowers-sage --skill superpowers-sage-architecture-discovery

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Architecture discovery maps an existing WordPress + Sage + Acorn + Lando codebase to produce an approved architecture spec before any implementation plan.

Core Features & Use Cases

  • Branch & scope initialization and normalization
  • Explore project context (config files, blocks, providers, and active plans)
  • Clarifying questions and iterative refinement
  • Identify components, data flows, dependencies, and ADRs
  • Parallel probes with content-modeler, design-extractor, sage-reviewer
  • Propose multiple approaches with rationales; select a preferred path
  • Write architecture spec to disk at the approved path
  • Spec review loop and handoff to superpowers-sage:plan-generator
  • Prepare and deliver the handoff payload for planning

Quick Start

Invoke the architecture-discovery skill with your feature scope description to begin generating an approved architecture spec.

Frequently Asked Questions about superpowers-sage:architecture-discovery

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

FAQPage Schema
How do I create an architecture spec for a WordPress Sage theme before implementation?

Architecture discovery maps your WordPress, Sage, Acorn, and Lando codebase to produce an approved architecture spec file before any implementation begins. It identifies components, data flows, dependencies, and ADRs through iterative refinement.

What is the process for architecture discovery in a Sage and Acorn project?

Architecture discovery involves branch initialization, project context exploration, clarifying questions, and parallel probes to identify components. It proposes multiple approaches with rationales, selects a preferred path, and writes the architecture spec to disk.

Can I use architecture discovery to map existing WordPress blocks and providers?

Yes, architecture discovery explores project context by mapping existing config files, blocks, providers, and active plans. It uses parallel probes to analyze these elements and identify dependencies within your Sage and Acorn codebase.

Do I need a Lando environment to run architecture discovery on a Sage theme?

Architecture discovery is designed for WordPress, Sage, Acorn, and Lando codebases. It maps the existing project context including configuration files and providers to generate an architecture spec tailored to that specific stack.

What's the best way to develop ADRs for a WordPress Sage and Acorn feature?

Architecture discovery identifies components, data flows, dependencies, and ADRs during the design phase. It proposes multiple approaches with rationales and selects a preferred path, then writes the approved architecture spec to disk for review.

How does architecture discovery hand off the spec for implementation planning?

Architecture discovery enforces a spec review loop and prepares a handoff payload for the plan generator. This gated step validates the architecture spec before transitioning to implementation planning.