architecture-maplisted
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