agentic_architecture
π―Skillfrom cityfish91159/maihouses
Enforces architectural best practices by guiding developers to think systematically about data flow, component boundaries, and scalability before writing code.
Installation
npx skills add https://github.com/cityfish91159/maihouses --skill agentic_architectureSkill Details
Enforces high-level architectural thinking, separation of concerns, and scalability checks before coding.
Overview
# Agentic Architecture Protocol
1. Think Before You Code
Before implementing any feature that spans multiple files:
- Analyze Data Flow: Where does data come from? Where does it go?
- Define Interfaces: creating
types/*.tsis often the best first step. - Check Boundaries: Ensure API logic stays in
api/, UI incomponents/, and business logic inservices/orhooks/.
2. Scalability & Performance Checks
- Database:
- Are we fetching 1000 items to filter 10? (Use DB filters instead).
- Is RLS (Row Level Security) compatible with this query?
- Frontend:
- Are we causing unnecessary re-renders? (Use React.memo, useCallback appropriately).
- Is this component becoming a "God Component"? (Break it down).
3. The "Three-Tier" Rule
For any non-trivial feature, verify you have these three layers:
- Data Layer: Types + API/Service (e.g.,
user.types.ts,userService.ts) - State Layer: Hook or Store (e.g.,
useUser.ts) - View Layer: Components (e.g.,
UserProfile.tsx)
4. Architecture Checklist
- [ ] Have I defined the types first?
- [ ] Is the business logic separated from the UI?
- [ ] Did I consider how this scales to 10,000 users/items?
- [ ] Is the database schema validated (if changing DB)?
More from this repository10
Enforces comprehensive testing by mandating tests for every code change, bug fix, and new feature implementation.
read-before-edit skill from cityfish91159/maihouses
Maintains a persistent memory file to track project context, architecture, issues, and operational rules across AI agent sessions.
pre-commit-validator skill from cityfish91159/maihouses
Enforces NASA-inspired safety rules for TypeScript, ensuring strict type safety, minimal complexity, and robust error handling.
Enforces rigorous test-driven development by guiding developers through systematic test creation, implementation, and continuous verification across happy, sad, and edge case scenarios.
Logs and tracks critical actions with comprehensive user, action, and resource metadata for enhanced traceability and security.
skill-marketplace skill from cityfish91159/maihouses
Enforces strict Row Level Security (RLS) policies in Supabase, mandating default-deny access and comprehensive security checks.
Validates and sanitizes backend API inputs, preventing injection attacks and ensuring robust data integrity across server-side endpoints