A professional-grade planning protocol that guides AI agents through requirements analysis, architecture design, and actionable task mapping.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install shadows-project-architect
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install shadows-project-architect using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Project Architect?
Project Architect is a specialized reasoning protocol within the ecosystem of Openclaw Skills designed to bridge the gap between abstract ideas and executable code. It provides a structured five-phase framework that ensures no critical requirement is missed and no architectural decision is left undocumented. By enforcing a disciplined approach to system design, it helps developers avoid over-engineering while maintaining a clear vision of the project's critical path.
This skill is particularly valuable for teams and individual developers who need to transition from high-level concepts to granular, implementable tasks. It transforms the AI agent into a senior technical lead, capable of generating comprehensive project plans, identifying dependencies, and establishing demo-driven milestones that ensure steady progress and validation throughout the development lifecycle.
Project Architect Use Cases
- Launching a new software project from scratch with a solid architectural foundation.
- Designing complex major features or new modules for existing production systems.
- Facilitating large-scale refactoring efforts or migrating monoliths to microservices.
- Converting vague stakeholder requests into structured technical documentation and task lists.
How Project Architect Works
- The protocol initiates a targeted requirements capture phase using five core questions to define functionality, users, scale, and constraints.
- It develops a detailed system architecture including component diagrams and Architecture Decision Records (ADRs) to document technical rationale.
- The skill generates a granular task breakdown where each item is estimated to take 1-4 hours and includes explicit dependency mapping.
- It identifies the project's critical path by visualizing task relationships as a directed graph to highlight parallelizable work streams.
- Finally, it defines 3-5 clear milestones with specific demo criteria to ensure the project remains on track and testable.
Project Architect Setup
Project Architect is a pure reasoning skill and does not require external binaries or complex installations. It is designed to be natively compatible with environments supporting Openclaw Skills.
# No binary installation needed
# Use by invoking the architect command or planning intent
Project Architect Data Schema & Taxonomy
The skill produces a structured Markdown project plan following a strict taxonomy to ensure consistency across different projects.
| Component | Description |
|---|---|
| Requirements Summary | A synthesis of functionality, personas, and tech constraints. |
| Architecture Design | System diagrams, component interfaces, and ADRs. |
| Task Breakdown | Epics and tasks with effort estimates and dependencies. |
| Critical Path | Analysis of the longest dependency chain and parallel tasks. |
| Milestones | A timeline of 3-5 phases with specific demo requirements. |
| Risk Registry | A table mapping probability and impact for potential blockers. |
Project Architect Advanced Features
- Architecture Decision Records (ADRs) support for long-term maintenance and technical context tracking.
- Automated critical path identification to optimize team resource allocation.
- Demo-driven milestone definitions that prioritize functional validation over mere task completion.
- Explicit dependency chaining for every task to prevent bottlenecks during implementation.
SKILL.md
Loading
Related Openclaw Skills
Oneshot Fix (Surgical Quick Fix)
A high-speed, surgical repair protocol for AI agents to fix small bugs and typos with minimal tool interaction.
MCP Forge
A specialized tool for building Model Context Protocol (MCP) servers in Python or TypeScript to connect external services with AI agents.
Doc Forge
Doc Forge is an intelligent documentation engine that analyzes source code to generate professional READMEs, API references, and architectural overviews.
Deploy Guardian
An automated 6-gate verification system designed to validate code health and security before any production or staging deployment.
Python Sensei
A specialized AI coding assistant that enforces strict Python engineering standards, including type safety, async patterns, and modular architecture.
Security Scanner
A professional 7-phase security auditing pipeline that identifies vulnerabilities, scans dependencies, and detects leaked secrets.
Featured*
