architect

Produces an architecture-and-delivery doc from a precon scope doc through a structured interview.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Ideas often jump from a scope doc straight into slicing and provisioning, so structural decisions get made implicitly at the moment of least information. This Skill inserts a dedicated drawings step that settles one-way-door decisions (language, database, repo shape, data shapes, platform) before any building begins. ## Core Features & Use Cases - Structured architecture interview: Runs a three-step negotiation covering the walkthrough target (a named first user, a date, and required capabilities), 2-3 genuinely distinct candidate structures, and a one-way-door check against the full vision. - Living architecture doc: Writes one continuously updated markdown doc per project with a v0 drawing, poured-concrete decisions, deferred items, and an append-only run log with strikethrough history. - Visual artifact and blind review: Renders the decisions as a private HTML artifact and optionally sends the scope doc (never Claude's own work) to outside models via the readers roster for a cold review that Tony rules on item by item. - Use Case: After /precon produces a scope doc for a new app idea, run /architect to decide whether Postgres or flat files fit the vision, record the decision, and hand the doc to /sunrise and /blueprint downstream. ## Quick Start Type /architect with the path to your precon scope doc to start the architecture interview and produce the architecture doc.

Frequently Asked Questions about architect

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

FAQPage Schema
How do I run the architect skill?

Type /architect, optionally with the path to a precon scope doc. The skill locates the scope doc by globbing docs/scope/ and ~/Documents, then runs a short interview covering the walkthrough target, candidate structures, and one-way doors before writing the architecture doc.

What is a walkthrough target in architecture planning?

A walkthrough target names one real person, a date, and the short list of things that person must be able to do in the first session. Every v0 component must point at a walkthrough requirement or it is cut, keeping the initial build minimal.

Can the architect skill provision repos or databases?

No. The skill only writes a markdown doc and a private HTML artifact. Provisioning belongs to /sunrise, which reads the poured-concrete list the architecture doc records; banked decisions are documented, never executed.

What happens if I run architect without a scope doc?

The skill opens a gate discussion about why it is running docless and proceeds only when that discussion lands on a reason, which is recorded in the doc header. A docless run skips the blind review offer since there is no brief to send.

How does the blind review of an architecture doc work?

On your explicit word, the skill sends only the precon scope doc to readers roster rows such as GPT, Gemini, or Claude with a fixed instruction to produce their own architecture take. Each disagreement is walked through one at a time and the doc changes only where you rule.

When should I not use the architect skill?

Skip it when there is no system at all, such as a single static page with no server or stored data. The exit-ramp question ends the interview immediately in that case, leaving only a tiny doc noting nothing needs provisioning.