File contents Context Discovery
Before suggesting any architecture, gather context.
Question Hierarchy (Ask User FIRST)
Scale
How many users? (10, 1K, 100K, 1M+)
Data volume? (MB, GB, TB)
Transaction rate? (per second/minute)
Team
Solo developer or team?
Team size and expertise?
Distributed or co-located?
Timeline
MVP/Prototype or long-term product?
Time to market pressure?
Domain
CRUD-heavy or business logic complex?
Real-time requirements?
Compliance/regulations?
Constraints
Budget limitations?
Legacy systems to integrate?
Technology stack preferences?
Project Classification Matrix
MVP SaaS Enterprise
┌─────────────────────────────────────────────────────────────┐
│ Scale │ <1K │ 1K-100K │ 100K+ │
│ Team │ Solo │ 2-10 │ 10+ │
│ Timeline │ Fast (weeks) │ Medium (months)│ Long (years)│
│ Architecture │ Simple │ Modular │ Distributed │
│ Patterns │ Minimal │ Selective │ Comprehensive│
│ Example │ Next.js API │ NestJS │ Microservices│
└─────────────────────────────────────────────────────────────┘
1 --- 2 name: architecture 3 description: Context Discovery 4 --- 5 # Context Discovery 6 7 > Before suggesting any architecture, gather context. 8 9 ## Question Hierarchy (Ask User FIRST) 10 11 1. **Scale** 12 - How many users? (10, 1K, 100K, 1M+) 13 - Data volume? (MB, GB, TB) 14 - Transaction rate? (per second/minute) 15 16 2. **Team** 17 - Solo developer or team? 18 - Team size and expertise? 19 - Distributed or co-located? 20 21 3. **Timeline** 22 - MVP/Prototype or long-term product? 23 - Time to market pressure? 24 25 4. **Domain** 26 - CRUD-heavy or business logic complex? 27 - Real-time requirements? 28 - Compliance/regulations? 29 30 5. **Constraints** 31 - Budget limitations? 32 - Legacy systems to integrate? 33 - Technology stack preferences? 34 35 ## Project Classification Matrix 36 37 ``` 38 MVP SaaS Enterprise 39 ┌─────────────────────────────────────────────────────────────┐ 40 │ Scale │ <1K │ 1K-100K │ 100K+ │ 41 │ Team │ Solo │ 2-10 │ 10+ │ 42 │ Timeline │ Fast (weeks) │ Medium (months)│ Long (years)│ 43 │ Architecture │ Simple │ Modular │ Distributed │ 44 │ Patterns │ Minimal │ Selective │ Comprehensive│ 45 │ Example │ Next.js API │ NestJS │ Microservices│ 46 └─────────────────────────────────────────────────────────────┘ 47 ```
commit cf4757a727
Frequently asked questions How do I install the Architecture skill? Run npx skillmds@latest add jorcan/architecture in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Architecture skill do? Context Discovery It is listed under Product & Planning on SkillMD.
Is Architecture safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Architecture? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Architecture free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Architecture? jorcan (@jorcan) published this skill. Their other Agent Skills are listed on their SkillMD profile.
jorcan