0disoft/mustflow

O que mustflow faz?

AGENTS.md, contratos de comandos, habilidades e regras de verificação para que os agentes parem de adivinhar.

Este skill fornece uma estrutura para agentes de IA executarem tarefas com clareza e precisão, eliminando suposições. Ele é composto por:

• AGENTS.md: Um arquivo de configuração que define o propósito do projeto, as regras de comportamento do agente e as habilidades disponíveis.
• Contratos de Comandos: Definições padronizadas de comandos CLI, incluindo entradas, saídas e efeitos colaterais esperados.
• Habilidades: Conjuntos de instruções reutilizáveis que o agente pode invocar para realizar tarefas específicas.
• Regras de Verificação: Mecanismos para validar se um comando ou habilidade foi executado corretamente.

Como usar

1. Adicione o skill ao seu projeto.
2. Crie um arquivo AGENTS.md na raiz do projeto com as seções obrigatórias.
3. Defina os contratos de comandos no formato YAML dentro do AGENTS.md.
4. O agente de IA irá ler automaticamente as regras e segui-las durante a execução.

Estrutura do AGENTS.md

# AGENTS.md

## Propósito
Descreva o objetivo principal do projeto.

## Regras
- Regra 1: ...
- Regra 2: ...

## Comandos

### comando-exemplo
```yaml
comando: "npm run build"
descricao: "Compila o projeto"
entradas:
  - variavel: "NODE_ENV"
    valor: "production"
saidas:
  - diretorio: "dist/"
verificacao:
  - "test -d dist"

## Habilidades

### habilidade-exemplo
```yaml
nome: "Compilar e verificar"
comandos:
  - "npm run build"
  - "npm test"
verificacao:
  - "npm run lint"

## Verificação

Após executar comandos, o agente deve rodar os scripts de verificação definidos para confirmar o sucesso da operação.

---

*Este skill é compatível com agentes que suportam a especificação SKILL.md.*