architect

Designs technical decisions through structured discovery and writes build specs to docs/specs/.

Updated Sep 19, 2026
One-click install
npx skills add https://github.com/idehen-divine/lumished --skill architect-idehen-divine
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/idehen-divine/lumished/tree/main/.ai/skills/architect
Command: npx skills add https://github.com/idehen-divine/lumished --skill architect-idehen-divine

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Load bearing technical decisions often go unmade or undocumented, leaving builders to invent answers mid implementation. This Skill runs a structured design conversation, weighs options with a clear recommendation, and records the outcome as a numbered build spec in docs/specs/ so downstream build and verify steps work from a settled contract. ## Core Features & Use Cases - Four design modes: FEATURE for new features, ARCHITECTURE for stack selection, ENHANCEMENT for improving existing systems, and CROSS-CUTTING for codebase wide standards. - Staged discovery conversation: sorts every question into INFER, ASK, or RECOMMEND so the engineer is only asked what they alone know, with expert recommendations for everything else. - Spec lifecycle management: creates, updates, supersedes, or ratifies specs with status tracking (Proposed, In Progress, Accepted, Assumed) linked to the feature build lifecycle. - Use Case: When deciding how to add org isolation to a B2B SaaS app, run the architect skill to deliberate the data model and enforcement approach, then receive a spec with acceptance criteria, a build plan, and consequences that the develop skill builds against. ## Quick Start Run /architect with a one or two sentence description of the feature, system, or technical choice you need to design.

Frequently Asked Questions about architect

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

FAQPage Schema
How do I design a new feature before writing code?▼

Run /architect with a short description of the feature. It runs a staged design conversation covering acceptance criteria, data model, API surface, and edge cases, then writes a build spec to docs/specs/ that the develop skill implements against.

How do I choose a tech stack for a new project?▼

Use the ARCHITECTURE mode by describing the project to /architect. It evaluates stack options against your constraints, recommends a specific choice with a runner up, and records the decision in a Proposed stack spec without writing any code.

Can the architect skill update an existing spec?▼

Yes. When a topic overlaps an existing spec, it asks whether to create a new decision, update the spec in place, or supersede it. Superseding writes a new spec and marks the old one as Superseded by the new number.

What is an Assumed spec and how is it ratified?▼

An Assumed spec is created by /develop when you build before deliberating a load bearing decision, and it blocks the feature from done. Running /architect on that topic ratifies it by filling in the real decision content or superseding it if the assumption was wrong.

Does the architect skill write implementation code?▼

No. It writes no code and only produces spec files in docs/specs/ plus scope linking updates. Implementation is delegated to the /develop skill, which reads the spec's Requirements, Decision, and Build plan sections.

When should I not use a structured design spec?▼

Skip it for trivial changes with no load bearing decision, such as copy edits or config tweaks. The skill itself recommends lighter cross check handling at Vibe tier, and very small tasks can go straight to /develop without a spec.