mirror of https://github.com/interlegis/sapl.git
rangelbruno
10 months ago
103 changed files with 457 additions and 312 deletions
@ -0,0 +1,119 @@ |
|||
# Skill: Mapear Estrutura do Projeto |
|||
|
|||
Esta skill analisa e documenta a estrutura completa do projeto atual, gerando um arquivo de referência arquitetural. |
|||
|
|||
## Instruções de Execução |
|||
|
|||
### 1. Análise Inicial |
|||
Execute os seguintes comandos para mapear o projeto: |
|||
|
|||
```bash |
|||
# Nome do projeto (baseado no diretório) |
|||
basename $(pwd) |
|||
|
|||
# Detectar tecnologias |
|||
ls -la | head -20 |
|||
``` |
|||
|
|||
### 2. Detectar Tecnologias |
|||
Verifique a existência dos seguintes arquivos para identificar as tecnologias: |
|||
- `package.json` → Node.js/JavaScript |
|||
- `composer.json` → PHP/Laravel |
|||
- `requirements.txt` ou `Pipfile` ou `pyproject.toml` → Python |
|||
- `Gemfile` → Ruby |
|||
- `go.mod` → Go |
|||
- `Cargo.toml` → Rust |
|||
- `Dockerfile` ou `docker-compose.yml` → Docker |
|||
- `manage.py` → Django |
|||
- `settings.py` no diretório principal → Django |
|||
- `artisan` → Laravel |
|||
|
|||
### 3. Mapear Estrutura de Diretórios |
|||
Use o comando tree ou find para mapear toda a estrutura: |
|||
|
|||
```bash |
|||
# Estrutura completa (excluindo node_modules, __pycache__, .git, venv, etc.) |
|||
find . -type d \( -name "node_modules" -o -name "__pycache__" -o -name ".git" -o -name "venv" -o -name ".venv" -o -name "vendor" -o -name ".tox" -o -name "*.egg-info" -o -name "build" -o -name "dist" -o -name ".pytest_cache" -o -name ".mypy_cache" \) -prune -o -type f -print | head -500 |
|||
``` |
|||
|
|||
### 4. Identificar Componentes Principais |
|||
Procure pelos seguintes padrões: |
|||
|
|||
**Backend:** |
|||
- Controllers/Views: `**/controllers/**`, `**/views/**`, `**/api/**` |
|||
- Models: `**/models/**`, `**/entities/**` |
|||
- Services: `**/services/**`, `**/usecases/**` |
|||
- Repositories: `**/repositories/**`, `**/dao/**` |
|||
- Migrations: `**/migrations/**`, `**/database/migrations/**` |
|||
- Routes: `**/routes/**`, `**/urls.py`, `routes/web.php` |
|||
- Middleware: `**/middleware/**` |
|||
- Jobs/Tasks: `**/jobs/**`, `**/tasks/**`, `**/celery/**` |
|||
|
|||
**Frontend:** |
|||
- Components: `**/components/**`, `**/src/components/**` |
|||
- Pages: `**/pages/**`, `**/views/**` |
|||
- Stores: `**/stores/**`, `**/store/**`, `**/redux/**` |
|||
- Assets: `**/assets/**`, `**/static/**`, `**/public/**` |
|||
- Styles: `**/styles/**`, `**/css/**`, `**/scss/**` |
|||
|
|||
**Infraestrutura:** |
|||
- Config: `**/config/**`, `**/settings/**` |
|||
- Docker: `Dockerfile`, `docker-compose*.yml` |
|||
- CI/CD: `.github/workflows/**`, `.gitlab-ci.yml`, `Jenkinsfile` |
|||
- Environment: `.env*`, `*.env` |
|||
|
|||
### 5. Gerar Arquivo de Estrutura |
|||
|
|||
Crie o arquivo `.claude/context/estrutura-projeto.md` com o seguinte formato: |
|||
|
|||
```markdown |
|||
# Estrutura do Projeto: [NOME_DO_PROJETO] |
|||
|
|||
> Última atualização: [DATA_ATUAL] |
|||
|
|||
## Tecnologias Detectadas |
|||
- [Lista de tecnologias identificadas] |
|||
|
|||
## Árvore de Diretórios |
|||
[Estrutura em formato tree] |
|||
|
|||
## Organização das Pastas Principais |
|||
|
|||
### Backend |
|||
[Descrição da organização do backend] |
|||
|
|||
### Frontend |
|||
[Descrição da organização do frontend] |
|||
|
|||
### Infraestrutura |
|||
[Descrição dos arquivos de infra] |
|||
|
|||
## Fluxo do Backend |
|||
[Explicar: rotas → controllers → services → repositories → models] |
|||
|
|||
## Fluxo do Frontend |
|||
[Explicar: páginas → componentes → stores → libs] |
|||
|
|||
## Microserviços |
|||
[Se existirem, descrever a organização] |
|||
|
|||
## Pontos Críticos |
|||
[Listar pontos de atenção no projeto] |
|||
|
|||
## Sugestões de Organização |
|||
[Se aplicável, sugerir melhorias] |
|||
``` |
|||
|
|||
### 6. Finalização |
|||
Após gerar o arquivo, exiba a mensagem: |
|||
|
|||
**"Estrutura atualizada. Todas as skills já podem usar este arquivo como referência arquitetural."** |
|||
|
|||
--- |
|||
|
|||
## Notas Importantes |
|||
|
|||
- Esta skill SEMPRE sobrescreve o arquivo anterior |
|||
- O arquivo gerado serve como "cérebro estrutural" para outras skills |
|||
- Outras skills devem ler `.claude/context/estrutura-projeto.md` antes de criar módulos ou fazer alterações |
|||
- Mantenha o arquivo atualizado executando esta skill periodicamente |
|||
File diff suppressed because one or more lines are too long
Binary file not shown.
File diff suppressed because one or more lines are too long
Binary file not shown.
Some files were not shown because too many files changed in this diff
Loading…
Reference in new issue