← ClaudeAtlas

architecture-maplisted

Generate or update PROJECT_ARCHITECTURE.md - a comprehensive architectural map for AI context. Use this skill when asked to "map the architecture", "document the project structure", "onboard a new AI", "analyze the codebase", "create context for AI", or any time you need to understand a codebase's architecture. This skill is essential for new project onboarding and should trigger automatically when starting work on unfamiliar projects.
arielsand/my-opencode-skills · ★ 0 · Data & Documents · score 70
Install: claude install-skill arielsand/my-opencode-skills
# Architecture Map Generator Generate a comprehensive architectural map that helps AI agents (and humans) quickly understand a codebase. ## Output Create `PROJECT_ARCHITECTURE.md` in the project root using the write tool. This file should be committed to version control. ## Process Follow these phases in order: ### 1. Discovery Read configuration files to understand the stack: - `package.json`, `composer.json`, `pyproject.toml`, `Cargo.toml`, `go.mod` - `app.json`, `expo.json` for mobile apps - `.env.example` for environment hints - Entry points: `app/_layout.tsx`, `index.ts`, `main.py`, `src/main.rs` **Look for:** - Project type (mobile/web/backend/fullstack) - Core frameworks and versions - Key dependencies and their purpose - Database/ORM used - Testing framework ### 2. Structure Analysis Map the directory structure and identify: - Where business logic lives - How routes/navigation are organized - State management patterns - API/service layer organization - Data models and schemas ### 3. Pattern Recognition Identify conventions used: - Naming patterns (files, variables, functions) - Code organization style - Authentication/authorization flow - Error handling patterns - Testing strategies ### 4. Document Generation Using all gathered information, write `PROJECT_ARCHITECTURE.md` with these sections: --- ## Document Structure The output file MUST include these sections: ### 1. Project Essence A 3-5 sentence summary answering: - What business problem does th