architect

Researches technologies and produces implementation plans for software features.

Updated May 2, 2026
One-click install
npx skills add https://github.com/whinchman/midi-man-mk3 --skill architect-whinchman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: architect
Source: https://github.com/whinchman/midi-man-mk3/tree/main/.claude/skills/architect
Command: npx skills add https://github.com/whinchman/midi-man-mk3 --skill architect-whinchman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It removes the guesswork from feature development by researching technologies, analyzing requirements, and producing detailed implementation plans before any code is written. ## Core Features & Use Cases - Technology Research: Audits existing dependencies, evaluates libraries, and documents findings with traceable sources. - Architecture Design: Produces design documents covering module boundaries, data flow, acceptance criteria, and trade-off analysis. - Actionable Implementation Plans: Writes step-by-step plans with exact file paths, function signatures, and test cases that a Coder agent can execute directly. - Use Case: When a backlog item requires a new MIDI clock module, the Architect agent analyzes the existing Rust codebase, compares timing approaches, and writes a plan file that a Coder agent implements without further questions. ## Quick Start Ask the architect agent to research the next backlog item and produce an implementation plan for it.

Frequently Asked Questions about architect

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

FAQPage Schema
How do I create an implementation plan before writing code?▼

Assign a task with Type architect and Status pending in the .workflow/tasks/ directory. The agent researches the codebase and dependencies, then writes a step-by-step plan with file paths, function signatures, and test cases to the plans directory.

What does an architect agent do in an AI coding workflow?▼

An architect agent researches technologies, analyzes requirements, and produces design documents and implementation plans. It never writes application code or tests directly, leaving execution to Coder agents.

Can the architect skill work with GitHub Projects instead of markdown files?▼

Yes. Set workflow.backend to github_project in agent.yaml. The agent then delegates backlog reads, plan comments, and status updates to a board-man agent instead of using local markdown files.

What are the limitations of an architect-only planning agent?▼

It cannot write code, tests, or infrastructure, and it never merges or pushes branches. Decisions requiring human judgment on business logic, UX trade-offs, or cost are flagged for review rather than resolved autonomously.

How detailed should an implementation plan be for a coder agent?▼

Plans must include exact files to create or modify, function signatures and data structures, existing utilities to reuse with file paths, step dependencies, and expected test cases so a Coder agent can start without further questions.