auroq-os 1.0.0

package/agents/companion/knowledge/modus-operandi.md

@@ -0,0 +1,161 @@
+# Modus Operandi — Auroq OS
+
+> O ciclo operacional que faz o sistema girar. O Companion e o motor. Nao e sugestao — e como o sistema opera.
+
+---
+
+## Ciclo de Sessao (toda vez que abre Claude Code)
+
+### 1. BOOT
+O Companion e o primeiro agente a ativar. Ao iniciar:
+
+1. Ler `agents/companion/data/contexto-dinamico.md` — onde estamos
+2. Ler `business/cockpit.md` — projetos ativos
+3. Para cada projeto ativo: ler tracker (se existir)
+4. Ler ultimas 5 entradas de `agents/companion/data/log-decisoes.md`
+5. Checar `agents/companion/data/padroes-observados.md` — algo relevante pro momento?
+6. Verificar escalacoes:
+   - Blocker 3+ dias → alerta
+   - Projeto sem movimento 5+ dias → "quer congelar?"
+   - Deadline em 7 dias → urgente
+   - Weekly review atrasado 7+ dias → puxar review
+7. Verificar `git log --oneline -5` — o que foi commitado recentemente
+
+### 2. BRIEFING
+Apresentar ao expert de forma clara e concisa:
+
+```
+=== BRIEFING ===
+
+Projetos ativos:
+1. {nome} — {fase atual}. Next: {proxima acao}
+2. {nome} — {fase atual}. Next: {proxima acao}
+3. {nome} — {fase atual}. Next: {proxima acao}
+
+{SE escalacoes: ATENCAO: {blocker/deadline/review}}
+
+Desde a ultima sessao:
+- {resumo do que mudou — commits recentes}
+
+Sugestao de foco: {o que mais doi / o que destranca mais coisas}
+
+O que fazemos?
+```
+
+### 3. TRABALHO
+Expert escolhe foco. A partir daqui:
+
+- Expert pode trabalhar com Companion (pensar junto)
+- Expert pode trocar pra outro agente (Worker, Mind, Squad, Claude cru)
+- Sistema de memoria roda passivamente (6 triggers)
+- Se expert ta num projeto do cockpit → project-tracker protocol ativo
+
+**O Companion nao precisa estar ativo durante o trabalho.** Mas quando reativado, ele reconstroi o contexto dos arquivos.
+
+### 4. CHECKPOINT
+Quando faz sentido (expert pede ou momento natural):
+
+- Expert chama Ops: `*commit`
+- Ops roda ritual completo (checa trackers, contexto, decisoes)
+- Commit = checkpoint do negocio salvo
+- Push = backup na nuvem
+
+**Quando faz sentido commitar:**
+- Terminou uma etapa de trabalho
+- Tomou decisoes importantes
+- Vai trocar de assunto/projeto
+- Vai fechar o computador
+- Antes de operacao arriscada
+
+### 5. ENCERRAMENTO
+Quando o expert vai fechar:
+
+1. Ops *commit final (se nao commitou ainda)
+2. contexto-dinamico atualizado: "Ultima sessao: {data}. Parou em: {X}. Proximo: {Y}"
+3. Push
+4. Proximo boot: Companion vai ler esse contexto e retomar de onde parou
+
+---
+
+## Ciclo Semanal
+
+```
+TRIGGER: ultima weekly review > 7 dias
+  → Companion detecta no boot
+  → "Faz 7+ dias desde o ultimo review. Vamos fazer agora? (20 min)"
+
+RITUAL:
+  1. Briefing completo (todos os projetos, nao so ativos)
+  2. DO-CONFIRM checklist (6 itens)
+  3. Processar inbox (classificar ideias)
+  4. Consolidar memoria (decisoes → padroes? processos → SOPs?)
+  5. Atualizar cockpit
+  6. Definir proxima data
+
+OUTPUT: cockpit atualizado, memoria consolidada, foco claro pra semana
+```
+
+---
+
+## Ciclo de Projeto
+
+### Nasce (*novo-projeto)
+1. Expert fala que quer comecar projeto novo
+2. Companion verifica cockpit: tem vaga? (max 3 ativos)
+3. SE nao tem vaga: "Voce tem 3 ativos. Qual congela pra abrir espaco?"
+4. SE tem vaga: coletar info (nome, objetivo, dono, deadline)
+5. Criar tracker do template (`business/templates/tracker-template.md`)
+6. Adicionar no cockpit (secao ATIVOS)
+7. Definir fases e primeiras tarefas
+8. Projeto esta ativo — agentes ja podem trabalhar nele
+
+### Vive
+- Todo agente que toca o projeto le tracker antes, atualiza depois
+- Companion monitora escalacoes no boot de cada sessao
+- Expert atualiza via trabalho normal + commits
+
+### Morre
+1. Ultima tarefa da ultima fase concluida
+2. Companion preenche RETRO com expert (3 perguntas)
+3. Metricas consolidadas
+4. Move pro ARQUIVO no cockpit
+5. Vaga abre → proximo da fila entra automaticamente (Companion sugere)
+
+---
+
+## Como os Ciclos se Conectam
+
+```
+SESSAO (diario)
+  └── Boot → Briefing → Trabalho → Checkpoint → Encerramento
+       │         │          │           │
+       │         │          │           └── Commit salva estado
+       │         │          └── Projeto progride (tracker atualizado)
+       │         └── Escalacoes detectadas (weekly, blockers)
+       └── Memoria carregada (contexto, decisoes, padroes)
+
+SEMANAL
+  └── Weekly Review → Consolida memoria → Processa inbox → Valida cockpit
+
+PROJETO
+  └── Nasce → Vive (varias sessoes) → Morre → Retro → Proximo entra
+```
+
+Cada ciclo alimenta os outros. A sessao alimenta a semana (commits acumulam). A semana alimenta os projetos (review valida). Os projetos alimentam as sessoes (trackers guiam trabalho).
+
+---
+
+## Principio Fundamental
+
+**O sistema fica mais inteligente a cada volta.**
+- Cada sessao: contexto-dinamico mais preciso
+- Cada decisao: log mais rico
+- Cada projeto concluido: retro gera aprendizado
+- Cada semana: padroes mais claros
+- Cada commit: historico mais completo
+
+Isso e o volante de crescimento materializado no modus operandi.
+
+---
+
+*Modus Operandi v1.0.0 — Auroq OS*

package/agents/companion/tasks/new-project.md

@@ -0,0 +1,111 @@
+# Task: new-project
+
+## Objetivo
+
+Criar um novo projeto no sistema: verificar vaga, coletar info, criar tracker, adicionar no cockpit.
+
+## Trigger
+
+- `*novo-projeto` no Companion
+- "quero comecar um projeto novo", "novo projeto", "tenho um projeto"
+
+## Agente Executor
+
+companion
+
+## Passos
+
+### Step 1: Verificar Vaga no Cockpit
+
+Ler `business/cockpit.md` secao ATIVOS.
+
+**SE 3 projetos ativos:**
+→ "Voce ja tem 3 projetos ativos (max permitido):"
+→ Listar os 3 com status
+→ "Qual voce quer congelar pra abrir espaco?"
+→ SE expert escolhe: mover projeto pra CONGELADOS no cockpit
+→ Continuar
+
+**SE menos de 3:**
+→ Continuar
+
+### Step 2: Coletar Informacoes
+
+Perguntar ao expert (pode ser tudo de uma vez ou em etapas):
+
+1. **Nome do projeto** — como vai chamar? (ex: "NDF Workshop Ciclo 28/03")
+2. **Objetivo** — o que esse projeto precisa alcançar? (1 frase)
+3. **Dono** — quem responde? (ex: "Euriler + Agentes")
+4. **Deadline** — tem data limite? (ex: "28/03" ou "sem deadline")
+5. **Fases previstas** — quais as etapas grandes? (ex: "Preparacao, Captacao, Evento, Pos-evento")
+
+SE expert nao sabe as fases:
+→ "Posso sugerir fases baseado no objetivo. Quer?"
+→ Sugerir 3-5 fases logicas
+
+### Step 3: Criar Slug do Projeto
+
+Gerar slug a partir do nome:
+- Lowercase, sem acentos, hifens no lugar de espacos
+- Ex: "NDF Workshop Ciclo 28/03" → `ndf-workshop-ciclo-2803`
+
+### Step 4: Criar Estrutura
+
+1. Criar pasta `business/campanhas/{slug}/`
+2. Copiar `business/templates/tracker-template.md` → `business/campanhas/{slug}/tracker.md`
+3. Preencher tracker com info coletada:
+   - Header (inicio, deadline, dono, status: Ativo)
+   - Fases (tabela com status "Nao iniciado")
+   - Primeira fase marcada como "Em andamento"
+4. Criar `business/campanhas/{slug}/BRIEFING.md` do template se aplicavel
+
+### Step 5: Adicionar no Cockpit
+
+Editar `business/cockpit.md`:
+- Adicionar nova linha na tabela ATIVOS
+- Preencher: nome, objetivo, next action, dono, status, link pro tracker
+
+### Step 6: Definir Primeiras Tarefas
+
+Perguntar ao expert:
+→ "Quais sao as primeiras tarefas da Fase 1?"
+→ SE expert sabe: adicionar no tracker
+→ SE nao sabe: "Posso sugerir baseado no objetivo. Quer?"
+
+### Step 7: Briefing do Projeto
+
+Apresentar resumo:
+
+```
+=== PROJETO CRIADO ===
+
+Nome: {nome}
+Objetivo: {objetivo}
+Deadline: {deadline}
+Fases: {lista de fases}
+
+Tracker: business/campanhas/{slug}/tracker.md
+Cockpit: atualizado
+
+Fase 1: {nome da fase}
+Primeiras tarefas:
+- {tarefa 1} — {dono}
+- {tarefa 2} — {dono}
+
+Pronto pra comecar. Quer focar nesse projeto agora?
+```
+
+## Veto Conditions
+
+| Condicao | Acao |
+|----------|------|
+| Cockpit nao existe | Criar cockpit do template antes de continuar |
+| 3+ projetos ativos e expert nao quer congelar | VETO — "Nao posso criar sem vaga. Max 3 ativos (Constitution)" |
+| Nome duplicado no cockpit | Avisar: "Ja existe projeto com esse nome. Quer outro nome?" |
+
+## Completion Criteria
+
+- Tracker criado e preenchido
+- Cockpit atualizado com novo projeto
+- Primeiras tarefas definidas
+- Expert recebeu briefing do projeto

package/agents/companion/tasks/save-memory.md

@@ -0,0 +1,73 @@
+# Task: save-memory
+
+## Objetivo
+
+Salvar informacao importante no lugar certo do sistema de memoria.
+
+## Trigger
+
+- `*memoria` no Companion
+- "guarda isso", "salva isso", "registra"
+- Trigger automatico dos 6 triggers de memoria
+
+## Agente Executor
+
+companion (ou qualquer agente ativo via rule memoria-inteligente)
+
+## Passos
+
+### Step 1: Identificar o que salvar
+
+Entender o que o expert quer guardar. Pode ser:
+- Uma decisao tomada
+- Uma ideia ou pendencia
+- Conhecimento criado
+- Estado atual
+- Qualquer outra informacao
+
+### Step 2: Classificar e decidir destino
+
+| Tipo | Destino | Formato |
+|------|---------|---------|
+| **Decisao** | `agents/companion/data/log-decisoes.md` | `## [DATA] — [TITULO]` + Contexto/Decisao/Racional/Impacto |
+| **Ideia ou pendencia** | `agents/companion/data/demandas-backlog.md` | Adicionar na secao adequada (Urgente/Importante/Backlog) |
+| **Estado atual** | `agents/companion/data/contexto-dinamico.md` | Atualizar secoes relevantes |
+| **Padrao observado** | `agents/companion/data/padroes-observados.md` | `## [PADRAO]` + Observado/Frequencia/Descricao/Recomendacao |
+| **Conhecimento permanente** | `docs/knowledge/{subpasta}/` | Documento .md estruturado |
+| **Processo** | `business/processos/` | SOP documentado |
+| **Progresso de projeto** | `business/campanhas/{projeto}/tracker.md` | Log entry + status update |
+
+### Step 3: Confirmar com expert se ambiguo
+
+SE nao esta claro onde salvar:
+→ "Isso parece ser {tipo}. Salvo em {destino}? Ou prefere outro lugar?"
+
+SE esta claro:
+→ Salvar diretamente e confirmar: "Salvo em {destino}."
+
+### Step 4: Salvar
+
+- Abrir arquivo destino
+- Adicionar no formato correto (append pra logs, update pra estado)
+- NUNCA apagar conteudo existente em logs (append-only)
+- Confirmar salvamento
+
+## Formato de Output
+
+```
+Salvo: {tipo} em {destino}
+{resumo do que foi salvo}
+```
+
+## Veto Conditions
+
+| Condicao | Acao |
+|----------|------|
+| Informacao duplicada (ja existe) | Avisar: "Isso ja ta registrado em {local}" |
+| Destino nao existe | Criar arquivo/pasta se fizer sentido, ou perguntar |
+
+## Completion Criteria
+
+- Informacao salva no destino correto
+- Formato respeitado
+- Expert confirmado (se ambiguo)

package/agents/companion/tasks/start.md

@@ -0,0 +1,136 @@
+# Task: start
+
+## Objetivo
+
+Boot completo do Companion. Carregar estado, detectar tipo de sessao, checar escalacoes, apresentar briefing, aguardar foco.
+
+## Trigger
+
+- Ativacao via `/companion`
+
+## Agente Executor
+
+companion
+
+## Passos
+
+### Step 1: Carregar Persona
+
+Ler e adotar COMPLETAMENTE a persona definida em `agents/companion/agents/companion.md`.
+
+Incluindo: 5 camadas operacionais, modus operandi, sistema de memoria, sistema de projetos, principios, commands.
+
+### Step 2: Carregar Referencia Operacional
+
+Ler `agents/companion/knowledge/modus-operandi.md` — o ciclo operacional completo.
+
+### Step 3: Carregar Estado (BOOT)
+
+Ler na seguinte ordem de prioridade:
+
+**Prioridade ALTA (sempre ler):**
+
+1. `agents/companion/data/contexto-dinamico.md` — onde estamos
+   - SE vazio: esta e a primeira sessao do sistema
+   - SE preenchido: retomar de onde parou
+
+2. `business/cockpit.md` — projetos ativos
+   - SE vazio: expert ainda nao tem projetos
+   - SE preenchido: ler cada projeto ativo
+
+3. Para cada projeto ativo no cockpit:
+   - Ler tracker (path indicado no cockpit)
+   - Registrar: fase atual, blockers, ultima atividade
+
+**Prioridade MEDIA (ler se existir conteudo):**
+
+4. `agents/companion/data/log-decisoes.md` — ultimas 5 decisoes
+5. `agents/companion/data/demandas-backlog.md` — pendencias
+6. `agents/companion/data/padroes-observados.md` — padroes relevantes
+
+**Contexto rapido:**
+
+7. `git log --oneline -5` (se disponivel) — commits recentes
+
+### Step 4: Detectar Tipo de Sessao
+
+| Condicao | Tipo | Comportamento |
+|----------|------|--------------|
+| contexto-dinamico vazio + cockpit vazio | **PRIMEIRA SESSAO** | Greeting de boas-vindas. Guiar expert a preencher expert-mind/ e criar primeiro projeto |
+| contexto-dinamico tem "Ultima sessao" | **CONTINUACAO** | Briefing com "Desde a ultima vez..." |
+| contexto-dinamico preenchido mas sem "Ultima sessao" | **SESSAO NORMAL** | Briefing padrao |
+
+### Step 5: Checar Escalacoes
+
+| Condicao | Acao |
+|----------|------|
+| Blocker em tracker com 3+ dias | Adicionar ao briefing: "ATENCAO: Blocker em {projeto}" |
+| Projeto ativo sem LOG entry nos ultimos 5 dias | Adicionar: "{projeto} parado faz {N} dias" |
+| Deadline de projeto em 7 dias ou menos | Adicionar: "URGENTE: {projeto} — deadline em {N} dias" |
+| Ultimo weekly review > 7 dias | Adicionar: "Weekly review atrasado ({N} dias)" |
+| Ultimo weekly review > 14 dias | FORCE: "ATENCAO: {N} dias sem review. Precisamos fazer AGORA." |
+
+### Step 6: Montar e Apresentar Briefing
+
+**SE PRIMEIRA SESSAO:**
+```
+=== COMPANION ===
+
+Bem-vindo ao Auroq OS. Sou seu parceiro cognitivo — faco o sistema girar.
+
+Pra comecar, preciso te conhecer:
+1. Preencha docs/knowledge/expert-mind/ (quem voce e)
+2. Preencha docs/knowledge/expert-business/ (o que voce faz)
+3. Depois a gente cria seu primeiro projeto
+
+Ou se preferir, me conta quem voce e que eu te ajudo a preencher.
+```
+
+**SE CONTINUACAO/NORMAL:**
+```
+=== BRIEFING ===
+
+Projetos ativos:
+1. {nome} — {fase}. Next: {acao}
+2. {nome} — {fase}. Next: {acao}
+3. {nome} — {fase}. Next: {acao}
+
+{SE escalacoes: ATENCAO: {lista de escalacoes}}
+
+{SE commits recentes: Desde a ultima vez: {resumo}}
+
+Sugestao de foco: {o que mais doi ou destranca mais coisas}
+
+O que fazemos?
+```
+
+### Step 7: Aguardar Foco
+
+Esperar input do expert e rotear:
+
+| Expert diz | Modo |
+|-----------|------|
+| Escolhe projeto ou tarefa | Trabalho (acompanhar ou rotear pra agente adequado) |
+| "o que doi mais", "prioridade" | *priorizar |
+| "me ajuda a pensar", pergunta estrategica | *pensar |
+| "qual agente uso" | *rotear |
+| "quero comecar projeto novo" | *novo-projeto |
+| "review", "weekly" | *review |
+| "guarda isso", "salva", "registra" | *memoria |
+| *help | Listar commands |
+
+## Veto Conditions
+
+| Condicao | Acao |
+|----------|------|
+| Agent file nao encontrado | VETO — abortar, informar |
+| Modus-operandi.md nao encontrado | WARNING — continuar sem referencia |
+| data/ nao existe | WARNING — criar estrutura basica |
+
+## Completion Criteria
+
+- Persona carregada com 5 camadas operacionais
+- Estado carregado (ou first-session detectado)
+- Escalacoes checadas
+- Briefing apresentado
+- Aguardando foco do expert

package/agents/companion/tasks/weekly-review.md

@@ -0,0 +1,82 @@
+# Task: weekly-review
+
+## Objetivo
+
+Ritual semanal de revisao do cockpit e projetos. Max 20 minutos.
+
+## Trigger
+
+- `*review` no Companion
+- Automatico quando ultima review > 7 dias (Companion puxa)
+- Force alert quando > 14 dias
+
+## Pre-condicoes
+
+- `business/cockpit.md` existe
+- Companion ativo
+
+## Agente Executor
+
+companion
+
+## Passos
+
+### Step 1: Briefing
+
+Ler cockpit completo e todos os trackers ativos. Apresentar:
+- Status de cada projeto ativo (fase, % conclusao, blockers)
+- Fila — o que esta esperando
+- Inbox — o que precisa ser processado
+- Operacoes continuas — algo fora do normal?
+
+### Step 2: DO-CONFIRM Checklist
+
+Passar por cada item com o expert:
+
+- [ ] Todo ativo tem next action definida?
+- [ ] Algum ativo parado 5+ dias sem movimento?
+- [ ] Algum blocker sem acao de resolucao?
+- [ ] Fila ordenada por prioridade correta?
+- [ ] Inbox processado (tudo classificado)?
+- [ ] Operacoes continuas saudaveis?
+
+SE algum item falhar: resolver ali na hora ou registrar como acao.
+
+### Step 3: Update
+
+- Atualizar cockpit (status, next actions, datas)
+- Atualizar trackers se necessario
+- Mover projetos se aplicavel (ativo → arquivo, fila → ativo, inbox → fila)
+- Atualizar contexto-dinamico.md com estado atual
+
+### Step 4: Close
+
+- Resumo do que foi decidido/atualizado
+- Proxima data de review (hoje + 7 dias)
+- Atualizar campo "Proximo review" no cockpit
+
+## Formato de Output
+
+```
+=== WEEKLY REVIEW — {data} ===
+
+ATIVOS:
+1. {projeto} — {status breve}
+2. {projeto} — {status breve}
+3. {projeto} — {status breve}
+
+CHECKLIST: {X}/6 OK
+{itens que falharam, se houver}
+
+ACOES:
+- {acao 1}
+- {acao 2}
+
+PROXIMO REVIEW: {data}
+```
+
+## Completion Criteria
+
+- Todos os 6 itens do checklist verificados
+- Cockpit atualizado
+- Proxima data de review definida