LucasBiason/project-organization
.claude/skills/workflow/project-organization/SKILL.md
Regras para organização de projetos em config/ vs logs/ - quando usar cada pasta
$ install --global
skillsauthnpx skillsauth add LucasBiason/engineering-knowledge-base project-organizationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 8:59 PM2.1s1 file scanned
SKILL.md
- name:
- project-organization
- description:
- Regras para organização de projetos em config/ vs logs/ - quando usar cada pasta
- triggers:
- [config, logs, projeto, freelancer, proposta, organizar, mover, estrutura]
Organização de Projetos - Config vs Logs
Regras críticas para organização de projetos e propostas.
⚠️ REGRA CRÍTICA - Projetos Freelancer
config/work/freelancer/ - Apenas Projetos Reais
Esta pasta contém APENAS projetos que viraram projetos reais (em desenvolvimento ou concluídos).
Critérios para ficar em config/work/freelancer/:
- ✅ Projeto aprovado e em desenvolvimento
- ✅ Projeto concluído
- ✅ Projeto com estrutura técnica definida (arquitetura, specs, etc.)
- ✅ Projeto com código em desenvolvimento
Estrutura obrigatória:
config/work/freelancer/[projeto]/
├── README.md # Visão geral
├── requisitos-tecnicos/ # Requisitos técnicos
├── requisitos-processos/ # Regras de negócio
├── arquitetura-diagramas/ # Decisões de arquitetura
└── consulta/ # Arquivos de referência
logs/work/freelancer/ - Propostas e Temporários
Esta pasta contém propostas e projetos temporários que não viraram projetos reais.
Critérios para ir para logs/work/freelancer/:
- ❌ Apenas propostas enviadas (sem aprovação ainda)
- ❌ Projetos temporários que não viraram projetos
- ❌ Análises e estudos de viabilidade que não resultaram em projeto
- ❌ Contexto de negociação que não evoluiu para projeto
Objetivo: Evitar acumular contexto permanente com coisas que não vingaram, mantendo o config/ limpo e focado apenas em projetos reais.
🔄 Quando Mover de Logs para Config
Quando um projeto temporário for aprovado e iniciado:
- Mover a pasta de
logs/work/freelancer/paraconfig/work/freelancer/ - Aplicar estrutura padrão (requisitos-tecnicos, requisitos-processos, etc.)
- Criar
README.mdcom visão geral do projeto - Manter histórico relevante em
logs/work/[projeto]/historico-contexto/
📋 Checklist de Decisão
Perguntar antes de criar em config/work/freelancer/:
- [ ] O projeto foi aprovado pelo cliente?
- [ ] O projeto está em desenvolvimento ativo?
- [ ] Existe estrutura técnica definida (arquitetura, specs)?
- [ ] O projeto tem código sendo desenvolvido?
Se TODAS as respostas forem SIM → config/work/freelancer/
Se ALGUMA resposta for NÃO → logs/work/freelancer/
🎯 Regra Geral para Todos os Projetos
config/work/[projeto]/ ou config/studies/[projeto]/
- Conteúdo: Requisitos técnicos, regras de negócio, decisões de arquitetura
- Propósito: Documentação permanente do projeto
- Estrutura: Padronizada (requisitos-tecnicos, requisitos-processos, arquitetura-diagramas, consulta)
logs/work/[projeto]/ ou logs/studies/[projeto]/
- Conteúdo: Interação diária, dailys, histórico de contexto
- Propósito: Rastreamento de evolução e decisões do dia a dia
- Estrutura: historico-contexto/ e interacao-diaria/
Regra: Logs de interação sempre ficam em logs/, nunca em config/.
📝 Exemplos
Exemplo 1: Proposta não aprovada
- Localização:
logs/work/freelancer/[nome-proposta]/ - Conteúdo: Proposta enviada, contexto do cliente, análise técnica
- Status: Não aprovado, não virou projeto
- Ação: Manter em
logs/
Exemplo 2: Projeto aprovado e iniciado
- Localização:
config/work/freelancer/[nome-projeto]/ - Conteúdo: Arquitetura, specs, requisitos, código
- Status: Em desenvolvimento
- Ação: Estrutura padrão aplicada
Exemplo 3: Análise de viabilidade
- Localização:
logs/work/freelancer/[nome-analise]/ - Conteúdo: Análise técnica, estimativas, decisão de não prosseguir
- Status: Não virou projeto
- Ação: Manter em
logs/
⚠️ Importante
NUNCA acumular contexto permanente com coisas que não vingaram ou ficaram apenas na fase de proposta. Isso mantém o config/ limpo, organizado e focado apenas em projetos reais.
Última Atualização: 2026-01-23
Related Skills
LucasBiason/test-runner
testing
VerifiedTrustedCommunity
Execução e análise de testes automatizados
1SKILL.mdUpdated Apr 17, 2026
LucasBiason/study-summary-rich
development
VerifiedTrustedCommunity
Gera resumos didáticos extensos e estruturados de aulas/cursos para cards do Notion. Use ao resumir aulas, apostilas, transcrições ou materiais de estudo para incluir no corpo do card (não apenas no campo Descrição), com flashcards, exemplos de código, diagramas Mermaid, mapa conceitual e perguntas de reforço.
1SKILL.mdUpdated Apr 17, 2026
LucasBiason/spec-normalizer
development
VerifiedTrustedCommunity
Padroniza documentação existente no formato canônico Spec-Driven. Remove duplicação e melhora rastreabilidade.
1SKILL.mdUpdated Apr 17, 2026
LucasBiason/spec-driven-core
development
VerifiedTrustedCommunity
Processo universal e repetível para criar especificações a partir de qualquer input (texto, docs, código). Usado em Plan mode.
1SKILL.mdUpdated Apr 17, 2026