architect

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

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/JabezJesudasonJena/hack-ag --skill architect-jabezjesudasonjena
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/JabezJesudasonJena/hack-ag/tree/main/.agents/skills/architect
Command: npx skills add https://github.com/JabezJesudasonJena/hack-ag --skill architect-jabezjesudasonjena

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 work follows a settled decision. ## 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 like error handling or auth. - Structured discovery: sorts every question into INFER, ASK, or RECOMMEND, challenges weak premises against known failure patterns, and never presents a neutral menu of options. - Spec lifecycle management: creates, updates, supersedes, or ratifies specs with status tracking (Proposed, In Progress, Accepted, Assumed), umbrella directory specs for multi decision topics, and scope file linking. - Use Case: A team needs to choose between REST and GraphQL for a new API. Run /architect, answer the staged design questions, and receive a written spec with the decision, rationale, data model, acceptance criteria, and an ordered build plan. ## Quick Start Run /architect with a one 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 asks targeted questions about requirements and constraints, recommends stack and pattern choices, then writes a spec with acceptance criteria, a data model, and an ordered build plan to docs/specs/.

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 as a standalone spec with a proposed stack table.

What happens when a spec already exists for my topic?

The Skill detects overlapping specs during pre-flight and asks whether to create a new decision, update the existing spec in place, or supersede it. Superseding writes a new spec and marks the old one as Superseded with a link to the replacement.

Does the architect skill write implementation code?

No, it writes no code. It produces build specs only; the /develop skill reads those specs to build the feature. Subagents it spawns are read only, limited to scanning the codebase or fetching web references.

What is an Assumed spec and how do I clear it?

An Assumed spec is created by /develop when you build before deliberating a load bearing decision, and it blocks the feature from being marked done. Run /architect to ratify it: the Skill deliberates the decision properly and either confirms the assumption or supersedes it with a corrected spec.