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
29 changes: 29 additions & 0 deletions .github/workflows/check.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
name: Validate boonOS
on:
push:
branches: [main, 'beta/**']
pull_request:
workflow_dispatch:
permissions:
contents: read
jobs:
portable-core:
strategy:
fail-fast: false
matrix:
os: [ubuntu-latest, macos-latest, windows-latest]
python: ['3.10', '3.13']
runs-on: ${{ matrix.os }}
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 1
- run: git config core.autocrlf false
- run: git checkout-index --all --force
- uses: actions/setup-python@v5
with:
python-version: ${{ matrix.python }}
- run: python scripts/check.py --release
- run: python -m unittest discover -s tests -v
- run: python scripts/finance.py "06. GUIAS/03. EXEMPLOS/operacao.json" --as-of 2026-09-25
- run: python scripts/package.py package.zip
2 changes: 1 addition & 1 deletion 00. COMECE-AQUI.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Você precisa de uma pasta aberta no agente e de uma situação que valha resolv

## 1. Abra esta pasta

Use Codex ou Claude Code com acesso a arquivos locais. Se ainda não baixou o sistema, siga [Instalar](<06. GUIAS/01. INSTALAÇÃO/INSTALAR.md>) e escolha a branch `beta/2.1`.
Use um agente com acesso a arquivos locais: Codex, Claude Code, Gemini CLI ou outro que consiga ler e trabalhar nesta pasta. Se ainda não baixou o sistema, siga [Instalar](<06. GUIAS/01. INSTALAÇÃO/INSTALAR.md>) e escolha a branch `beta/2.1`.

## 2. Conte o que está acontecendo

Expand Down
6 changes: 3 additions & 3 deletions 06. GUIAS/01. INSTALAÇÃO/ATIVAR-CI.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# Ativar os testes automáticos no GitHub
# Manter os testes automáticos no GitHub

Esta etapa é de manutenção do template. Não é necessária para instalar ou usar o boonOS.

Os 66 testes desta release foram executados localmente em macOS com Python 3.14.4. A matriz remota de Linux/macOS/Windows e Python 3.10/3.13 está preparada em [check.workflow.yml](check.workflow.yml), mas não está ativa. A credencial usada na publicação não autoriza criar arquivos de workflow.
O workflow está ativo em `.github/workflows/check.yml` no repositório de origem. As seis combinações de Linux/macOS/Windows com Python 3.10/3.13 passaram na [primeira execução completa](https://github.com/tchelove/boonOS/actions/runs/36204735331). Os 66 testes também passaram localmente em macOS/Python 3.14.4. [check.workflow.yml](check.workflow.yml) mantém uma cópia da configuração para referência.

Com autorização para configurar CI no repositório e uma sessão/permissão apropriada:
Se sua cópia não tiver o workflow, use estes passos com autorização para configurar CI e uma sessão/permissão apropriada:

1. Use a branch `beta/2.1` ou uma branch de manutenção que contenha esta release completa.
2. Copie `check.workflow.yml` deste diretório para `.github/workflows/check.yml`, preservando o conteúdo.
Expand Down
15 changes: 10 additions & 5 deletions 06. GUIAS/01. INSTALAÇÃO/INSTALAR.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
# Instalar o boonOS 2.1 (beta)

Você precisa de um agente com acesso à pasta local e acesso à sua conta nesse agente. O pacote inclui contratos para Codex e Claude Code. Git é opcional para baixar o pacote. Ferramentas de imagem, apresentações, serviços externos e rotinas recorrentes são opcionais e dependem do ambiente.
Você precisa de **um agente de IA capaz de ler e trabalhar nos arquivos da pasta**, com acesso à sua conta nesse agente. Pode ser Codex, Claude Code, Gemini CLI ou outro com esse recurso. O boonOS não exige Claude Code nem conta Anthropic. Git é opcional para baixar o pacote. Ferramentas de imagem, apresentações, serviços externos e rotinas recorrentes são opcionais e dependem do ambiente.

## 1. Escolha a edição certa

**Caminho mais simples, sem terminal:**

1. Se o repositório estiver privado, aceite o convite do GitHub e entre na conta que recebeu acesso.
2. Abra a [release boonOS 2.1](https://github.com/tchelove/boonOS/releases/tag/v2.1.0-beta.1). Em **Assets**, baixe `boonOS-2.1-beta.zip`.
2. Abra a [release boonOS 2.1](https://github.com/tchelove/boonOS/releases/tag/v2.1.0-beta.2). Em **Assets**, baixe `boonOS-2.1-beta.zip`.
3. Extraia o ZIP em uma pasta sua, por exemplo `Documentos/meu-sistema`. Você pode renomear a pasta.
4. Abra a pasta extraída que contém `AGENTS.md`, `CLAUDE.md` e `boonos.json` — esses arquivos devem estar diretamente dentro dela.

Expand All @@ -20,29 +20,32 @@ git clone --branch beta/2.1 --single-branch https://github.com/tchelove/boonOS.g
cd meu-sistema
~~~

Clonar sem `--branch beta/2.1` segue a branch padrão do GitHub e pode trazer uma edição posterior. Confira `boonos.json`: esta edição usa a versão `2.1.0-beta.1`.
Clonar sem `--branch beta/2.1` segue a branch padrão do GitHub e pode trazer uma edição posterior. Confira `boonos.json`: esta edição usa a versão `2.1.0-beta.2`.

## 2. Abra no seu agente

Se ainda não tiver um agente instalado, escolha **um** caminho e conclua a instalação e o login da sua conta. Os requisitos e formas de acesso ficam nos guias oficiais:

- **Codex:** [primeiros passos no aplicativo](https://learn.chatgpt.com/docs/quickstart) ou [Codex no terminal](https://learn.chatgpt.com/docs/codex/cli).
- **Claude Code:** [instalação e primeira sessão](https://code.claude.com/docs/en/quickstart).
- **Gemini CLI:** [instalação oficial](https://geminicli.com/docs/get-started/installation/).

Não precisa instalar os dois. O boonOS é a pasta de contexto e processos; o agente é o aplicativo que lê e trabalha nela.
Escolha apenas o agente que pretende usar. O boonOS é a pasta de contexto e processos; o agente é o aplicativo que lê e trabalha nela.

| Agente | Entrada local |
|---|---|
| Codex | no aplicativo, use a opção de abrir pasta/projeto e escolha a pasta extraída; no terminal, execute `codex` dentro dela |
| Claude Code | execute `claude` dentro da pasta ou abra-a na interface que utiliza |
| Gemini CLI | execute `gemini` dentro da pasta; `GEMINI.md` importa o contrato comum |
| Outro agente com arquivos locais | abra a pasta e peça a leitura de `AGENTS.md` e `.agents/skills/init/SKILL.md` |

A disponibilidade do aplicativo e seus requisitos dependem da plataforma e da versão instalada. A existência dos contratos neste pacote não declara teste real em cada combinação de Windows/macOS e agente.

Na primeira conversa:

> Use a skill local init deste workspace e me guie na configuração. Quero conhecer as possibilidades criativas e operacionais e começar por uma situação minha.

No Codex, `$init` é uma alternativa para selecionar a skill. No Claude, use o pedido explícito acima: `/init` pode ter outro significado no aplicativo. Não é necessário editar YAML para começar.
No Codex, `$init` é uma alternativa para selecionar a skill. Nos demais, use o pedido explícito acima: `/init` pode ter outro significado no aplicativo. Não é necessário editar YAML para começar.

## 3. Escolha o ritmo

Expand All @@ -58,6 +61,8 @@ Peça ao agente para informar o nome da versão, citar a prioridade de `01. SIST

Se não encontrar a skill, confira se abriu a pasta raiz correta e se o arquivo local da skill está presente. Abra uma nova sessão dentro dessa pasta. Se a instalação do agente não carregar skills locais, peça a leitura do `SKILL.md` pelo caminho; isso é um procedimento manual, não prova descoberta automática.

No Gemini CLI, `/memory show` permite conferir o contexto carregado e `/skills list` lista as skills disponíveis. Versões atuais reconhecem `.agents/skills`; confirme no seu ambiente e siga as solicitações de confiança da pasta e ativação da skill. Consulte a documentação oficial de [contexto](https://geminicli.com/docs/cli/gemini-md/) e [skills](https://geminicli.com/docs/cli/skills/). Esta edição inclui a entrada do Gemini, mas não registra um onboarding executado no aplicativo Gemini CLI. Um chat sem acesso local exige anexar o contexto e salvar as saídas manualmente; não oferece a mesma continuidade da pasta aberta.

Os verificadores do pacote exigem Python 3.10 ou superior. Na raiz:

~~~bash
Expand Down
2 changes: 1 addition & 1 deletion 06. GUIAS/01. INSTALAÇÃO/PUBLICAR.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Publicar uma edição do template

Guia para quem mantém o pacote. Edição: **boonOS 2.1 (beta)**. Branch de distribuição: `beta/2.1`. Tag proposta: `v2.1.0-beta.1`. A identificação nos arquivos não prova publicação remota.
Guia para quem mantém o pacote. Edição: **boonOS 2.1 (beta)**. Branch de distribuição: `beta/2.1`. Tag proposta: `v2.1.0-beta.2`. A identificação nos arquivos não prova publicação remota.

## Preparar o pacote

Expand Down
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Se o contexto não foi configurado, use a skill local `init` para obter o mínim
## Como trabalhar

- Entenda resultado esperado, destinatário, fontes, restrições e critério de conclusão. Pergunte apenas o que mudar uma decisão ou impedir a entrega.
- Use a skill pertinente em `.agents/skills`; no Claude Code, o espelho é `.claude/skills`. O usuário pode pedir em linguagem comum.
- Use a skill pertinente em `.agents/skills` (Codex e Gemini CLI); no Claude Code, o espelho é `.claude/skills`. Em outro agente, leia o `SKILL.md` pelo caminho quando não houver descoberta nativa. O usuário pode pedir em linguagem comum.
- Separe fatos, inferências e propostas. Um arquivo criado não comprova envio, recebimento, sincronização ou execução externa.
- Preserve arquivos e escolhas da pessoa. Leia antes de editar; faça alterações proporcionais ao pedido e não reverta trabalho alheio.
- Use uma fonte por projeto, cliente e lançamento. `04. GESTÃO` consolida registros e referências; não cria outro histórico do mesmo projeto.
Expand Down
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Histórico do boonOS

## 2.1.0-beta.2

- Pré-requisitos explícitos e neutros: qualquer agente com acesso a arquivos locais, incluindo Codex, Claude Code e Gemini CLI.
- Entrada GEMINI.md e instruções oficiais de contexto/skills, sem criar terceiro espelho.
- CI ativada com matriz Linux/macOS/Windows e Python 3.10/3.13.
- ZIP revisado e versionado separadamente da primeira publicação.

## 2.1.0-beta.1

- Duas áreas visíveis, Criativo e Operacional, conectadas pela mesma base de contexto e memória.
Expand Down
7 changes: 7 additions & 0 deletions GEMINI.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# boonOS 2.1 (beta) — entrada para Gemini CLI

@./AGENTS.md

O contrato acima é compartilhado com os outros agentes. Leia os arquivos de contexto indicados nele. As skills estão em `.agents/skills`, sem necessidade de uma terceira cópia.

Para configurar ou retomar, use a skill local `init`. Se ela não aparecer no ambiente instalado, leia `.agents/skills/init/SKILL.md` explicitamente e siga o fluxo. Respeite permissões, personalizações e autorizações vigentes. Registre somente o contexto autorizado nos arquivos de `01. SISTEMA`.
10 changes: 6 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Uma skill orienta um processo. Gerar uma imagem, exportar slides ou conectar um

## Comece pela sua situação

**Sem terminal:** baixe `boonOS-2.1-beta.zip` na [release 2.1](https://github.com/tchelove/boonOS/releases/tag/v2.1.0-beta.1), extraia e abra a pasta no seu agente. Se o repositório estiver privado, aceite primeiro o convite de acesso. O [guia de instalação](<06. GUIAS/01. INSTALAÇÃO/INSTALAR.md>) acompanha cada passo.
**Sem terminal:** baixe `boonOS-2.1-beta.zip` na [release 2.1](https://github.com/tchelove/boonOS/releases/tag/v2.1.0-beta.2), extraia e abra a pasta no seu agente. Se o repositório estiver privado, aceite primeiro o convite de acesso. O [guia de instalação](<06. GUIAS/01. INSTALAÇÃO/INSTALAR.md>) acompanha cada passo.

**Com Git instalado:** clone esta edição explicitamente:

Expand All @@ -27,15 +27,17 @@ git clone --branch beta/2.1 --single-branch https://github.com/tchelove/boonOS.g
cd meu-sistema
~~~

Abra a pasta no agente que você utiliza, com acesso à sua conta: Codex ou Claude Code. Na linha de comando, execute `codex` **ou** `claude` dentro dela. Em um aplicativo que permita abrir uma pasta local, selecione `meu-sistema`.
O requisito é **um agente de IA capaz de ler e trabalhar nos arquivos da pasta**, com acesso à sua conta nesse agente. Pode ser Codex, Claude Code, Gemini CLI ou outro agente com esse recurso. Você não precisa de uma conta Anthropic para usar o boonOS com outro fornecedor.

Na linha de comando, execute `codex`, `claude` **ou** `gemini` dentro da pasta, conforme o agente instalado. Em um aplicativo que permita abrir uma pasta local, selecione `meu-sistema`. Um chat sem acesso à pasta exige fornecer os arquivos e salvar as saídas manualmente.

Comece com esta mensagem:

> Me guia na configuração deste sistema. Quero entender o que ele pode fazer e começar por um problema real meu. Use a skill local init.

O onboarding oferece dois ritmos: **resolver uma primeira missão** ou **aprofundar a configuração**. Ele pergunta em blocos curtos, mostra possibilidades criativas e operacionais, confirma o que entendeu e registra apenas o contexto autorizado. Você pode pausar e retomar pelo resumo salvo.

O contrato local usa `AGENTS.md` e `.agents/skills` no Codex; `CLAUDE.md` encaminha para o mesmo contexto e `.claude/skills` no Claude Code. A presença desses arquivos não comprova teste em toda versão ou sistema operacional. O [guia de instalação](<06. GUIAS/01. INSTALAÇÃO/INSTALAR.md>) explica como conferir a leitura no seu ambiente.
O contrato comum é `AGENTS.md`. Codex usa `.agents/skills`; Claude Code entra por `CLAUDE.md` e usa o espelho `.claude/skills`; Gemini CLI entra por `GEMINI.md` e pode descobrir a mesma árvore `.agents/skills`. Em outro agente, peça a leitura do contrato e da skill pelo caminho. A presença desses arquivos não comprova teste em toda versão ou sistema operacional. O [guia de instalação](<06. GUIAS/01. INSTALAÇÃO/INSTALAR.md>) explica como conferir a leitura no seu ambiente.

## Onde cada coisa fica

Expand Down Expand Up @@ -73,4 +75,4 @@ O agente respeita autorizações já dadas para a tarefa. Preparar uma proposta,
- [Ferramentas e extensões](<06. GUIAS/02. POSSIBILIDADES/MODULOS-FUTUROS.md>): o que depende de configuração.
- [Atualizar uma instalação](<06. GUIAS/01. INSTALAÇÃO/ATUALIZAR.md>): preservar contexto e personalizações.

Para manter o pacote: [publicar uma versão](<06. GUIAS/01. INSTALAÇÃO/PUBLICAR.md>). Esta é a edição **2.1 beta**, identificada como `v2.1.0-beta.1`.
Para manter o pacote: [publicar uma versão](<06. GUIAS/01. INSTALAÇÃO/PUBLICAR.md>). Esta é a edição **2.1 beta**, identificada como `v2.1.0-beta.2`.
4 changes: 2 additions & 2 deletions VALIDACAO.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,9 +31,9 @@ A contagem vigente de testes está na saída do comando e no GitHub Actions. Os

## Compatibilidade e integração

A configuração [check.workflow.yml](<06. GUIAS/01. INSTALAÇÃO/check.workflow.yml>) está preparada para Linux, macOS e Windows com Python 3.10 e 3.13. **Ela não está ativa e a matriz não foi executada nesta release.** A credencial de publicação não tem o escopo `workflow`; a ativação depende de uma sessão/permissão apropriada. Os resultados verificados nesta edição são os testes locais descritos acima. Consulte [ativar CI](<06. GUIAS/01. INSTALAÇÃO/ATIVAR-CI.md>) para o passo pendente.
O workflow `.github/workflows/check.yml` está ativo. A primeira execução completa, no commit `36fb9cc`, passou nas seis combinações de Linux, macOS e Windows com Python 3.10 e 3.13: [resultado da matriz](https://github.com/tchelove/boonOS/actions/runs/36204735331). Cada combinação executou estrutura/hashes, suíte de testes, exemplo financeiro e exportação. Para a revisão que você estiver usando, confira também o commit exato em [GitHub Actions](https://github.com/tchelove/boonOS/actions). Consulte [manter CI](<06. GUIAS/01. INSTALAÇÃO/ATIVAR-CI.md>) ao configurar outra cópia.

Os contratos de entrada para Codex e Claude Code e seus mirrors estão incluídos. Descoberta de skills, autenticação, geração de mídia e experiência do aplicativo dependem da versão e dos recursos instalados. Um teste do núcleo Python no Windows não comprova um onboarding completo no aplicativo Windows.
Os contratos de entrada para Codex, Claude Code e Gemini CLI estão incluídos. Gemini importa o contrato comum e usa a mesma árvore .agents/skills, conforme a documentação oficial; não foi executado um onboarding no aplicativo Gemini CLI nesta avaliação. Descoberta de skills, autenticação, geração de mídia e experiência do aplicativo dependem da versão e dos recursos instalados. Um teste do núcleo Python no Windows não comprova um onboarding completo no aplicativo Windows.

O roteiro de [onboarding](<06. GUIAS/03. EXEMPLOS/ONBOARDING.md>) permite testar conversa, checkpoint e retomada. O exemplo de [criação](<06. GUIAS/03. EXEMPLOS/CRIACAO.md>) separa direção, artefato e aprovação. Testes simulados com agentes não substituem a observação de alguém instalando pela primeira vez.

Expand Down
2 changes: 1 addition & 1 deletion boonos.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "boonOS",
"version": "2.1.0-beta.1",
"version": "2.1.0-beta.2",
"schema_version": 1,
"catalog": "01. SISTEMA/CATALOGO.json",
"canonical_skills": ".agents/skills",
Expand Down
Loading
Loading