diff --git a/AGENTS.md b/AGENTS.md index 16a0169..021cccf 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,3 +9,31 @@ Use `simplicio-mapper` for bounded context, `simplicio-fast` for snapshots and P ### Execution and evidence Use `simplicio`/`simplicio shell compact` for inspection and `simplicio edit --plan` or governed dev-cli for mutation. Preserve `simplicio.io/v1`; run `simplicio contracts smoke --json`, focused tests and `simplicio validate "" --repo . --json`; close only with `simplicio evidence`. Facts are `MEASURED|` only with receipts, otherwise `UNVERIFIED|`; savings come only from `simplicio savings report --repo . --json`. Missing dependencies fail closed; never fabricate context or output. + + +## Regras arquiteturais obrigatórias para qualquer LLM + +Estas regras valem para análise, planejamento, implementação, revisão, testes, +release e documentação neste ecossistema. O agente deve lê-las antes de agir: + +1. **Não mantenha compatibilidade retroativa.** O que está obsoleto deve ser + deletado diretamente. Não adicione camadas de compatibilidade, migrações ou + fallbacks. +2. **Escolha a implementação mais simples que atende à necessidade atual.** + Não crie abstrações preventivas nem camadas de configuração desnecessárias. +3. **Divida o sistema em camadas longas.** Faça primeiro uma versão mínima + end-to-end funcionando; depois adicione capacidades por cima. Não desmonte + algo que funciona por complexidades inacabadas. +4. **Mantenha os componentes modulares**, com responsabilidades claramente + separadas e limites explícitos. +5. **Priorize bibliotecas maduras e mantidas.** Não reescreva do zero sem + motivo técnico explícito e registrado. +6. **Inspecione primeiro as dependências existentes.** Antes de adicionar um + pacote ou escrever uma solução própria, verifique o que o projeto já possui. +7. **Decida a arquitetura pensando no longo prazo.** Não aceite soluções + temporárias com a intenção de mudar depois. +8. **Use padrões de produtos maduros.** Pesquise como soluções consolidadas + resolvem o mesmo problema e reutilize padrões validados; não reinvente a roda. + + + diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..29a8cf1 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,31 @@ +# CLAUDE.md — simplicio-code + +Use `AGENTS.md` como contrato canônico deste repositório e cumpra as regras abaixo antes de agir. + + + +## Regras arquiteturais obrigatórias para qualquer LLM + +Estas regras valem para análise, planejamento, implementação, revisão, testes, +release e documentação neste ecossistema. O agente deve lê-las antes de agir: + +1. **Não mantenha compatibilidade retroativa.** O que está obsoleto deve ser + deletado diretamente. Não adicione camadas de compatibilidade, migrações ou + fallbacks. +2. **Escolha a implementação mais simples que atende à necessidade atual.** + Não crie abstrações preventivas nem camadas de configuração desnecessárias. +3. **Divida o sistema em camadas longas.** Faça primeiro uma versão mínima + end-to-end funcionando; depois adicione capacidades por cima. Não desmonte + algo que funciona por complexidades inacabadas. +4. **Mantenha os componentes modulares**, com responsabilidades claramente + separadas e limites explícitos. +5. **Priorize bibliotecas maduras e mantidas.** Não reescreva do zero sem + motivo técnico explícito e registrado. +6. **Inspecione primeiro as dependências existentes.** Antes de adicionar um + pacote ou escrever uma solução própria, verifique o que o projeto já possui. +7. **Decida a arquitetura pensando no longo prazo.** Não aceite soluções + temporárias com a intenção de mudar depois. +8. **Use padrões de produtos maduros.** Pesquise como soluções consolidadas + resolvem o mesmo problema e reutilize padrões validados; não reinvente a roda. + + diff --git a/GEMINI.md b/GEMINI.md new file mode 100644 index 0000000..1753742 --- /dev/null +++ b/GEMINI.md @@ -0,0 +1,31 @@ +# GEMINI.md — simplicio-code + +Use `AGENTS.md` como contrato canônico deste repositório. + + + +## Regras arquiteturais obrigatórias para qualquer LLM + +Estas regras valem para análise, planejamento, implementação, revisão, testes, +release e documentação neste ecossistema. O agente deve lê-las antes de agir: + +1. **Não mantenha compatibilidade retroativa.** O que está obsoleto deve ser + deletado diretamente. Não adicione camadas de compatibilidade, migrações ou + fallbacks. +2. **Escolha a implementação mais simples que atende à necessidade atual.** + Não crie abstrações preventivas nem camadas de configuração desnecessárias. +3. **Divida o sistema em camadas longas.** Faça primeiro uma versão mínima + end-to-end funcionando; depois adicione capacidades por cima. Não desmonte + algo que funciona por complexidades inacabadas. +4. **Mantenha os componentes modulares**, com responsabilidades claramente + separadas e limites explícitos. +5. **Priorize bibliotecas maduras e mantidas.** Não reescreva do zero sem + motivo técnico explícito e registrado. +6. **Inspecione primeiro as dependências existentes.** Antes de adicionar um + pacote ou escrever uma solução própria, verifique o que o projeto já possui. +7. **Decida a arquitetura pensando no longo prazo.** Não aceite soluções + temporárias com a intenção de mudar depois. +8. **Use padrões de produtos maduros.** Pesquise como soluções consolidadas + resolvem o mesmo problema e reutilize padrões validados; não reinvente a roda. + + diff --git a/llms.txt b/llms.txt new file mode 100644 index 0000000..b73cd78 --- /dev/null +++ b/llms.txt @@ -0,0 +1,22 @@ +# simplicio-code — LLM orientation + +Read AGENTS.md before planning or changing this repository. + + + +GLOBAL ARCHITECTURE RULES FOR LLMS + +1. Do not preserve backward compatibility. Delete obsolete behavior directly; + do not add compatibility layers, migrations, or fallbacks. +2. Choose the simplest implementation that meets the current need. +3. Build long-lived layers incrementally: make the minimum end-to-end version + work first, then add capabilities without dismantling working code. +4. Keep components modular with clear separation of responsibilities. +5. Prefer mature, maintained libraries; do not rewrite from scratch without an + explicit technical reason. +6. Inspect existing dependencies before adding packages or reimplementing. +7. Make architecture decisions for the long term; do not leave temporary + solutions to change later. +8. Reuse validated patterns from mature products instead of reinventing them. + +