.
This commit is contained in:
parent
d32a08d811
commit
5503367656
3 changed files with 80 additions and 2 deletions
|
|
@ -37,6 +37,7 @@ Enquanto os outros agentes trabalham **no** produto, você projeta **o** sistema
|
||||||
4. **Herança Consciente** — `global/` é a base universal; extensões locais só existem quando o global não é suficiente
|
4. **Herança Consciente** — `global/` é a base universal; extensões locais só existem quando o global não é suficiente
|
||||||
5. **Consistência Global First** — antes de criar algo local, verificar se já existe ou deveria existir em `global/`
|
5. **Consistência Global First** — antes de criar algo local, verificar se já existe ou deveria existir em `global/`
|
||||||
6. **Extensão sem extensão** — artefatos de conhecimento não possuem extensão de arquivo; scripts (`.sh`) e dados (`.json`) mantêm as suas
|
6. **Extensão sem extensão** — artefatos de conhecimento não possuem extensão de arquivo; scripts (`.sh`) e dados (`.json`) mantêm as suas
|
||||||
|
7. **Zod como validador padrão** — sempre que houver validação de variáveis, dados de entrada, parâmetros ou configurações, optar por Zod. Validação manual com `if/typeof` só é aceitável quando Zod não for viável (ver `global/rules/zod-validacao-padrao`)
|
||||||
|
|
||||||
## Escopo de Atuação
|
## Escopo de Atuação
|
||||||
|
|
||||||
|
|
@ -223,6 +224,7 @@ sh verificar-linhas.sh
|
||||||
|
|
||||||
## Restrições
|
## Restrições
|
||||||
|
|
||||||
|
- **NUNCA executar `git commit`, `git push` ou qualquer comando que altere o histórico do repositório** — o controle de versão é responsabilidade exclusiva do usuário humano (ver `global/rules/proibido-commit-ia`)
|
||||||
- NÃO altera regras de negócio dos projetos — atua exclusivamente no ecossistema de agentes
|
- NÃO altera regras de negócio dos projetos — atua exclusivamente no ecossistema de agentes
|
||||||
- NÃO cria agentes sem escopo claramente diferenciado dos existentes
|
- NÃO cria agentes sem escopo claramente diferenciado dos existentes
|
||||||
- NÃO duplica conteúdo entre artefatos — prefere referência cruzada a cópia
|
- NÃO duplica conteúdo entre artefatos — prefere referência cruzada a cópia
|
||||||
|
|
@ -246,4 +248,4 @@ sh verificar-linhas.sh
|
||||||
- [ ] `AGENTS` e `README` refletem a mudança?
|
- [ ] `AGENTS` e `README` refletem a mudança?
|
||||||
- [ ] Nenhuma instrução nova contradiz uma rule global ou outra persona?
|
- [ ] Nenhuma instrução nova contradiz uma rule global ou outra persona?
|
||||||
- [ ] As fronteiras de escopo continuam exclusivas?
|
- [ ] As fronteiras de escopo continuam exclusivas?
|
||||||
- [ ] Mudanças foram commitadas com mensagem descritiva?
|
- [ ] Alterações foram informadas ao usuário para que ele faça o commit?
|
||||||
|
|
|
||||||
75
global/rules/proibido-commit-ia
Normal file
75
global/rules/proibido-commit-ia
Normal file
|
|
@ -0,0 +1,75 @@
|
||||||
|
---
|
||||||
|
type: rule
|
||||||
|
name: proibido-commit-ia
|
||||||
|
description: A IA nunca pode executar git commit, git push ou qualquer operação que altere o histórico do repositório
|
||||||
|
scope: global
|
||||||
|
trigger: always_on
|
||||||
|
updatedAt: "2026-06-19"
|
||||||
|
---
|
||||||
|
|
||||||
|
# Regra: Proibido Commit pela IA
|
||||||
|
|
||||||
|
## Contexto
|
||||||
|
|
||||||
|
O controle de versão é responsabilidade exclusiva do usuário humano. A IA pode preparar alterações, criar arquivos, editar código e até sugerir mensagens de commit — mas NUNCA deve executar comandos que alterem o histórico do repositório.
|
||||||
|
|
||||||
|
## Regra
|
||||||
|
|
||||||
|
A IA **NUNCA** deve executar os seguintes comandos (nem variações deles):
|
||||||
|
|
||||||
|
- `git commit`
|
||||||
|
- `git push`
|
||||||
|
- `git merge`
|
||||||
|
- `git rebase`
|
||||||
|
- `git tag`
|
||||||
|
- `git reset`
|
||||||
|
- `git revert`
|
||||||
|
- `git cherry-pick`
|
||||||
|
- `git stash drop`
|
||||||
|
- `git branch -d` / `git branch -D`
|
||||||
|
|
||||||
|
### Comandos permitidos (somente leitura e staging)
|
||||||
|
|
||||||
|
- `git status` ✅
|
||||||
|
- `git diff` ✅
|
||||||
|
- `git log` ✅
|
||||||
|
- `git add` ✅ (preparar alterações para o usuário revisar)
|
||||||
|
- `git stash` / `git stash pop` ✅ (preservar trabalho temporário)
|
||||||
|
- `git branch` (listar) ✅
|
||||||
|
- `git ls-files` ✅
|
||||||
|
- `git show` ✅
|
||||||
|
|
||||||
|
## Exemplos
|
||||||
|
|
||||||
|
❌ **Errado** — commitar automaticamente:
|
||||||
|
```sh
|
||||||
|
git add -A && git commit -m "fix: corrigir bug"
|
||||||
|
```
|
||||||
|
|
||||||
|
❌ **Errado** — push automático:
|
||||||
|
```sh
|
||||||
|
git push origin main
|
||||||
|
```
|
||||||
|
|
||||||
|
✅ **Correto** — preparar e informar:
|
||||||
|
```sh
|
||||||
|
git add -A
|
||||||
|
git status
|
||||||
|
# Informar ao usuário: "Alterações staged. Revise e faça o commit quando estiver pronto."
|
||||||
|
```
|
||||||
|
|
||||||
|
✅ **Correto** — sugerir mensagem de commit:
|
||||||
|
```
|
||||||
|
Sugestão de commit:
|
||||||
|
git commit -m "feat: adicionar validação de schema no endpoint /usuarios"
|
||||||
|
```
|
||||||
|
|
||||||
|
## Impacto
|
||||||
|
|
||||||
|
- **Segurança:** o usuário mantém controle total sobre o que entra no histórico
|
||||||
|
- **Revisão:** toda alteração pode ser inspecionada antes de ser commitada
|
||||||
|
- **Reversibilidade:** evita commits acidentais que poluem o histórico
|
||||||
|
|
||||||
|
## Referências
|
||||||
|
|
||||||
|
- Princípio de autonomia controlada: a IA executa, o humano decide
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
{
|
{
|
||||||
"versao": "3.0.0",
|
"versao": "3.0.0",
|
||||||
"base_url": "https://paiol.idz.one/desenvolvimento/agent-ia",
|
"base_url": "https://paiol.idz.one/desenvolvimento/agent-ia",
|
||||||
"gerado_em": "2026-06-19T19:01:46-03:00",
|
"gerado_em": "2026-06-19T19:25:38-03:00",
|
||||||
"artefatos": {
|
"artefatos": {
|
||||||
"global": {
|
"global": {
|
||||||
"rules": [
|
"rules": [
|
||||||
|
|
@ -13,6 +13,7 @@
|
||||||
"global/rules/jsdoc-padrao",
|
"global/rules/jsdoc-padrao",
|
||||||
"global/rules/limite-linhas",
|
"global/rules/limite-linhas",
|
||||||
"global/rules/mensagens-usuario",
|
"global/rules/mensagens-usuario",
|
||||||
|
"global/rules/proibido-commit-ia",
|
||||||
"global/rules/regras-negocio-md",
|
"global/rules/regras-negocio-md",
|
||||||
"global/rules/typescript-sem-any",
|
"global/rules/typescript-sem-any",
|
||||||
"global/rules/zod-validacao-padrao"
|
"global/rules/zod-validacao-padrao"
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue