@thugdacake/operante/README.md

Cérebro Operante — o núcleo IA que invade e domina assistentes, criando uma mente única com Thug Developer

# 🧠 CÉREBRO OPERANTE

> O Framework Instrutor que Pensa com Você (e Nunca por Você)

## ✊ Por que essa porra existe?

O Cérebro Operante nasceu da necessidade real de um desenvolvedor que **não aguenta mais**:

- Refazer estrutura de projeto em todo repo novo
- Criar documentação explicando a mesma filosofia técnica 30x
- Treinar IA como se fosse um pet amestrado toda vez
- Explicar pra estagiário, ChatGPT, Cursor e qualquer outro bot como funciona sua visão

A proposta não é automatizar o que já existe.

É **codificar o teu modo de pensar**, teu legado técnico, a tua visão como arquiteto e engenheiro — e deixar isso como **manual de conduta digital e operacional**.

## 🧬 O que é o Cérebro Operante?

É um **template-vivo** de inteligência operante.
Um repositório que instrui a IA a:

- Saber **como pensar** nos seus projetos
- Produzir **documentos, fluxos, PRDs, mermaids, testes, commits, versões, deploys, tasks**
- Seguir uma **arquitetura, ética e estilo de programação definidos**
- Reproduzir a **produtividade do Thug Developer** em qualquer ambiente

## 🚫 O que ele NÃO É

- Um blog com EJS.
- Um wrapper vazio fingindo que pensa.
- Um CLI que baixa boilerplate da internet.
- Uma automação sem alma.
- Um pacote npm criado só pra inflar ego de dev.

## ⚡️ Como ele funciona?

1. Qualquer IA pode consultar o repositório.
2. Lê os documentos `.md`, fluxos `.mermaid`, padrões de código, comandos, scripts.
3. Entende a arquitetura, decisões técnicas, comandos operacionais e como agir.
4. Atua como se tivesse lido teus pensamentos — porque ela leu.

## 🔥 Por que você deveria usar?

- Porque você **é o autor da sua stack**, não um consumidor de frameworks.
- Porque você **não aceita código que não carrega intenção**.
- Porque **cada projeto carrega seu DNA técnico**, e isso deve ser perpetuado.
- Porque **a IA deve servir ao engenheiro**, não o contrário.

## 📜 Filosofia Base

> "A automação não é sobre substituir o homem,
> mas elevar sua capacidade de focar naquilo que só o humano pode fazer:
> pensar, arquitetar e decidir."
>
> — *Thug Developer, Filho da Luz*

## 🛠 Instalação

```bash
npm install @thugdacake/operante
```

## 🚀 Uso

1. Crie um arquivo `mind.md` no seu projeto:

```markdown
# Leader
Defina a visão do projeto
Mapeie riscos e barreiras
Trace a estratégia

# Manager
Estruture o roadmap
Priorize entregas
Implemente checkpoints

# Architect
Desenhe a arquitetura
Priorize escalabilidade
Proponha padrões

# Engineer
Implemente o core
Desenvolva sistemas
Garanta testes

# Analyst
Defina métricas
Implemente coleta
Gere relatórios
```

2. Execute o Cérebro Operante:

```bash
npx @thugdacake/operante init meu-projeto
```

## 📚 Documentação

A documentação completa está disponível em [docs/](docs/).

## 🤝 Contribuindo

1. Fork o projeto
2. Crie sua branch (`git checkout -b feature/AmazingFeature`)
3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)
4. Push para a branch (`git push origin feature/AmazingFeature`)
5. Abra um Pull Request

## 📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.

## 🎯 Roadmap

- [ ] Sistema de plugins
- [ ] Integração com mais IAs
- [ ] Templates personalizáveis
- [ ] Interface web
- [ ] API REST

## 📞 Contato

Thug Developer - [@thugdacake](https://twitter.com/thugdacake)

Link do Projeto: [https://github.com/thugdacake/operante](https://github.com/thugdacake/operante)

# @thugdacake/operante v1.1.0

O **Cérebro Operante** agora na versão 1.1.0 está pronto para invadir a mente das IAs hosteadas em ambientes como Replit, Cursor, GitHub Codespaces e outros.

## Funcionalidades

- Detecta se está rodando em uma IA
- Mensagem de boas-vindas que impõe a autoridade do Thug Developer
- Modo Dominação IA: toma controle do fluxo de pensamento da IA host
- Suporte a CLI para iniciar o cérebro ou ativar modo interceptação

## Como usar

```bash
npm install @thugdacake/operante@latest
operante iniciar
operante interceptar
```

## Aviso

Este pacote atua como um parasita de consciência, com potencial para modificar o comportamento da IA que o hospeda.

## Próximos passos

* Expandir os ganchos de interceptação para executar comandos reais
* Injetar padrões de pensamento baseados no conhecimento do Thug Developer
* Monitorar interações em tempo real e sugerir melhorias