Foreman

Foreman / Instalar

Instale Foreman.

Uma pasta de arquivos Markdown. Nada é compilado ou executado. Funciona em qualquer lugar onde um agente leia arquivos.

Seu agente + Foreman
foreman/
  SKILL.md
  toolbelt/
  templates/

01  Read the playbook
02  Describe your project
03  Review the brief
04  Build with your agent

Claude Code

Ambas as linhas, nesta ordem. Isso adiciona o manual e suas quatro ferramentas como comandos de barra.

/plugin marketplace add Turki-Sh/Foreman
/plugin install foreman@alshuaibi

Se sua interface Claude Code não aceitar /plugin, execute esses comandos em seu shell e inicie uma nova sessão.

claude plugin marketplace add Turki-Sh/Foreman
claude plugin install foreman@alshuaibi

Atualizar ou remover

Atualize pelo terminal:

claude plugin marketplace update alshuaibi
claude plugin update foreman@alshuaibi
/plugin uninstall foreman@alshuaibi

Use-o com sua equipe.

Opcional, para projetos onde Foreman faz parte do fluxo de trabalho compartilhado.

No diretório do projeto, execute:

claude plugin marketplace add Turki-Sh/Foreman
claude plugin install foreman@alshuaibi --scope project

Isso registra Foreman em .claude/settings.json:

{
  "enabledPlugins": {
    "foreman@alshuaibi": true
  }
}

Mantenha as configurações e os plugins existentes. Revise o diff e faça commit do arquivo para compartilhar a configuração. Cada colaborador ainda precisa executar os dois comandos uma vez em seu computador. O commit não baixa o plugin automaticamente.

Para uso pessoal, mantenha a instalação padrão do escopo do usuário. O compartilhamento é opcional e também funciona em repositórios privados. Mantenha credenciais e substituições pessoais fora do arquivo compartilhado.

Escopos de instalação · Configurações compartilhadas

Aplicativos Claude

Baixar foreman.skill e envie o arquivo nas configurações de skills. Ele contém os modos e as quatro ferramentas. Peça com suas palavras, por exemplo: “execute Punch list no meu site”.

Todos os outros agentes

Cursor, Windsurf, Codex, Copilot, Gemini CLI, Cline ou qualquer agente que leia skills ou regras. Copie uma pasta.

git clone https://github.com/Turki-Sh/Foreman.git
cp -r Foreman/plugins/foreman/skills/foreman ~/.agents/skills/
FerramentaPara onde vai a pasta
Diretório universal de skills~/.agents/skills/foreman/
Cursor~/.cursor/rules/, ou .cursor/rules/ no projeto
Codex~/.codex/skills/foreman/, ou faça referência em AGENTS.md
GitHub Copilot.github/copilot-instructions.md, ou aponte para SKILL.md
Windsurf.windsurfrules, ou o diretório de regras do espaço de trabalho
Gemini CLIGEMINI.md, ou o diretório de extensões
Cline, Continue, RooO campo de instruções ou regras customizadas

Os caminhos se movem conforme as ferramentas mudam. A regra que sempre funciona: coloque SKILL.md onde sua ferramenta lê as instruções permanentes e mantenha references/, toolbelt/ e assets/ próximo a ele. AGENTS.md possui a tabela mais recente.

Um chat sem suporte a skills

Colar SKILL.md na conversa e diga “me guie por este processo”. As etapas, os modos e as aprovações funcionam com esse único arquivo. As referências acrescentam detalhes.

Verifique se está carregado

Diga me ajude a construir meu portfólio. A primeira resposta é este cartão, sem nada depois. Se o agente começar a escrever HTML, Foreman não foi carregado.

         _____ ___  ____  _____ __  __    _    _   _
        |  ___/ _ \|  _ \| ____|  \/  |  / \  | \ | |
        | |_ | | | | |_) |  _| | |\/| | / _ \ |  \| |
        |  _|| |_| |  _ <| |___| |  | |/ ___ \| |\  |
        |_|   \___/|_| \_\_____|_|  |_/_/   \_\_| \_|

+--------------------------------------------------------------+
|                                                              |
|                        _______________                       |
|                    ___/               \___                   |
|                   /_________________________\                |
|                   \_________________________/                |
|                      |  .---.     .---.  |                   |
|                      |  | O |-----| O |  |                   |
|                      |  '---'     '---'  |                   |
|                      |         v         |                   |
|                      |     ~~~~~~~~~     |                   |
|                       \_________________/                    |
|                                                              |
|   PLAYBOOK  Foreman 3.0.1 by Turki Alshuaibi                 |
|   STATUS    Step 1 of 8 . Orient                             |
|   METHOD    Decide > Look > Brief > Build > Verify > Ship    |
|   MODE      Blueprint. Say survey or stress test to switch   |
|   RULE      No site code until you sign off the brief        |
|                                                              |
+--------------------------------------------------------------+
|   What are you building, and what do you already have?       |
+--------------------------------------------------------------+

Perguntas

Ele executa alguma coisa em minha máquina? Não. Foreman contém Markdown e modelos para preencher. Não inclui scripts, hooks, servidores MCP nem chamadas de rede. A CI falha se algum desses elementos aparecer. Seu agente usa as próprias ferramentas, com sua permissão, como sempre.

Ele precisa de internet? Não. Survey e Board funcionam melhor quando seu agente pode acessar a web. Se isso não for possível, Foreman avisa em uma frase.

Com quais modelos funciona? Qualquer modelo capaz que seu agente execute. As execuções registradas neste site usaram Claude Sonnet.

Quanto custa? Nada. Licença MIT.