architect

Designs software architecture through multi-model sketch candidates before implementation begins.

Updated Sep 2, 2026
One-click install
npx skills add https://github.com/jnyross/pstack-muse --skill architect-jnyross
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/jnyross/pstack-muse/tree/main/skills/architect
Command: npx skills add https://github.com/jnyross/pstack-muse --skill architect-jnyross

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Jumping straight into code on non-trivial work often locks in the wrong architecture, forcing painful rewrites later. This Skill enforces a design-first workflow that sketches types, signatures, and module boundaries before any implementation, and provides a structured way to scrap and redesign when the architecture proves wrong. ## Core Features & Use Cases - Phased design workflow: Ground the problem in the existing system, sketch candidate designs, optionally checkpoint with a human, implement against the sketch, and scrap when friction patterns emerge. - Parallel multi-model exploration: Runs multiple model runners to produce structurally distinct design candidates, then synthesizes the best one based on interface depth and design red-flag screening. - Structured rationale output: Ships a one-page rationale alongside the type sketch covering the problem, caller usage, tradeoffs, alternatives, and open questions. - Use Case: Before building a new caching layer across three services, run the architect workflow to trace the existing system, generate two or more competing designs from different models, and commit the synthesized type sketch as a scaffold before filling in code. ## Quick Start Ask the AI to architect the new feature before writing any code, for example by saying "/architect the retry mechanism for the payment service".

Frequently Asked Questions about architect

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

FAQPage Schema
How do I design software architecture before writing code?

Use a phased workflow: ground yourself in the existing system, sketch types and signatures with placeholder bodies, synthesize the best design from multiple candidates, then implement against the sketch. The architect skill automates this loop and treats deviations from the sketch as signals to revisit the design.

How to compare multiple design candidates for a feature?

Generate at least two structurally distinct candidates using parallel model runners, then screen each against design red flags like shallow modules, information leakage, and pass-through methods. Compare survivors on interface depth, preferring the design that hides more complexity behind a smaller public surface.

When should I scrap an architecture and redesign?

Scrap when you see a repeated pattern of friction, not isolated hard cases: the same workaround shape across unrelated code, types needing escape hatches like casts or any, or callers forced to know internal rules. Re-ground in what the implementation taught you, then redesign from first principles.

Does the architect skill require human approval before implementing?

No, human checkpoints are opt-in. By default it proceeds directly from the synthesized design to implementation. You can request a checkpoint by asking to stop and review the design before coding begins.

What are the limitations of design-first architecture workflows?

The grounding phase can be skipped only for genuinely greenfield work, so integrating with unfamiliar systems adds upfront tracing effort. The workflow also depends on multiple configured model runners for candidate generation, and single-runner setups lose the design-space exploration benefit.