see-harness-lite

Pacote estático de agentes (Maestro + 6 especialistas) e skills OpenCode da Secretaria de Estado de Educação de MG.

Distribui um snapshot fixo de 7 definições de agentes e 35 skills em markdown, prontos para uso no OpenCode. Sem nuvem, sem telemetria, sem dependências.

Propósito

Padronizar a esteira interna de desenvolvimento em um pacote instalável com um único comando. Cada agente é um arquivo .md no formato nativo do OpenCode (frontmatter YAML + corpo), instalado em ~/.config/opencode/agent/. Cada skill é uma pasta <nome>/SKILL.md instalada em ~/.config/opencode/skill/.

Pré-requisitos

• OpenCode instalado
• Node.js 18 ou superior

Instalação

npx see-harness-lite

O comando instala os 7 agentes em ~/.config/opencode/agent/ e as 35 skills em ~/.config/opencode/skill/ (criando os diretórios se necessário). Ao final, reabra o OpenCode para que agentes e skills sejam carregados.

Se algum arquivo de destino já existir com conteúdo diferente, a instalação é abortada por segurança — use --yes para sobrescrever.

Agentes incluídos

| Agente | Mode | Missão | |---|---|---| | Maestro (maestro) | primary | Orquestrador central da esteira — decompõe, delega e valida entregas de ponta a ponta | | Backend Developer (backend-developer) | subagent | Implementa Server Actions, endpoints de API e lógica de validação no servidor | | Frontend Developer (frontend-developer) | subagent | Codifica interfaces React/TypeScript/Tailwind sem lógica acoplada ao banco | | Supabase Specialist (supabase-specialist) | subagent | Modela schemas, migrações SQL e políticas RLS do Supabase | | Code Reviewer (code-reviewer) | subagent | Revisão de código em 5 eixos: corretude, legibilidade, arquitetura, segurança e performance | | Git Specialist (git-master) | subagent | Gerencia branches, commits, PRs e versionamento | | Documentation Specialist (documentation-specialist) | subagent | Mantém documentação técnica e de produto rastreável a PRDs, regras de negócio, decisões, alterações e evidências |

Skills incluídas

As 35 skills estão agrupadas por área de atuação. Cada uma é uma pasta <nome>/SKILL.md instalada em ~/.config/opencode/skill/.

Orquestração e Planejamento

| Skill | Descrição | |---|---| | using-agent-skills | Descobre e invoca skills de agente; metahabilidade de descoberta e seleção de skills por tarefa | | orchestrate-pipeline | Orquestra a esteira de desenvolvimento do Maestro, coordenando agentes e etapas de execução | | monitor-agents | Monitora agentes em execução na esteira, acompanhando progresso e resultados para o orquestrador | | conflict-resolution | Resolve conflitos de pipeline: arquivos em disputa, mudanças concorrentes e coordenação entre agentes | | planning-and-task-breakdown | Quebra trabalho em tarefas ordenadas e estimáveis a partir de requisitos ou especificação | | context-engineering | Otimiza o contexto do agente: setup de sessão, regras de projeto e correção de qualidade degradada | | idea-refine | Refina ideias brutas em conceitos acionáveis por pensamento divergente e convergente estruturado | | interview-me | Extrai a intenção real do usuário por entrevista de uma pergunta por vez até ~95% de confiança | | spec-driven-development | Cria especificações antes de codificar, quando requisitos são incertos ou inexistentes | | incremental-implementation | Entrega alterações de forma incremental, quebrando trabalho grande em etapas menores |

Frontend

| Skill | Descrição | |---|---| | frontend-ui-engineering | Constrói interfaces de nível de produção, do layout ao gerenciamento de estado | | react-components | Detalha o processo para codificar componentes React reutilizáveis, tipados e de nível de produção | | nextjs-app-router | Estrutura páginas, layouts, server components e data fetching no App Router do Next.js | | pwa-setup | Configura Progressive Web App: manifest, service worker e suporte offline | | bundle-optimization | Reduz o tamanho do bundle e o carregamento inicial para melhorar a performance | | api-routes | Padroniza rotas de API e server actions com validação, autenticação e respostas consistentes |

Backend e Dados

| Skill | Descrição | |---|---| | api-and-interface-design | Orienta o design estável de APIs, interfaces e limites entre módulos, frontend e backend | | edge-functions | Implementa Edge Functions para lógica de servidor leve e próxima ao cliente | | migrations | Cria, aplica e versiona migrações de banco de dados de forma segura | | schema-design | Modela schemas de banco de dados para tarefas de desenvolvimento | | data-modeling | Modela dados persistentes — entidades, relações e tipos — antes de implementar | | seed-data | Cria e mantém dados de seed realistas para desenvolvimento e testes | | rls-policies | Escreve e audita políticas de Row Level Security (RLS) no banco |

Qualidade e Review

| Skill | Descrição | |---|---| | code-review-and-quality | Conduz revisão de código multieixo (corretude, legibilidade, arquitetura, segurança e performance) antes do merge | | test-driven-development | Direciona o desenvolvimento orientado a testes ao implementar lógica, corrigir bugs ou mudar comportamento | | bug-detection | Detecta e diagnostica bugs por varredura sistemática de fluxos e sinais de erro | | code-simplification | Simplifica código para clareza sem mudar comportamento | | rls-testing | Valida políticas RLS testando permissões e possíveis vazamentos entre papéis e tenants | | doubt-driven-development | Submete decisões não triviais a revisão adversarial de contexto fresh antes de considerá-las firmes |

Git e Release

| Skill | Descrição | |---|---| | git-workflow-and-versioning | Estrutura o fluxo de trabalho Git: branches, commits, resolução de conflitos, releases e versionamento | | repo-setup | Prepara a estrutura inicial do repositório: arquivos base, ferramentas e convenções | | release-manager | Gerencia releases: escolha de versão semântica, changelog, tags e publicação | | shipping-and-launch | Prepara lançamentos em produção com checklist de pré-lançamento e estilo de rollback |

Documentação

| Skill | Descrição | |---|---| | documentation-and-adrs | Registra decisões e documentação (incluindo ADRs) com contexto para engenheiros e agentes futuros | | source-driven-development | Baseia cada decisão de implementação em documentação oficial, com código citado na fonte |

Flags disponíveis

| Flag | Descrição | |---|---| | --help, -h | Mostra a ajuda | | --list | Lista os 7 agentes e as 35 skills do pacote e indica se já estão instalados no destino | | --yes | Sobrescreve arquivos de destino conflitantes sem perguntar | | --uninstall | Remove apenas os arquivos gerenciados por este pacote | | --dir <caminho> | Usa uma raiz de destino alternativa (agentes em <caminho>/agent, skills em <caminho>/skill) |

Desinstalação

npx see-harness-lite --uninstall

Remove exclusivamente os arquivos gerenciados por este pacote: os 7 arquivos de agente (identificados por nome de arquivo) e os 35 arquivos SKILL.md das skills (removendo a pasta <nome> se ficar vazia). Nenhum outro arquivo do diretório é tocado.

Notas importantes

• SNAPSHOT fixo (v1.0.0): este pacote distribui 7 definições de agentes e 35 skills capturadas em um momento fixo e não recebe atualizações automáticas. Novas versões são distribuídas como novas versões do pacote.
• Modelo herdado: os agentes não fixam campo model no frontmatter — todos herdam o modelo da sessão OpenCode em uso.
• Agentes e skills: agentes são instalados em ~/.config/opencode/agent/ e skills em ~/.config/opencode/skill/; ao atualizar o pacote, ambos são atualizados juntos.
• Sem rede, sem telemetria, sem coleta de dados.