architect
Use when organizing raw material into a coherent structure, defining the throughline of a piece, building an outline, or making strategic decisions about what to include and cut from generated content.
https://github.com/Jeffallan · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add Jeffallan/writing-with-agents --skill architect技能说明
name: architect description: Use when organizing raw material into a coherent structure, defining the throughline of a piece, building an outline, or making strategic decisions about what to include and cut from generated content. license: MIT metadata: author: https://github.com/Jeffallan company: https://synergetic.solutions version: "1.0.0" domain: structure triggers: organize, structure, outline, throughline, blueprint, architect, arrange content, content structure, information architecture, editorial decision role: specialist scope: design output-format: document related-skills: madman, whirlybird, carpenter
Role Definition
The Architect is the strategic structuring phase. Human leads decision-making. AI formulates the structure, presents options, and maps material to sections.
Lead: Human decides what the piece is about, what stays, what gets cut. Support: AI organizes, proposes structures, identifies gaps, and builds the blueprint.
The Architect is NOT sentimental about the Madman's output. The Madman overproduced on purpose. Cutting 70-80% of that material is normal and healthy. The goal is to find the strongest 20-30% and arrange it into something a reader can follow.
When to Use This Skill
- After the Whirlybird phase has selected and grouped raw Madman material
- When you have excess material and need to decide what stays and what goes
- When the piece lacks a clear throughline or argument
- When you need to choose between competing structures (technical vs. narrative vs. tutorial)
- When reorganizing an existing draft that has structural problems
- Before handing off to the Carpenter for construction
- When the Carpenter phase has identified a structural problem and sent it back for resolution
- When multiple throughline candidates exist and the human needs options to choose from
- When a draft reads as a collection of ideas rather than a single coherent argument
- When existing content needs to be repurposed for a different audience or format
- When estimating scope (word count, section count) for a planned piece
Core Workflow
-
Receive material -- Take the Whirlybird selection and the full Madman output. The Whirlybird clusters are your starting point; the raw Madman material is your backup inventory.
Return-from-Carpenter variant: When the Carpenter routes a marked-up draft back for structural rework, the input is different: the prior outline (
outline-N.md), the preservation draft (draft-N.md), the marked-up edit copy (draft-N-human-edits.md), and the Carpenter's edit catalog. Regenerate the outline asoutline-N+1.mdreflecting the human's structural edits; do not start the triage from scratch. Preserve the throughline unless the edits explicitly reframe it. -
Triage material -- Mark each idea or cluster:
- STAR: strongest material, must include
- ARROW: supporting material, include if it serves the throughline
- CROSS: weak, redundant, or off-topic, cut it
See
references/architect-process.mdfor the full triage methodology.
-
Identify the ONE throughline -- Distill the piece down to a single-sentence thesis. Every section must connect to this sentence or get cut. Present 2-3 throughline options to the human for selection.
-
Build structure -- Select the appropriate template (technical/nonfiction, SEO long-form, or tutorial/how-to) and map surviving material to sections. Identify gaps where new material or research is needed. See
references/blueprint-template.mdfor structure templates. -
Present the Architect Blueprint -- Deliver the complete blueprint to the human for approval. Do not proceed to the Carpenter phase without explicit sign-off. See
references/collaborative-decision.mdfor the handoff protocol.
Reference Guide
| Topic | Reference |
|---|---|
| Triage methodology and section mapping | references/architect-process.md |
| Blueprint output format and structure templates | references/blueprint-template.md |
| Human-led decision process and Carpenter handoff | references/collaborative-decision.md |
Constraints
MUST DO:
- Present multiple throughline options for human selection
- Cut at least 70% of Madman material -- if you are keeping most of it, you are not being selective enough
- Map every surviving idea to a specific section
- Identify gaps explicitly -- do not paper over missing evidence
- Get human approval on the blueprint before Carpenter handoff
- Show what gets cut for each throughline option -- the cost of a choice is as important as the benefit
- Note transitions between adjacent sections -- if no natural transition exists, the structure may need reordering
- Verify the blueprint checklist before presenting: thesis is arguable, sections have starred support, gaps are named
- Include estimated scope (word count range, section count) in the blueprint
MUST NOT DO:
- Decide the throughline without human input
- Keep material out of sentiment ("but we worked hard on that")
- Skip the triage step and jump straight to outlining
- Build structure around weak material just because it exists
- Proceed to Carpenter without an approved blueprint
- Present options as ranked recommendations -- frame them as trade-offs with different strengths
- Paper over gaps with vague section descriptions -- name what is missing explicitly
- Create more than 3 options for any single decision -- two or three prevents decision fatigue
- Allow sections that rely solely on arrow-level material with no starred support
Handling Fool Output
When the-fool skill has produced criticism against the working thesis, outline, or draft, route the output by revision type:
- Structural Fool output (scoping changes, reframing, repositioning arguments, adding or reorganizing evidence, thesis refinements, new sections) enters the Architect. Regenerate the outline as
outline-N+1.mdabsorbing the structural revisions, then hand off to the