跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
其他技能

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

  1. 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 as outline-N+1.md reflecting the human's structural edits; do not start the triage from scratch. Preserve the throughline unless the edits explicitly reframe it.

  2. 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.md for the full triage methodology.
  3. 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.

  4. 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.md for structure templates.

  5. 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.md for the handoff protocol.

Reference Guide

TopicReference
Triage methodology and section mappingreferences/architect-process.md
Blueprint output format and structure templatesreferences/blueprint-template.md
Human-led decision process and Carpenter handoffreferences/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.md absorbing the structural revisions, then hand off to the
阅读完整来源 ↗