Imported from torriani/agentesIA (skills/coreai-context-create/SKILL.md). Install upstream with npx skills add torriani/agentesIA --skill coreai-context-create. Copyright stays with the author.

ContextOS - Sistema Operacional de Contexto

Sistema que constroi e gerencia o contexto completo de empresas dentro do workspace do usuario. Coleta, organiza e disponibiliza todas as informacoes de negocio para que agentes, skills e squads tenham contexto rico ao executar qualquer tarefa.

Quando Usar

• Usuario quer configurar o contexto da sua empresa
• Usuario quer adicionar uma nova empresa ao workspace
• Usuario precisa popular informacoes de negocio (perfil, marca, ICP, pricing)
• Usuario precisa de um design system documentado
• Usuario quer registrar reunioes, decisoes e inteligencia acumulada
• Qualquer agente ou squad precisa consultar dados de contexto de uma empresa

Comandos

Estrutura do ContextOS

context-os/
├── config.yaml              # Config global + empresa ativa + lista de empresas
├── user.yaml                # Identidade do dono (nome, role, preferencias)
│
├── dashboard/               # Painel de controle
│   ├── overview.yaml        # Snapshot consolidado
│   └── health-report.yaml   # Ultima auditoria
│
├── skills/                  # Skills compartilhadas (todas as empresas)
│   └── registry.yaml        # Catalogo de skills instaladas
│
├── agents/                  # Agentes compartilhados
│   └── registry.yaml        # Catalogo de agentes
│
├── squads/                  # Squads compartilhados
│   └── registry.yaml        # Catalogo de squads
│
└── businesses/              # Separacao por empresa
    └── {slug}/
        ├── context/         # Perfil completo da empresa
        ├── brand-dna/       # DNA da marca
        ├── design-system/   # DS - Design System
        ├── products/        # Produtos
        ├── culture/         # Cultura organizacional
        ├── operations/      # Operacoes
        ├── intelligence/    # Memoria e inteligencia acumulada
        └── evidence/        # Rastreabilidade e fontes

Escopo por Empresa vs Compartilhado

Workflow: *init

Inicializacao do ContextOS no workspace.

Pre-condicoes

• Diretorio do workspace deve existir

Execucao

1. Criar diretorio context-os/ na raiz do workspace
2. Criar config.yaml a partir do template em references/templates/config.yaml
3. Elicitar informacoes do usuario (nome, role, preferencias) e preencher user.yaml
4. Criar diretorios compartilhados: dashboard/, skills/, agents/, squads/, businesses/
5. Criar registries vazios nos diretorios compartilhados
6. Confirmar inicializacao com resumo

Output

• context-os/config.yaml
• context-os/user.yaml
• Diretorios compartilhados criados

Workflow: *add-business {slug}

Adiciona nova empresa ao ContextOS com scaffold completo.

Pre-condicoes

• ContextOS inicializado (config.yaml existe)
• Slug unico (snake_case, sem espacos)

Execucao

1. Validar slug (snake_case, nao duplicado)
2. Criar diretorio businesses/{slug}/
3. Criar subdiretorios: context/, brand-dna/, design-system/, products/, culture/, operations/, intelligence/, intelligence/meetings/, intelligence/decisions/, evidence/
4. Copiar templates YAML de references/templates/business/ para cada subdiretorio
5. Registrar empresa em config.yaml
6. Apresentar resumo do scaffold

Templates Copiados (por empresa)

context/ (9 arquivos):

• company-profile.yaml, founder-dna.yaml, credentials.yaml, icp.yaml, brand.yaml, pricing.yaml, team.yaml, diagnosis.yaml, authority-story.yaml

brand-dna/ (5 arquivos):

• voice.yaml, visual-identity.yaml, archetype.yaml, positioning.yaml, manifesto.yaml

design-system/ (4 arquivos):

• tokens.yaml, components.yaml, patterns.yaml, guidelines.yaml

culture/ (4 arquivos):

• values.yaml, pillars.yaml, commandments.yaml, hiring-criteria.yaml

operations/ (3 arquivos):

• kpis.yaml, processes.yaml, tech-stack.yaml

evidence/ (3 arquivos):

• completeness.yaml, source-registry.yaml, etl-history.yaml

Output

• Diretorio completo da empresa com 28 templates YAML
• config.yaml atualizado

Workflow: *setup-context {slug}

Pipeline interativo de 6 fases para coletar o contexto completo da empresa. Baseado no business-profile-pipeline do workspace squad, adaptado para o ContextOS.

Pre-condicoes

• Empresa adicionada via *add-business
• Templates scaffolded

Fases

Fase 0: Pre-Flight (~2 min)

• Validar empresa existe e templates estao scaffolded
• Carregar contexto parcial (se resumindo de pausa anterior)
• Apresentar visao geral das 6 fases

Fase 1: Formulario Basico (~15 min)

Metodo: FORM (respostas curtas e diretas) Coleta: Essencia da empresa, missao, visao basica Output: context/company-profile.yaml (parcial, ~35%) Gate: Secao company_essence COMPLETE

Fase 2: Deep Dive Fundador (~40 min)

Metodo: INTERVIEW (conversacional, profundo) Coleta: Historia de origem (4 atos), credenciais, background profissional Output: context/founder-dna.yaml + context/credentials.yaml Gate: founder-dna.yaml >= 85% completeness

Fase 3: Empresa + Time (~30 min)

Metodo: INTERVIEW + FORM Coleta: Company profile completo, estrutura do time, metricas Output: context/company-profile.yaml (completo) + context/team.yaml Gate: company-profile.yaml >= 85% completeness

Fase 4: ICP Completo (~30 min)

Metodo: INTERVIEW Coleta: Demographics, psychographics, pain stack (3 niveis), arquetipos, triggers Output: context/icp.yaml + context/diagnosis.yaml Gate: icp.yaml >= 85% completeness

Inclui Diagnosis Gate:

• market_awareness_level (1-5)
• market_sophistication_stage (1-5)

Fase 5: Brand + Pricing (~25 min)

Metodo: INTERVIEW + FORM Coleta: DNA da marca, personalidade (escalas 1-10), voice DNA, pricing psychology Output: context/brand.yaml + context/pricing.yaml Gate: brand.yaml >= 85% completeness

Apos conclusao, propagar dados de marca para brand-dna/:

• Extrair voice DNA -> brand-dna/voice.yaml
• Extrair archetype -> brand-dna/archetype.yaml
• Extrair positioning -> brand-dna/positioning.yaml

Fase 6: Enriquecimento + Validacao (~10 min, automatizado)

Metodo: SYNTHESIZED (sem input do usuario) Acoes automaticas:

1. Cross-reference ICP <-> Company Profile (verificar alinhamento)
2. Cross-reference Brand <-> Founder DNA (verificar coerencia)
3. Gerar context/authority-story.yaml (sintese automatica)
4. Calcular completeness global
5. Produzir relatorio

Output: context/authority-story.yaml + evidence/completeness.yaml Gate Final: Todos os 7 YAMLs core >= 85%

Pause/Resume

• Responder "pausar" em qualquer gate suspende o pipeline
• Executar *setup-context {slug} novamente detecta progresso parcial e oferece retomar

Workflow: *set-active {slug}

1. Validar que empresa existe em config.yaml
2. Atualizar config.yaml com active_business: {slug}
3. Confirmar: "Empresa ativa: {nome} ({slug})"

Workflow: *status

1. Ler config.yaml para listar empresas
2. Para cada empresa, calcular completeness de cada YAML core
3. Apresentar dashboard:

╔══════════════════════════════════════════╗
║         ContextOS Dashboard              ║
╠══════════════════════════════════════════╣
║ Empresa Ativa: torriani                    ║
╠══════════════════════════════════════════╣
║ torriani          ████████░░ 82%           ║
║   Company Profile  ██████████ 95%        ║
║   Founder DNA      █████████░ 90%        ║
║   ICP              ████████░░ 80%        ║
║   Brand            █████████░ 88%        ║
║   Pricing          ██████░░░░ 65%        ║
║   Team             ████████░░ 78%        ║
║   Design System    ██░░░░░░░░ 20%        ║
╠══════════════════════════════════════════╣
║ meu-ecommerce    ███░░░░░░░ 30%          ║
║   (setup incompleto)                     ║
╚══════════════════════════════════════════╝

Workflow: *health-check

1. Validar estrutura de diretorios (todos os subdirs existem)
2. Validar sintaxe YAML de todos os arquivos
3. Verificar campos placeholder nao preenchidos (FILL_THIS, TBD, null, "")
4. Verificar consistencia cross-reference (ICP <-> Company Profile)
5. Apresentar relatorio de saude

Completeness Engine

Calculo de Completeness

Para cada YAML:

1. Contar campos totais (excluindo metadata)
2. Contar campos preenchidos (excluindo placeholders)
3. Formula: (preenchidos / total) * 100

Valores Considerados Placeholder (nao preenchidos)

• null, "", ~, "null"
• FILL_THIS, TBD, TODO, INCOMPLETE, PREENCHER, N/A
• Regex: ^FILL[_ ]?, ^TODO:, ^TBD:
• Arrays vazios [], objetos vazios {}
• NOTA: 0 e false sao valores REAIS, nao placeholders

Gates

• < 85%: Nao pode avancar para proxima fase (pode pausar)
• >= 85%: Gate passa, proxima fase liberada
• 100%: Contexto validavel contra analytics

Intelligence Layer

Registrar Reuniao

Ao registrar uma reuniao ou interacao importante:

# intelligence/meetings/YYYY-MM-DD-{topic}.yaml
date: "2026-04-03"
type: kickoff | followup | strategy | review
participants:
  - nome
duration: 60min
topics:
  - Topico discutido
decisions:
  - Decisao tomada
action_items:
  - Acao pendente
insights:
  - Insight extraido
context_updates:
  - file: context/icp.yaml
    field: core_icp.company_size
    new_value: "10-50 funcionarios"

Registrar Decisao

# intelligence/decisions/YYYY-MM-DD-{decision}.yaml
date: "2026-04-03"
decision: "Descricao da decisao"
rationale: "Por que foi decidido"
impact:
  - O que muda
  - Onde impacta
reversible: true | false
decided_by: nome

Memory Index

intelligence/memory-index.yaml consolida um indice pesquisavel de todas as reunioes e decisoes, atualizado automaticamente ao registrar novos itens.

Elicitation Guidelines

Principios de Coleta

1. Zero invencao: Todos os dados vem do usuario, nunca inventados
2. Conversacional: Perguntas em tom natural, nao interrogatorio
3. Progressivo: Comecar com o basico, aprofundar gradualmente
4. Pause/Resume: Sempre permitir pausar e retomar depois
5. Contexto anterior: Usar respostas anteriores para informar proximas perguntas

Formato de Perguntas por Metodo

FORM (respostas curtas):

1. Qual o nome legal da empresa?
2. E o nome fantasia (como as pessoas conhecem)?
3. Ano de fundacao?
4. Sede (cidade/estado)?

INTERVIEW (conversacional):

Me conta a historia de como tudo comecou. O que voce fazia antes?
O que aconteceu que te fez mudar de rumo?
E o momento de virada — quando voce percebeu que isso era o caminho?

Campos Obrigatorios vs Opcionais

Cada template YAML marca campos como required ou optional no metadata. Durante a elicitacao:

• Campos required: Insistir ate obter resposta
• Campos optional: Oferecer pular ("Posso pular esse se preferir")

Templates Reference

Todos os templates YAML de referencia estao em references/templates/. Consultar esses arquivos para a estrutura exata de cada YAML ao executar o scaffold ou a elicitacao.

Templates Disponiveis