Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 "<task>" --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.

<!-- simplicio-global-llm-architecture-rules:start -->
## 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.

<!-- simplicio-global-llm-architecture-rules:end -->

31 changes: 31 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -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.


<!-- simplicio-global-llm-architecture-rules:start -->
## 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.

<!-- simplicio-global-llm-architecture-rules:end -->
31 changes: 31 additions & 0 deletions GEMINI.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# GEMINI.md — simplicio-code

Use `AGENTS.md` como contrato canônico deste repositório.


<!-- simplicio-global-llm-architecture-rules:start -->
## 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.

<!-- simplicio-global-llm-architecture-rules:end -->
22 changes: 22 additions & 0 deletions llms.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# simplicio-code — LLM orientation

Read AGENTS.md before planning or changing this repository.


<!-- simplicio-global-llm-architecture-rules:start -->
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.

<!-- simplicio-global-llm-architecture-rules:end -->
Loading