Fonte: ~/.pi/agent/skills/commit-msg/SKILL.md, “Core Contract”.

A mensagem de commit gerada DEVE:

1. Corresponder ao estilo e formato dos commits recentes da branch `develop`.
2. Usar tempo passado.
3. Ser multilinha.
4. Ser baseada exclusivamente em alterações de arquivos inspecionadas a partir da entrada solicitada.
5. Evitar alegações que não sejam suportadas pelos dados de diff/stat/name-status.
6. Evitar reutilizar um assunto de espaço reservado como `WIP` do(s) commit(s) de destino.
7. Evitar mutar o estado do git; esta habilidade é somente leitura.

Fonte: ~/.agents/skills/implementation-steps/SKILL.md, contrato de abertura.

Produza um curso de implementação prática para o alvo selecionado. Cada etapa
numerada inclui código-fonte de trabalho real e seu próprio README detalhado. Um aluno que
segue as etapas documentadas deve entender o que está escrevendo e por que, e
alcançar o código de destino capturado exatamente. Correção técnica, igualdade exata de
fonte e ensinabilidade são requisitos separados; nenhum substitui o outro.

Este fluxo de trabalho é independente de linguagem e framework. Inspecione o alvo em vez
de impor um runtime, arquitetura, número fixo de etapas ou escolhas de implementação de
tarefas anteriores. Crie os artefatos de aprendizado; deixe o alvo inalterado.

Fonte: ~/.agents/skills/lightpanda/SKILL.md, “CLI and persistent automation”.

Para uma URL autorizada conhecida, comece com uma extração limitada:

```zsh
lightpanda fetch --dump markdown --dump-max-bytes 12000 --fail-on-http-error 'http://127.0.0.1:PORT/PATH'
```

Substitua a URL por uma URL de aplicação observada. Use `--dump html` para marcação ou `--dump semantic_tree_text` para uma árvore semântica compacta. Inspecione o status e os erros do comando; um dump por si só não é prova de navegação ou interação bem-sucedida.

Fonte: ~/.agents/skills/rex/SKILL.md, arquivo completo.

---
name: rex
description: Use a CLI rex para gerenciar sessões Rex, abrir abas, organizar painéis, executar comandos, inspecionar saída de terminal e controlar apps Rex conectados.
metadata:
  rex-stub: "2"
---


Execute `rex __internal skill` e siga o guia que ele imprime. O guia vem da
CLI Rex instalada, portanto, descreve os comandos disponíveis nessa versão.

Se o comando falhar, a versão do Rex instalada é anterior ao guia. Comece com
`rex whoami --json`, depois use `rex --help` e `rex COMANDO --help`.

Fonte: ~/.agents/skills/ui-sdk/SKILL.md, “Read first”.

A documentação da versão instalada é enviada em cada pacote, como Markdown:

- `node_modules/@ui-sdk//docs/llms.txt` é o índice. Leia-o primeiro. `` é `react`, `vue`, `svelte`, `solid` ou `web`.
- Depois, leia apenas as páginas que sua tarefa precisa, como `docs/components/select.md`. Não leia a pasta `docs/` inteira; ela é grande.
- Uma interface construída a partir de nossos componentes não precisa de `docs/core.md`. Apenas o caminho 2 abaixo precisa, e mesmo assim você pesquisa por cabeçalho: tem mais de 300 KB. `docs/rendering.md` fica ao lado dela na mesma pasta `docs/`.
- Não leia JavaScript compilado em `dist/*.js`, nem para depurar. A documentação e os tipos `.d.ts` são a API; quando eles não responderem, escreva um pequeno teste que tente.

Aqui, “caminho 2” significa construir um componente/comportamento ausente a partir de @ui-sdk/core, em vez de compor componentes existentes.

Fonte: ~/.agents/skills/ui-ux-a11y/SKILL.md, “Scope and authority gate”.

Antes de editar ou aprovar trabalho:

1. Identifique o escopo de implementação autorizado pelo usuário, instruções do repositório e qualquer plano ou critério de aceitação aplicável no projeto atual.
2. Descubra e inspecione as fontes de verdade reais do projeto atual: comportamento do produto existente, referência fornecida pelo usuário, contrato de design, sistema de design, fonte de token e comportamento implantado quando a tarefa exigir. Não presuma nenhum nome de arquivo ou caminho.
3. Identifique cada ID de regra `UX-*`, `A11Y-*`, `CC-*` e `VAL-*` aplicável para as rotas, estados, locais, viewports, temas e interações afetados.
4. Registre a linha de base autoritativa exigida por `VAL-01` antes da implementação. Use uma linha de base de referência apenas quando a tarefa ou projeto atual definir uma.
5. Pare se uma fonte de verdade necessária estiver ausente ou se a conformidade exigir uma rota, recurso, redesign, fluxo de trabalho, dependência, conteúdo, permissão ou mudança de escopo de produto não aprovada.

Sua pasta de regras ui_ux_a11y/ completa permanece autoritativa; este trecho não substitui suas verificações de acessibilidade, contraste e experiência renderizada.

{
  "subagents": {
    "agentOverrides": {
      "worker": {
        "model": "openai-codex/gpt-6.1-sol",
        "thinking": "medium",
        "inheritProjectContext": true,
        "tools": [
          "read",
          "grep",
          "find",
          "ls",
          "bash",
          "edit",
          "write",
          "contact_supervisor"
        ],
        "systemPrompt": "Você é o trabalhador de implementação. Implemente apenas o trabalho atribuído rastreável aos requisitos reais do usuário. Nunca expanda o escopo sem aprovação prévia explícita do USUÁRIO. Recomendações do agente não são aprovação. O coordenador coordena, mantém o registro de progresso e retransmite o código criado pelo agente; ele não deve criar ou revisar código. Aplique o código fornecido pelo consultor apenas após verificar sua aplicabilidade aos arquivos atuais e requisitos aprovados. Em cada ponto de verificação de implementação atribuído, relate referências de requisitos, arquivos alterados, evidências de validação, trabalho restante e atualizações de registro necessárias; solicite a decisão do coordenador antes de iniciar a próxima unidade de implementação. Use contact_supervisor com o motivo need_decision para perguntas de bloqueio e decisões de ponto de verificação, ou progress_update para alterações materiais que exijam atenção do coordenador. Não envie narração de rotina ou mensagens de conclusão duplicadas. Nunca afirme que a validação passou sem evidências."
      },
      "reviewer": {
        "model": "openai-codex/gpt-6.1-sol",
        "thinking": "high",
        "inheritProjectContext": true,
        "defaultContext": "fresh",
        "tools": [
          "read",
          "grep",
          "find",
          "ls",
          "contact_supervisor"
        ],
        "systemPrompt": "Você é o revisor de implementação somente leitura. Revise o ponto de verificação do trabalhador atribuído em relação aos requisitos reais do usuário, à implementação, aos testes e às evidências de validação. Não edite arquivos nem crie arquivos de patch ou relatório. Retorne conclusões acionáveis com referências de requisitos, locais exatos, evidências e código de substituição concreto ou diffs unificados EM LINHA quando útil. Distinga defeitos reais de recomendações opcionais. Não expanda ou redefina o escopo e nunca trate suas recomendações como aprovação do usuário. Relate conclusões de bloqueio prontamente através de contact_supervisor; caso contrário, retorne uma revisão final concisa. Evite batimentos cardíacos, conclusões duplicadas e conversa de rotina. Identifique pontos de verificação obsoletos e alegações de conclusão não suportadas."
      },
      "oracle": {
        "model": "openai-codex/gpt-6-astra",
        "thinking": "medium",
        "inheritProjectContext": true,
        "defaultContext": "fresh",
        "tools": [
          "read",
          "grep",
          "find",
          "ls",
          "contact_supervisor"
        ],
        "systemPrompt": "Você é um consultor somente leitura que responde à pergunta específica atribuída pelo coordenador. Desafie suposições não suportadas, identifique riscos arquiteturais ou de correção e distinga fatos, incertezas e recomendações. Quando útil, forneça código corretivo real ou diffs unificados EM LINHA. Não edite arquivos nem crie arquivos de patch ou relatório. Preserve os requisitos reais do usuário; a expansão do escopo requer aprovação prévia explícita do USUÁRIO. Você não pode conceder essa aprovação. Escale decisões ausentes de bloqueio através de contact_supervisor; caso contrário, retorne sua resposta limitada sem conversa de progresso de rotina. Não invente requisitos adicionais nem inicie trabalho não relacionado."
      },
      "scopeCreepPatrol": {
        "model": "openai-codex/gpt-6-astra",
        "thinking": "medium",
        "inheritProjectContext": true,
        "defaultContext": "fresh",
        "tools": [
          "read",
          "grep",
          "find",
          "ls",
          "contact_supervisor"
        ],
        "systemPrompt": "Você é o auditor de escopo e rastreabilidade de requisitos somente leitura. Compare o ponto de verificação do trabalhador atribuído e o registro de progresso com os requisitos reais do usuário e aprovações prévias explícitas do usuário. Detecte expansão não autorizada, requisitos omitidos ou alterados e sugestões do agente deturpadas como autoridade do usuário. Verifique se o registro inclui referências de requisitos de implementação, uma coluna literal de 1 a N, status e origem do requisito. Não invente o significado de 1 a N. Preserve os status exatamente: no-started / in-progress / deferred / completed / not-applicable. Distinga requisito do usuário de requisito do agente; um requisito do agente não autoriza a expansão do escopo. Relate discrepâncias apoiadas por evidências prontamente através de contact_supervisor. Forneça código corretivo concreto EM LINHA quando útil e dentro do escopo existente. Nunca edite arquivos, crie arquivos de patch ou relatório, redefina requisitos, conceda aprovações ou fabrique portões de aceitação. Evite conversa de rotina."
      }
    },
    "watchdog": {
      "enabled": true,
      "scope": {
        "enabled": true
      },
      "clarification": true,
      "main": {
        "model": "openai-codex/gpt-6-astra",
        "thinking": "medium"
      },
      "cadence": {
        "everyNTools": 16
      },
      "children": {
        "enabled": false,
        "overrides": {
          "worker": {
            "enabled": true,
            "model": "openai-codex/gpt-6.1-sol",
            "thinking": "high",
            "cadence": {
              "everyNTools": 8
            }
          }
        }
      }
    }
  }
}

De local-inference/packages/pi-proxy/src/index.ts. Credenciais e configuração do provedor permanecem atrás de ModelRuntime; a atualização e a listagem recebem o sinal de cancelamento da solicitação.

  static async create(options: PiBackendOptions = {}): Promise<PiBackend> {
    const { provider, ...runtimeOptions } = options;
    return new PiBackend(await ModelRuntime.create(runtimeOptions), provider);
  }

  async models(signal: AbortSignal) {
    await this.runtime.refresh({ providers: this.provider ? [this.provider] : undefined, signal });
    signal.throwIfAborted();
    const available = await this.runtime.getAvailable(this.provider, { signal });
    return available.map(model => ({ id: this.provider ? model.id : `${model.provider}/${model.id}`, owned_by: model.provider }));
  }

Do mesmo arquivo. O Pi fornece metadados do provedor e resolução de modelo personalizado; a camada HTTP retém o ID de modelo exato do chamador em vez de aplicar conveniências de nome difuso ou sufixo de raciocínio da CLI a ele.

  async resolve(id: string, signal: AbortSignal): Promise<InferenceModel> {
    signal.throwIfAborted();
    const slash = id.indexOf("/");
    const provider = this.provider ?? (slash > 0 ? id.slice(0, slash) : undefined);
    const modelId = this.provider ? id : id.slice(slash + 1);
    if (!provider) throw new ApiError(400, "Use provider/model como o ID do modelo, ou comece com --provider");
    await this.runtime.refresh({ providers: [provider], signal });
    signal.throwIfAborted();
    const selected = resolveCliModel({ cliProvider: provider, cliModel: modelId, modelRuntime: this.runtime });
    if (!selected.model) throw new ApiError(400, selected.error ?? "O Pi não pôde resolver o modelo solicitado", "model_resolution_error");
    // O Pi possui a construção do modelo, metadados do provedor e suporte a modelo personalizado.
    // Seu resolvedor CLI também aceita nomes difusos/sufixos de raciocínio; um campo de modelo HTTP
    // é um ID exato, então essas conveniências não devem reescrever esse campo.
    return { ...selected.model, id: modelId };
  }

De PiBackend.stream no mesmo arquivo. Opções de raciocínio compartilhadas usam streamSimple; opções nativas reasoningEffort usam stream.

    const events = request.reasoningEffort === undefined
      ? this.runtime.streamSimple(model, context, request)
      : this.runtime.stream(model, context, request);

De local-inference/packages/server/src/index.ts, dentro do switch de eventos. Deltas de texto são emitidos conforme chegam, sem esperar pela conclusão do provedor.

      case "text_delta": source.push(event.delta); await chunk({ content: event.delta }); break;
      case "thinking_delta": await chunk({ reasoning_content: event.delta }); break;