$curl -o .claude/agents/README.md https://raw.githubusercontent.com/AlpacaLabsLLC/skills-for-architects/HEAD/agents/README.mdAgents are autonomous specialists that orchestrate multiple skills to complete a complex task. Unlike skills (single-purpose, invoked directly), agents assess the situation, choose a path, and exercise judgment.
| 1 | # Agents |
| 2 | |
| 3 | Agents are autonomous specialists that orchestrate multiple skills to complete a complex task. Unlike skills (single-purpose, invoked directly), agents assess the situation, choose a path, and exercise judgment. |
| 4 | |
| 5 | All seven agents ship with the **architecture-studio** plugin (this `agents/` directory), so installing the plugin registers each one as a native Claude Code subagent — Claude can delegate to it automatically, and `/studio` routes to it by name. |
| 6 | |
| 7 | ## Available Agents |
| 8 | |
| 9 | | Agent | Domain | Skills it orchestrates | |
| 10 | |-------|--------|----------------------| |
| 11 | | [site-planner](./site-planner.md) | Site Planning | environmental-analysis, mobility-analysis, demographics-analysis, site-history | |
| 12 | | [nyc-zoning-expert](./nyc-zoning-expert.md) | Due Diligence + Zoning | nyc-landmarks, nyc-dob-permits, nyc-dob-violations, nyc-acris, nyc-hpd, nyc-bsa, nyc-property-report, zoning-analysis-nyc, zoning-envelope | |
| 13 | | [workplace-strategist](./workplace-strategist.md) | Programming | occupancy-calculator, workplace-programmer | |
| 14 | | [sustainability-specialist](./sustainability-specialist.md) | Sustainability | epd-research, epd-compare, epd-parser, epd-to-spec | |
| 15 | | [product-and-materials-researcher](./product-and-materials-researcher.md) | Materials Research | product-research, product-spec-bulk-fetch, product-spec-pdf-parser, product-match, product-enrich | |
| 16 | | [ffe-designer](./ffe-designer.md) | FF&E Design | product-pair, product-data-cleanup, product-data-import, product-enrich, product-image-processor, csv-to-sif, sif-to-csv | |
| 17 | | [brand-manager](./brand-manager.md) | Presentations | slide-deck-generator, color-palette-generator, resize-images | |
| 18 | |
| 19 | ## How Agents Differ from Skills |
| 20 | |
| 21 | | Layer | Behavior | Example | |
| 22 | |-------|----------|---------| |
| 23 | | **Skill** | Does one thing when invoked | `/product-research` searches the web for products | |
| 24 | | **Agent** | Assesses the input, chooses a path, orchestrates skills, exercises judgment | The researcher decides whether to search, extract from PDFs, or find alternatives based on what you give it | |
| 25 | |
| 26 | Use an **agent** when the task is open-ended and multi-step (the agent decides which skills to run and in what order). Call a **skill** directly when you know exactly which single operation you need. |
| 27 | |
| 28 | ## How They Work Together |
| 29 | |
| 30 | ``` |
| 31 | Address or site |
| 32 | ↓ |
| 33 | site-planner |
| 34 | → climate, transit, demographics, neighborhood context |
| 35 | ↓ |
| 36 | nyc-zoning-expert |
| 37 | → property records, zoning envelope, 3D visualization |
| 38 | ↓ |
| 39 | workplace-strategist |
| 40 | → occupancy compliance, zone allocation, room schedule |
| 41 | ↓ |
| 42 | product-and-materials-researcher |
| 43 | → finds products, extracts specs, tags and classifies |
| 44 | ↓ |
| 45 | sustainability-specialist |
| 46 | → evaluates environmental impact, compares GWP, checks LEED |
| 47 | ↓ |
| 48 | ffe-designer |
| 49 | → composes room packages, builds schedule, runs QA, exports |
| 50 | ↓ |
| 51 | brand-manager |
| 52 | → builds the presentation, ensures visual consistency |
| 53 | ``` |
| 54 | |
| 55 | Each agent works standalone. Use one, several, or all depending on the task. |
| 56 | |
| 57 | ## Usage |
| 58 | |
| 59 | Three ways in: |
| 60 | |
| 61 | 1. **Automatic delegation** — with the plugin installed, Claude Code registers the agent and can delegate matching work to it on its own (the agent's `description` frontmatter drives this). |
| 62 | 2. **`/studio` routing** — describe your task; the dispatcher classifies it and hands off to the right agent. |
| 63 | 3. **Direct** — name the agent in your request ("have the ffe-designer clean this schedule up"). |