majiayu000/claude-arsenal
xiaohongshu
xiaohongshu
286 148
View 
Architect Agent Workflow Skill
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".
SKILL.md
Full skill instructions
Architect Agent Workflow Skill
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.
Table of Contents
- Intent Classification
- Decision Tree
- Resource Loading Policy
- Critical Protocol: File Locations
- Quick Setup
- DO NOT Trigger For
- Reference Directory
- Guides Directory
Intent Classification
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 |
Decision Tree
| 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 |
Resource Loading Policy
Load ONLY when needed:
- Workflow guides: When intent is classified
- Reference docs: When user needs detailed protocol
- Templates: When creating workspace or files
- Never load all references "just in case"
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 |
Critical Protocol: File Locations
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.
Quick Setup (Template-Based)
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
DO NOT Trigger For
- General architecture discussions
- Brainstorming or exploration
- Reading/analyzing existing code
- Research tasks
- Any work that isn't explicit instruction creation, grading, or setup
Reference Directory
All detailed protocols are in references/. Load only what is needed for the current task.
Core References (Instruction & Grading)
| 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 |
Setup & Configuration
| 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 |
Logging & Debugging
| 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 |
OpenCode Integration
| 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 |
Agent Configuration
| 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 |
Project Management
| Reference | Purpose |
|---|---|
git_pr_management.md | Git and PR workflow |
ticket_tracking_pr_management.md | Ticket and PR tracking |
Guides Directory
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" |
Templates
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.
More skills from majiayu000
majiayu000/claude-arsenal
technical-spec
technical spec
286 141
View majiayu000/claude-arsenal
product-ux-expert
product ux expert
286 133
View majiayu000/claude-arsenal
database-patterns
database patterns
286 119
View majiayu000/claude-skill-registry
agent-task-conductor
Conduct multi-agent task orchestration and workflow coordination.
663 1
View majiayu000/claude-skill-registry
conductor-setup
Initialize project with Conductor artifacts (product definition,
663 1
View majiayu000/claude-skill-registry
animation-designer
Expert in web animations, transitions, and motion design using Framer Motion and CSS
663 1
View majiayu000/claude-skill-registry
diagramming
Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...
663 1
View majiayu000/claude-skill-registry-data
h3-pg
PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.
23 1
View majiayu000/claude-skill-registry
conductor-development
Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...
663 1
View majiayu000/claude-skill-registry
conductor-status
Display project status, active tracks, and next actions
663 1
View majiayu000/claude-skill-registry
dockerization
Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.
663 1
View Popular AI tools
Video
Kaiber
Generate, edit, and beat-sync AI video with leading models in one workspace.
Paid
View Productivity
Vimcal
The world's fastest calendar for remote work
Free
View I
Images
IMGCreator.ai
Transform Your Design with AI Designer by ImgCreator.ai
Freemium
View Content & writing
Akool AI
Revolutionizing Video Production with AI-Powered Creativity
Paid
View Images
Clipdrop Uncrop
Extend an image past the frame and let AI fill the new aspect ratio.
Freemium
View Security
StarByFace
Discover your celebrity doppelgänger with StarByFace!
Free
View C
Finance
ChainClarity
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Freemium
View Coding & apps
Opus Clip
Opus.ai: Revolutionize Your Web Experience
Free
View