Regras condicionais por path que se aplicam automaticamente baseado nos arquivos sendo discutidos
O Path-Specific Rules e um sistema de regras condicionais do ChatCLI que aplica instruções automaticamente com base nos caminhos de arquivos sendo discutidos ou editados na conversa. Em vez de carregar todas as regras sempre, o sistema detecta quais arquivos estão em contexto e injeta apenas as regras relevantes.
Path Rules complementam o sistema de bootstrap (RULES.md). Enquanto RULES.md define regras globais, Path Rules define regras especÃficas para partes do codebase.
A ideia e simples: diferentes partes do codebase tem diferentes convencoes. Código Go segue regras diferentes de templates HTML. Testes tem padroes diferentes de código de produção. Path Rules permite definir tudo isso de forma granular.
Conversa menciona auth/handler.go | vPath matcher: "auth/**" -> auth-rules.mdPath matcher: "*.go" -> go-rules.md | vRegras injetadas no system prompt(apenas as relevantes)
As regras ficam no diretório .chatcli/rules/ (workspace) ou ~/.chatcli/rules/ (global):
.chatcli/rules/|-- go-rules.md # Regras para arquivos Go|-- test-rules.md # Regras para arquivos de teste|-- api-rules.md # Regras para o modulo de API|-- migration-rules.md # Regras para migrations de banco+-- security-rules.md # Regras para modulos de segurança
O campo paths usa padroes glob para corresponder caminhos de arquivos:
Padrão
Corresponde a
*.go
Arquivos Go no diretório raiz
**/*.go
Arquivos Go em qualquer subdiretorio
*_test.go
Arquivos de teste Go
src/**
Todos os arquivos dentro de src/
auth/**
Todos os arquivos dentro de auth/
*.{ts,tsx}
Arquivos TypeScript e TSX
migrations/*.sql
Arquivos SQL em migrations/
Dockerfile*
Dockerfiles (Dockerfile, Dockerfile.prod, etc.)
Use ** para correspondencia recursiva em subdiretorios. O padrão *.go corresponde apenas no diretório raiz, enquanto **/*.go corresponde em toda a arvore.
Path Rules usa lazy loading baseado em dicas da conversa:
1
Detecção de contexto
O ChatCLI analisa as mensagens recentes e tool calls para identificar quais arquivos estão em contexto (lidos, editados, mencionados).
2
Match de padroes
Os caminhos detectados são comparados contra os padroes paths de cada arquivo de regra.
3
Injecao seletiva
Apenas as regras que correspondem a arquivos em contexto são injetadas no system prompt.
4
Atualizacao dinamica
A cada turno, os padroes são re-avaliados. Novas regras podem ser injetadas e regras irrelevantes podem ser removidas.
Lazy loading garante que o system prompt não fique sobrecarregado com regras irrelevantes. Apenas as regras necessarias para os arquivos em discussao são carregadas, economizando tokens.
---paths: - "**/*.go"description: "Convencoes Go do projeto"---# Regras Go- Use `errors.New()` ou `fmt.Errorf()` para erros, nunca strings cruas- Funções exportadas DEVEM ter comentario godoc- Use `context.Context` como primeiro parâmetro quando aplicavel- Prefira `sync.Mutex` a channels para estado compartilhado simples- Não use `init()` exceto para registro de drivers
.chatcli/rules/test-rules.md:
---paths: - "**/*_test.go" - "**/*.test.ts" - "**/*.spec.ts"description: "Padroes para arquivos de teste"---# Regras de Teste- Use table-driven tests em Go- Nomeie subtestes com descricoes claras em ingles- Evite mocks excessivos — prefira fakes ou stubs simples- Cada teste deve ser independente e idemponente- Use `t.Parallel()` quando o teste não depende de estado global
.chatcli/rules/security-rules.md:
---paths: - "auth/**" - "security/**" - "**/middleware/auth*"description: "Regras de segurança para modulos criticos"---# Regras de Segurança- NUNCA logue tokens, senhas ou API keys- Use `crypto/rand` para geracao de tokens, NUNCA `math/rand`- Valide TODOS os inputs do usuário antes de processar- Use prepared statements para queries SQL (prevencao de injection)- Implemente rate limiting em endpoints de autenticação- Tokens JWT devem ter expiracao máxima de 1 hora
.chatcli/rules/migration-rules.md:
---paths: - "migrations/**" - "db/migrations/**"description: "Regras para migrations de banco de dados"---# Regras de Migrations- Sempre inclua operação UP e DOWN- Nomes no formato: YYYYMMDDHHMMSS_descrição.sql- Evite ALTER TABLE em tabelas grandes sem downtime plan- Use transações explicitas (BEGIN/COMMIT)- Não use DROP COLUMN em produção sem deprecacao previa- Adicione indices em campos usados em WHERE e JOIN
