architecture – Coding skill for AI agents
Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design.
Install the architecture skill with one command
Pick the tool you use, copy the command and paste it in your terminal. The skill lands in that tool's skills folder and is ready in your next session.
Claude Code
mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/architecture-85e75.tgz | tar xz -C ~/.claude/skills
Call it in Claude Code: /architecture – then describe the task you want done.
Codex
mkdir -p ~/.codex/skills && curl -fsSL https://skill.dn1nguoi.com/z/architecture-85e75.tgz | tar xz -C ~/.codex/skills
Call it in Codex: $architecture – then describe the task you want done.
Hermes Agent
mkdir -p ~/.hermes/skills && curl -fsSL https://skill.dn1nguoi.com/z/architecture-85e75.tgz | tar xz -C ~/.hermes/skills
Call it in Hermes Agent: /architecture – then describe the task you want done.
DeepSeek
mkdir -p ~/.deepcode/skills && curl -fsSL https://skill.dn1nguoi.com/z/architecture-85e75.tgz | tar xz -C ~/.deepcode/skills
Call it in DeepSeek: /architecture – then describe the task you want done.
SKILL.md content
Architecture Decision Framework
> "Requirements drive architecture. Trade-offs inform decisions. ADRs capture rationale."
🎯 Selective Reading Rule
Read ONLY files relevant to the request! Check the content map, find what you need.
| File | Description | When to Read |
|------|-------------|--------------|
| context-discovery.md | Questions to ask, project classification | Starting architecture design |
| trade-off-analysis.md | ADR templates, trade-off framework | Documenting decisions |
| pattern-selection.md | Decision trees, anti-patterns | Choosing patterns |
| examples.md | MVP, SaaS, Enterprise examples | Reference implementations |
| patterns-reference.md | Quick lookup for patterns | Pattern comparison |
---
🔗 Related Skills
| Skill | Use For |
|-------|---------|
| @[skills/database-design] | Database schema design |
| @[skills/api-patterns] | API design patterns |
| @[skills/deployment-procedures] | Deployment architecture |
---
Core Principle
"Simplicity is the ultimate sophistication."
- Start simple
- Add complexity ONLY when proven necessary
- You can always add patterns later
- Removing complexity is MUCH harder than adding it
---
Validation Checklist
Before finalizing architecture:
- [ ] Requirements clearly understood
- [ ] Constraints identified
- [ ] Each decision has trade-off analysis
- [ ] Simpler alternatives considered
- [ ] ADRs written for significant decisions
- [ ] Team expertise matches chosen patterns
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
Related skills
- architecture-decision-records – Comprehensive patterns for creating, maintaining, and managing Architecture Decision…
- architecture-patterns – Master proven backend architecture patterns including Clean Architecture, Hexagonal…
- architecture-review – Review repository architecture using Ontoly Software Graph and MCP capabilities. Use…
- fastapi-templates – Create production-ready FastAPI projects with async patterns, dependency injection, and…
- chief-ai-officer-advisor – Chief AI Officer advisory for startups: model build-vs-buy decisions (API vs fine-tune…
- chief-ai-officer-advisor – Chief AI Officer advisory for startups: model build-vs-buy decisions (API vs fine-tune…
- ask-copilot – Use GitHub Copilot CLI in non-interactive mode to ask questions, review code, or…
- ask-human-expert – Ask real executives and domain experts a question through Instant Expert for a written…