Scope Appropriate Architecture
This is the architectural guardrail you need when you're about to add hexagonal architecture to a weekend hackathon project. It classifies projects into six tiers (interview, hackathon, MVP, growth, enterprise, open source) by scanning for signals like README mentions of "take-home", presence of CI configs, or Kubernetes files, then constrains pattern choices to match. The pattern matrix is blunt: repository pattern shows "OVERKILL" for tier 1-2, microservices show "NEVER" for tier 1-3. It's invoked automatically by brainstorm and implement skills during context discovery to right-size decisions before you waste time building OAuth2 for a coding assignment. The LOC ratio column (infrastructure code divided by business logic) is a nice reality check on whether your 200-line feature really needs 600 lines of abstraction.
- skills.sh installs
- 179
- GitHub stars
- 301
- last updated
- Aug 21, 2026
Install
$ npx -y skills add yonatangross/orchestkit --skill scope-appropriate-architecture --agent claude-codeInstalls into .claude/skills of the current project.
Files
Scope-Appropriate Architecture
Right-size every architectural decision to the project's actual needs. Not every project needs hexagonal architecture, CQRS, or microservices.
Core principle: Detect the project tier first, then constrain all downstream pattern choices to that tier's complexity ceiling.
The 6 Project Tiers
| Tier | LOC Ratio | Architecture | DB | Auth | Tests |
|---|---|---|---|---|---|
| 1. Interview/Take-home | 1.0-1.3x | Flat files, no layers | SQLite / JSON | None or basic | 8-15 focused |
| 2. Hackathon/Prototype | 0.8-1.0x | Single file if possible | SQLite / in-memory | None | Zero |
| 3. Startup/MVP | 1.0-1.5x | MVC monolith | Managed Postgres | Clerk/Supabase Auth | Happy path + critical |
| 4. Growth-stage | 1.5-2.0x | Modular monolith | Postgres + Redis | Auth service | Unit + integration |
| 5. Enterprise | 2.0-3.0x | Hexagonal/DDD | Postgres + queues | OAuth2/SAML | Full pyramid |
| 6. Open Source | 1.2-1.8x | Minimal API surface | Configurable | Optional | Exhaustive public API |
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/yonatangross/orchestkit
- Category
- Code Review & Quality
- First seen
- Jun 3, 2026
More from yonatangross/orchestkit
All 61- Testing Patterns179
- Help166
- Checkpoint Resume156
- Dashboard Patterns124
- Devops Deployment1.6K
- Responsive Patterns1.6K
- Architecture Decision Record1.5K
- Ui Components1.5K
- Rag Retrieval1.5K
- Zustand Patterns1.5K
- Agent Orchestration1.4K
- Domain Driven Design1.3K
- Memory755
- Security Patterns738
- Langgraph371
- Write Prd336
- Distributed Systems293
- Ascii Visualizer283
- Monitoring Observability269
- Vite Advanced265
- Quality Gates259
- Code Review Playbook254
- Python Backend249
- Accessibility245
Recommended
More Code Review & Quality
review-a-skillmoizibnyousaf/ai-agent-skillsThis is quality control for your skill library.177skills.sh installs
codex-review-workflowdaffy0208/ai-dev-standardsAutomated code review workflow using OpenAI Codex CLI. Implements iterative fix-and-review cycles until code passes validation or reaches iteration limit. Use w166skills.sh installs
pr-reviewproffesor-for-testing/agentic-qeUse when reviewing a GitHub PR for quality, scope correctness, trust tier compliance, or generating user-friendly review feedback.152skills.sh installs
aws-solution-architectborghei/claude-skillsDesign AWS serverless architectures for startups with IaC. Use when designing serverless architecture, writing CloudFormation, optimizing AWS costs, setting up 148skills.sh installs
pr-writing-reviewevalstate/fast-agentExtract and analyze writing improvements from GitHub PR review comments. Use when asked to show review feedback, style changes, or editorial improvements from a0skills.sh installs
aws-well-architected-reviewgithub/awesome-copilotPerform an AWS Well-Architected Framework review of the current workload IaC and architecture, generating findings and GitHub issues for improvements.0skills.sh installs