architect-agent
Coordinates planning, delegation, and evaluation across architect and code agent workspaces. Use when asked to "write instructions for code agent", "initialize architect workspace", "grade code agent work", "send instructions", or "verify code agent setup".
Full skill instructions
Coordinate planning, delegation, and evaluation across architect and code agent workspaces.
Quick Start: Say "write instructions for code agent", "initialize workspace", "grade work", or "send instructions". For automated setup, see Quick Setup.
Route requests based on user intent:
| Intent | Trigger Phrases | Action |
|---|---|---|
| Create Instructions | "write instructions", "create instructions", "delegate to code agent" | → Load guides/workflows/create-instructions.md |
| Initialize Workspace | "set up architect agent", "initialize workspace", "new architect agent" | → Load guides/workflows/initialize-workspace.md |
| Grade Work | "grade the work", "evaluate completed work", "review implementation" | → Load guides/workflows/grade-work.md |
| Send Instructions | "send instructions", "send to code agent" | → Load guides/workflows/send-instructions.md |
| Add OpenCode Support | "migrate to OpenCode", "add OpenCode support" | → Load references/opencode_integration_quickstart.md |
| Verify Setup | "verify setup", "test hooks", "check logging" | → Load references/workspace_verification_protocol.md |
| Setup Permissions | "set up permissions", "fix permission prompts" | → Load references/permissions_setup_protocol.md |
| Upgrade Workspace | "upgrade workspace", "migrate to v3.0" | → Load references/upgrade.md |
| User Intent | Pre-condition | Action |
|---|---|---|
| "write/create instructions", "delegate" | instructions/ exists | Load guides/workflows/create-instructions.md |
| "write/create instructions", "delegate" | instructions/ missing | Suggest workspace initialization first |
| "set up/initialize" workspace | Directories don't exist | Load guides/workflows/initialize-workspace.md |
| "set up/initialize" workspace | Directories exist | Warn: already initialized |
| "grade", "evaluate" work | grades/ exists | Load guides/workflows/grade-work.md |
| "grade", "evaluate" work | grades/ missing | Suggest workspace initialization first |
| "send instructions" | — | Load guides/workflows/send-instructions.md (bash copy, no agents) |
| "verify", "test hooks" | — | Load references/workspace_verification_protocol.md |
| "OpenCode", "dual-mode" | — | Load references/opencode_integration_quickstart.md |
| "permissions" | — | Load references/permissions_setup_protocol.md |
| "upgrade", "migrate" | — | Load references/upgrade.md |
Load ONLY when needed:
Core Resources by Intent:
| Intent | Primary Resource | Supporting Resources |
|---|---|---|
| Create Instructions | guides/workflows/create-instructions.md | references/instruction_structure.md, references/human_instruction_structure.md, references/file_naming.md |
| Initialize Workspace | guides/workflows/initialize-workspace.md | references/workspace_setup_complete.md |
| Grade Work | guides/workflows/grade-work.md | references/grading_rubrics.md, references/decision_types.md |
| Send Instructions | guides/workflows/send-instructions.md | (none - simple bash copy) |
| Verify Setup | references/workspace_verification_protocol.md | references/pre_work_checklist.md |
| Setup Permissions | references/permissions_setup_protocol.md | - |
| OpenCode Support | references/opencode_integration_quickstart.md | references/opencode_setup_guide.md |
The architect agent operates in its own workspace, NOT the code agent workspace.
| Artifact | Architect Writes To | Code Agent Location |
|---|---|---|
| Instructions | [ARCHITECT]/instructions/ | Reads from debugging/instructions/ |
| Human Instructions | [ARCHITECT]/human/ | N/A (for manual execution) |
| Grades | [ARCHITECT]/grades/ | N/A |
| Logs | N/A | Writes to [CODE_AGENT]/debugging/logs/ |
Human Instructions = Executable Documentation (not summaries!)
Human instructions must enable manual execution when code agents are unavailable. Include copy-pasteable commands, expected output, and troubleshooting. See references/human_instruction_structure.md.
Guard Rail: If about to write to the code agent's workspace, stop and verify the operation.
For fastest setup, use templates:
cd ~/.claude/skills/architect-agent/templates/
# Create code agent workspace
./setup-workspace.sh code-agent ~/projects/my-code-agent
# Create architect workspace
./setup-workspace.sh architect ~/projects/my-architect \
--code-agent-path ~/projects/my-code-agent
Time: <5 minutes
See: templates/README.md
All detailed protocols are in references/. Load only what is needed for the current task.
| Reference | Purpose |
|---|---|
instruction_structure.md | Code agent instruction template |
human_instruction_structure.md | Human-executable instruction template |
grading_rubrics.md | 6-category grading criteria |
instruction_grading_workflow.md | Full grading workflow |
decision_types.md | decision, rationale, investigation, verification, deviation, milestone |
file_naming.md | Timestamp and naming conventions |
| Reference | Purpose |
|---|---|
installation.md | Skill installation guide |
quick_start.md | Fast-track setup |
workspace_setup_complete.md | Full workspace initialization |
workspace_verification_protocol.md | Verify setup is correct |
permissions_setup_protocol.md | Cross-workspace permissions |
upgrade.md | Upgrade to latest version |
| Reference | Purpose |
|---|---|
logging_protocol.md | Hybrid logging v2.0 |
hybrid_logging_protocol.md | Detailed hybrid logging spec |
hook_configuration_critical.md | Hook setup requirements |
hook_logger_enhancements.md | Hook logger improvements |
pre_work_checklist.md | Code agent pre-work verification |
get_unstuck_protocol.md | Recovery from blockers |
resilience_protocol.md | Error recovery patterns |
testing_protocol.md | Progressive testing requirements |
| Reference | Purpose |
|---|---|
opencode_integration_quickstart.md | Dual-mode quick start |
opencode_setup_guide.md | Full OpenCode setup |
opencode_migration_guide.md | Migrate to OpenCode |
opencode_logging_protocol.md | OpenCode-specific logging |
opencode_wrapper_setup.md | Wrapper script setup |
claude_vs_opencode_comparison.md | Feature comparison |
| Reference | Purpose |
|---|---|
agent_specialization.md | Agent role configuration |
code_agent_claude_template.md | CLAUDE.md template for code agents |
code_agent_agents_template.md | AGENTS.md template for code agents |
| Reference | Purpose |
|---|---|
git_pr_management.md | Git and PR workflow |
ticket_tracking_pr_management.md | Ticket and PR tracking |
Step-by-step workflows in guides/workflows/:
| Guide | Trigger |
|---|---|
create-instructions.md | "write instructions for code agent" |
grade-work.md | "grade the code agent's work" |
send-instructions.md | "send instructions to code agent" |
initialize-workspace.md | "set up architect agent workspace" |
Ready-to-use workspace templates in templates/:
| Template | Purpose |
|---|---|
setup-workspace.sh | Automated workspace creation script |
architect-workspace/ | Complete architect agent workspace template |
code-agent-workspace/ | Complete code agent workspace template |
See: templates/README.md for usage instructions.
Accessibility guidelines for VS Code features — covers accessibility help dialogs, accessible views, verbosity settings, accessibility signals, ARIA alerts/status announcements, keyboard navigation, and ARIA labels/roles. Applies to both new interactive UI surfaces and updates to existing feature...
Mermaid diagram creation for flowcharts, sequences, ERDs, and more. Generate diagrams from text in markdown files. Use for documentation, architecture diagrams, and visual representations. Triggers on mermaid, flowchart, sequence diagram, ERD, entity relationship, gantt chart, pie chart, class di...
Guides development of cross-platform desktop apps with Tauri 2, TypeScript, React, and Rust. Use when building Tauri apps, implementing IPC, designing Rust backend or TypeScript/React frontend, when researching or cloning a website (open site, snapshot elements), when verifying local dev or built...
Handle errors as values using fp-ts Either and TaskEither for cleaner, more predictable TypeScript code. Use when implementing error handling patterns with fp-ts.
Gate 0 research phase for pre-dev workflow. Dispatches 3 parallel research agents to gather codebase patterns, external best practices, and framework documentation BEFORE creating PRD/TRD. Outputs research.md with file:line references.
Create and configure Vapi voice AI assistants with models, voices, transcribers, tools, hooks, and advanced settings. Use when building voice agents, phone bots, customer support assistants, or any conversational AI that handles phone or web calls.
Use when working with full stack orchestration full stack feature
Delegiere Aufgaben an OpenAI Codex CLI im Headless-Mode. Nutzt ChatGPT Subscription (KEIN API Key). Nur Workspace-Zugriff, KEIN System-Zugriff. Auto-Accept mit --full-auto. Web-Recherche mit --search.
Generate a full week of social media content for any topic. Outputs platform-optimized posts for Twitter/X, LinkedIn, and Instagram with hashtags and posting times.
Data privacy and regulatory compliance specialist for GDPR, CCPA, HIPAA, and international data protection laws. Use when implementing privacy controls, conducting data protection impact assessments, ensuring regulatory compliance, or managing data subject rights. Expert in consent management, da...
Reviews a task using the TRIPLE protocol, as the review agent.
Define and document the technology stack and architecture decisions for a project. Use when the user needs to choose a tech stack, make architecture decisions, define infrastructure choices, or document technology selections. Triggers on requests like "define the tech stack", "choose technologies...
Generate, edit, and beat-sync AI video with leading models in one workspace.
The world's fastest calendar for remote work
Transform Your Design with AI Designer by ImgCreator.ai
Revolutionizing Video Production with AI-Powered Creativity
Extend an image past the frame and let AI fill the new aspect ratio.
Discover your celebrity doppelgänger with StarByFace!
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Opus.ai: Revolutionize Your Web Experience