Designing Architecture
This skill generates architectural designs based on your prompts, offering a quick and creative starting point for projects.
Install on your platform
We auto-selected Claude Code based on this skill’s supported platforms.
Run in terminal (recommended)
claude mcp add designing-architecture npx -- -y @trustedskills/designing-architecture
Or manually add to ~/.claude/settings.json
{
"mcpServers": {
"designing-architecture": {
"command": "npx",
"args": [
"-y",
"@trustedskills/designing-architecture"
]
}
}
}Requires Claude Code (claude CLI). Run claude --version to verify your install.
About This Skill
What it does
This skill helps AI agents generate architectural designs for software projects. It provides a starting point by suggesting appropriate architecture patterns and directory structures based on project size, team capabilities, and other factors. The tool guides through a structured design process, including understanding requirements, assessing project scope, selecting patterns, defining structure, documenting decisions, and validating against established frameworks.
When to use it
This skill is useful in the following scenarios:
- Starting a new software project requiring architectural planning.
- Designing module structures for existing projects.
- Choosing appropriate architecture patterns (e.g., MVC/Layered, Clean Architecture, Microservices).
- Defining directory structures for codebases.
- When needing guidance on trade-offs and decision making in architectural design.
Key capabilities
- Suggests architecture patterns based on project size (Small, Medium, Large) and team size (1-3 developers, 4-10 developers, 10+ developers).
- Provides examples of common architectural patterns: Layered Architecture, Clean Architecture, Hexagonal Architecture (Ports & Adapters), Event-Driven Architecture, and CQRS.
- Offers a recommended feature-based directory structure pattern for medium to large projects.
- Includes a checklist to guide the architecture design workflow.
Example prompts
- "Suggest an architecture pattern for a small project with a team of 2 developers."
- "What's a good directory structure for a medium-sized application?"
- "Explain the benefits and drawbacks of Clean Architecture compared to Layered Architecture."
- “I need to design a system that needs to swap external dependencies easily. What architecture pattern should I consider?”
Tips & gotchas
- The skill is intended as a starting point, not a complete solution. Further refinement and customization will likely be needed.
- Consider the trade-offs associated with each suggested pattern before implementation.
- Project size is defined by lines of code (<10K LOC, 10K-100K LOC, >100K LOC).
Tags
TrustedSkills Verification
Unlike other registries that point to live repositories, TrustedSkills pins every skill to a verified commit hash. This protects you from malicious updates — what you install today is exactly what was reviewed and verified.
Security Audits
| Gen Agent Trust Hub | Pass |
| Socket | Pass |
| Snyk | Pass |
🌐 Community
Passed automated security scans.