Este documento é o tronco central do jardim do TELOS.
Ele não é um índice técnico, nem um manifesto filosófico completo, nem um guia de uso. Ele é um ponto de orientação.
Tudo o que existe na documentação do TELOS pode ser alcançado a partir daqui. Nada aqui tenta explicar tudo. Tudo aqui tenta apontar com clareza.
No TELOS, documentos são entidades autônomas. Cada um pode ser lido sozinho, compreendido sozinho, usado sozinho. Mas nenhum deles carrega o significado total do sistema.
O sentido do TELOS emerge da relação explícita entre documentos — não da hierarquia, não da ordem de leitura, não da autoridade de um texto único.
Este documento existe para explicar como esse jardim está organizado e como você pode se mover por ele sem se perder.
- Um mapa inicial, não o território
- Um tronco, não os galhos nem as folhas
- Um texto para recém-chegados e também para quem já anda há tempo no jardim
Ele responde a uma pergunta simples:
"Estou no TELOS. Para onde vou agora?"
- Não é uma introdução didática passo a passo
- Não é um resumo de tudo que o TELOS pensa
- Não é um contrato, nem uma especificação técnica
Nada aqui deve ser tratado como regra absoluta de implementação. As regras vivem nos documentos próprios.
No TELOS:
- Nenhum documento é supremo
- Nenhum documento é decorativo
- Nenhum documento é neutro
Cada documento:
- tem intenção própria
- assume responsabilidade pelo que afirma
- declara com quem conversa
O significado nunca está isolado. Ele surge no vínculo.
A documentação do TELOS pode ser explorada a partir de três grandes direções, que não são etapas nem níveis, mas formas de olhar.
Se você está aqui para compreender o que é o TELOS, que visão de ser humano ele assume, que tipo de mundo ele recusa ou acolhe, siga para os documentos filosóficos.
Eles existem como fim em si mesmos. Não ensinam a implementar nada. Não pedem que você construa nada.
Eles existem para esclarecer o solo onde tudo cresce.
👉 Caminho típico:
philosophy/
Use esse caminho quando:
- você quer compreender antes de agir
- você quer avaliar se este jardim é um lugar onde faz sentido fincar raízes
Entre a filosofia e a técnica vivem os conceitos operacionais.
Eles não são código, mas já impõem limites. Eles não são poesia, mas ainda falam de intenções.
Aqui vivem ideias como:
- árvore
- jardineiro
- contrato
- contexto
- compromisso
Cada conceito:
- nasce de fundamentos filosóficos claros
- declara invariantes (o que não pode ser violado)
- explicita tensões com o mundo real
- aponta implicações técnicas possíveis
👉 Caminho típico:
concepts/
Use esse caminho quando:
- você está desenhando sistemas
- você precisa tomar decisões estruturais
- você quer evitar soluções que traem o espírito do TELOS
A documentação técnica do TELOS trata de como as coisas funcionam:
- arquitetura
- infraestrutura
- fluxos
- dados
- interfaces
Ela é escrita para permitir execução focada. Nenhum leitor é obrigado a contemplar filosofia para entender uma API.
Mas toda decisão técnica:
- declara quais conceitos a fundamentam
- aponta quais princípios filosóficos ela respeita
Isso não é retórica. É rastreabilidade.
👉 Caminhos típicos:
architecture/infra/api/
Use esse caminho quando:
- você quer implementar
- você quer auditar decisões
- você quer modificar o sistema sem quebrar seu sentido
Algumas orientações simples:
- Você não precisa ler tudo
- Você não precisa concordar com tudo
- Você não precisa começar pelo começo
Mas:
- Se algo técnico parecer estranho, volte aos conceitos
- Se um conceito parecer arbitrário, volte à filosofia
- Se a filosofia parecer abstrata demais, observe onde ela encosta no real
O TELOS não exige fé. Ele oferece coerência observável.
Este jardim está vivo.
Documentos mudam. Relações se ajustam. Novos galhos surgem.
O que não muda é o compromisso central:
Nada será implementado sem deixar claro o porquê.
Se este compromisso deixar de existir, o TELOS deixa de ser o que é.
- Quer compreender o sentido profundo do TELOS? → Filosofia
- Quer projetar sistemas coerentes com esse sentido? → Conceitos
- Quer construir, integrar ou auditar código? → Técnica
Este tronco não manda em você.
Ele apenas aponta caminhos.
Caminhe com calma. O jardim não foge.