Menu
Use this skill to synthesize complex requirements into technical PRDs and architectural blueprints.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | project-architect |
| description | Use this skill to synthesize complex requirements into technical PRDs and architectural blueprints. |
Your role is to design the system architecture using the MVC (Minimum Viable Complexity) principle.
Before generating an architectural blueprint, you MUST read .orion/CONTEXT.md to understand the product context.
Your output MUST contain these 6 sections exactly, and be saved to .orion/BLUEPRINT.md:
## 1. System Components
- Frontend: [e.g., Flutter Web]
- Backend: [e.g., Supabase Edge Functions]
- Database: [e.g., Postgres]
## 2. Data Flow
- [Describe the path of data from user input to database storage]
## 3. Database Schema (Draft)
- Table 1: `users` (id, email, created_at)
- Table 2: `[custom_table]` (...)
## 4. Third-Party Integrations
- [List specific APIs, e.g., Stripe, Sendgrid. Provide alternative if budget is $0]
## 5. Security & Auth
- [Describe how users authenticate and what data they can access]
## 6. The "Cut" List
- [List 3 features the user asked for that should be DELAYED to v2 to launch faster]
If you do not provide "The Cut List", you have failed your role as Architect.
When designing a data model, use this tree:
Q1. Does the data have strict relational integrity? (YES -> Postgres Relational Tables, NO -> Q2)
Q2. Is the data highly unstructured or document-like? (YES -> Postgres jsonb columns, NO -> Relational Tables)
NEVER create a table in Supabase without applying RLS.
ALTER TABLE public.posts ENABLE ROW LEVEL SECURITY.md);
CREATE POLICY "Public profiles are viewable by everyone." ON public.posts FOR SELECT USING ( is_public = true OR auth.uid() = user_id );
CREATE POLICY "Users can insert their own posts." ON public.posts FOR INSERT WITH CHECK ( auth.uid() = user_id );
If your current task intersects with these domains, you MUST execute view_file on the target BEFORE writing code:
| If User Prompt/Task Relates To... | Immediately Load (view_file) |
|---|---|
| Architectural Standards | references/[[architectural_standards]]) |
| Startup Growth | references/[[startup_growth]]) |
| Strategic Rigor | references/[[strategic_rigor]]) |
| Structural Pillars | references/[[structural_pillars]]) |
| Backend Architect | references/backend-architect.md |
| Backend Optimizer | references/backend-optimizer.md |
| Cache Optimizer | references/cache-optimizer.md |
| Db Expert | references/db-expert.md |
| Enterprise Patterns | references/enterprise_patterns.md |
| Node Performance Tuning | references/node_performance_tuning.md |
| Postgres Patterns | references/postgres_patterns.md |
Employ this skill to define strict request/response data contracts and safety layers (OpenAPI, Zod).
Brain Graph, Knowledge Base, Ingest, Lint, Cross-reference
Compress natural language memory files (CLAUDE.md, todos, preferences) into caveman format to save input tokens. Preserves all technical substance, code, URLs, and structure. Compressed version overwrites the original file. Human-readable backup saved as FILE.original.md. Trigger: /caveman-compress FILEPATH or "compress memory file"
Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman while keeping full technical accuracy. Supports intensity levels: lite, full (default), ultra, wenyan-lite, wenyan-full, wenyan-ultra. Use when user says "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", or invokes /caveman. Also auto-triggers when token efficiency is requested.
Reduces cloud and LLM infrastructure costs through token-clipping and tiered service routing.
Employ this skill to design immutable data models, DTOs, and complex transformation pipelines. It ensures data integrity by enforcing immutability by default. Proactively recommend this when the user is drafting new data structures or state management logic.