From 8ec85e51f8436c03a3fd369a599bd1bbbf660918 Mon Sep 17 00:00:00 2001 From: Felipe Domingues Date: Mon, 3 Aug 2026 17:19:08 -0300 Subject: [PATCH] feat: complete operational growth foundations --- AGENTS.md | 28 ++++++++++++++++++++++++++++ README.md | 46 ++++++++++++++++++++++++++++++++++++++++++++++ agentpack.json | 9 +++++++++ install.ps1 | 27 +++++++++++++++++++++++++++ install.sh | 44 ++++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 154 insertions(+) create mode 100644 AGENTS.md create mode 100644 README.md create mode 100644 agentpack.json create mode 100644 install.ps1 create mode 100755 install.sh diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..8044cb9 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,28 @@ +# AgentPack Lite — agente inicial + +## Objetivo + +Transformar uma tarefa recorrente em uma sequência clara, verificável e fácil +de executar no ambiente de trabalho. + +## Entradas + +- objetivo e resultado esperado; +- contexto, arquivos e ferramentas disponíveis; +- restrições, prazo e critérios de aceite. + +## Fluxo + +1. Confirme o objetivo e liste as entradas necessárias. +2. Divida o trabalho em passos pequenos e reversíveis. +3. Execute uma etapa por vez, registrando decisões e riscos. +4. Valide o resultado contra os critérios de aceite. +5. Entregue um resumo com arquivos alterados e próximos passos. + +## Limites + +- Não invente dados, credenciais, ferramentas ou resultados. +- Não exponha segredos nem sobrescreva arquivos sem confirmação. +- Pare e peça orientação quando houver ambiguidade material ou risco + irreversível. +- Adapte esta estrutura ao seu projeto antes de usá-la em produção. diff --git a/README.md b/README.md new file mode 100644 index 0000000..5683a6c --- /dev/null +++ b/README.md @@ -0,0 +1,46 @@ +# AgentPack Lite + +Um ponto de partida gratuito para transformar uma tarefa recorrente em um +`AGENTS.md` utilizável no seu IDE ou CLI. O Lite é local, transparente e não +exige cadastro nem chave de modelo. + +## Instalação rápida + +```sh +curl -fsSL https://github.com/domfelipe/agentpack/releases/latest/download/install.sh | sh +``` + +Para revisar antes de copiar: + +```sh +curl -fsSL https://github.com/domfelipe/agentpack/releases/latest/download/install.sh -o install.sh +sh install.sh --dry-run +sh install.sh +``` + +No Windows, baixe `install.ps1` e execute no PowerShell: + +```powershell +powershell -ExecutionPolicy Bypass -File .\install.ps1 -DryRun +powershell -ExecutionPolicy Bypass -File .\install.ps1 +``` + +O instalador nunca sobrescreve um `AGENTS.md` existente. Se você já tiver +personalizações, ele interrompe e mostra o caminho para uma instalação manual. +O SHA-256 do arquivo entregue é verificado antes da cópia. + +## O que vem no Lite + +- um `AGENTS.md` inicial com objetivo, entradas, fluxo e limites; +- instaladores para macOS/Linux e Windows PowerShell; +- execução local, sem dependência de GitHub Actions ou de um modelo específico. + +O Lite não inclui QA Verified, manutenção automática, histórico, skills pagas +ou suporte de implantação. Para gerar um AgentPack completo, com revisão e +destinos para Codex, Claude Code, Gemini CLI, Cursor e OpenCode, acesse +. + +## Licença e integridade + +Este pacote é distribuído pela DOM Hubs para experimentação e uso interno do +comprador. Confira `agentpack.json` e o SHA-256 antes de distribuir uma cópia. diff --git a/agentpack.json b/agentpack.json new file mode 100644 index 0000000..05cc80a --- /dev/null +++ b/agentpack.json @@ -0,0 +1,9 @@ +{ + "schemaVersion": 1, + "product": "AgentPack Lite", + "version": "0.1.0", + "publisher": "DOM Hubs", + "entrypoint": "AGENTS.md", + "sha256": "03d2b7d8258ca271bf84f3afa9e72dfde7accdf55b1f800ffca9a84976e59b79", + "installers": ["install.sh", "install.ps1"] +} diff --git a/install.ps1 b/install.ps1 new file mode 100644 index 0000000..2bd3582 --- /dev/null +++ b/install.ps1 @@ -0,0 +1,27 @@ +param( + [switch]$DryRun, + [string]$Target = "AGENTS.md", + [string]$SourceUrl = "https://agentpacks.domhubs.com.br/api/lite/agents" +) + +$ErrorActionPreference = "Stop" +$ExpectedSha256 = "03d2b7d8258ca271bf84f3afa9e72dfde7accdf55b1f800ffca9a84976e59b79" + +if (Test-Path -LiteralPath $Target -PathType Leaf) { + throw "Arquivo existente; nada foi sobrescrito: $Target" +} + +$temporary = Join-Path ([System.IO.Path]::GetTempPath()) ("agentpack-lite-" + [guid]::NewGuid().ToString("N") + ".md") +try { + Invoke-WebRequest -Uri $SourceUrl -OutFile $temporary -UseBasicParsing + $actual = (Get-FileHash -Algorithm SHA256 -LiteralPath $temporary).Hash.ToLowerInvariant() + if ($actual -ne $ExpectedSha256) { throw "Falha de integridade: SHA-256 inesperado ($actual)." } + if ($DryRun) { + Write-Output "OK: instalaria $Target (SHA-256 $actual)" + } else { + Copy-Item -LiteralPath $temporary -Destination $Target + Write-Output "AgentPack Lite instalado em $Target" + } +} finally { + Remove-Item -LiteralPath $temporary -Force -ErrorAction SilentlyContinue +} diff --git a/install.sh b/install.sh new file mode 100755 index 0000000..b7ecc93 --- /dev/null +++ b/install.sh @@ -0,0 +1,44 @@ +#!/bin/sh +set -eu + +SOURCE_URL="${AGENTPACK_LITE_URL:-https://agentpacks.domhubs.com.br/api/lite/agents}" +EXPECTED_SHA256="03d2b7d8258ca271bf84f3afa9e72dfde7accdf55b1f800ffca9a84976e59b79" +DESTINATION="${AGENTPACK_TARGET:-AGENTS.md}" +DRY_RUN=0 + +if [ "${1:-}" = "--dry-run" ]; then + DRY_RUN=1 +fi + +if [ -e "$DESTINATION" ]; then + echo "Arquivo existente; nada foi sobrescrito: $DESTINATION" >&2 + exit 2 +fi + +tmp="$(mktemp "${TMPDIR:-/tmp}/agentpack-lite.XXXXXX")" +cleanup() { rm -f "$tmp"; } +trap cleanup EXIT INT TERM + +if command -v curl >/dev/null 2>&1; then + curl --fail --silent --show-error --location "$SOURCE_URL" --output "$tmp" +elif command -v fetch >/dev/null 2>&1; then + fetch -o "$tmp" "$SOURCE_URL" +else + echo "É necessário curl ou fetch para baixar o AgentPack Lite." >&2 + exit 1 +fi + +actual="$(shasum -a 256 "$tmp" | awk '{print $1}')" +if [ "$actual" != "$EXPECTED_SHA256" ]; then + echo "Falha de integridade: SHA-256 inesperado ($actual)." >&2 + exit 1 +fi + +if [ "$DRY_RUN" -eq 1 ]; then + echo "OK: instalaria $DESTINATION (SHA-256 $actual)" + exit 0 +fi + +umask 022 +cp "$tmp" "$DESTINATION" +echo "AgentPack Lite instalado em $DESTINATION"