@igor-guari/pi-skill-implement 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Matt Pocock
+Copyright (c) 2025 Igor Guariroba
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,53 @@
-# Temporary Holding Version
+# pi-skill-implement
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![Pi Package](https://img.shields.io/badge/pi--package-skill-blue)](https://github.com/IgorGuariroba/pi-skill-implement)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**implement** skill for the **[Pi coding agent](https://pi.dev)**, adapted from Matt Pocock's Engineering Skills.
+
+> Implement a piece of work based on a spec or set of tickets.
+
+---
+
+## Installation
+
+Install directly into Pi using `pi install`:
+
+```bash
+pi install git:github.com/IgorGuariroba/pi-skill-implement
+```
+
+Or clone into your local/global skills directory:
+
+```bash
+# Global Pi skills directory:
+git clone https://github.com/IgorGuariroba/pi-skill-implement.git ~/.pi/agent/skills/implement
+
+# Or Agent Skills standard path:
+git clone https://github.com/IgorGuariroba/pi-skill-implement.git ~/.agents/skills/implement
+```
+
+---
+
+## Usage
+
+Trigger it explicitly in your session:
+
+```text
+/skill:implement
+```
+
+Or let Pi automatically route to it based on conversation context and need.
+
+---
+
+## Credits
+
+- **Original concept & methodology**: [Matt Pocock](https://github.com/mattpocock)
+- **Adapted for Pi Agent**: [Igor Guariroba](https://github.com/IgorGuariroba)
+
+---
+
+## License
+
+[MIT](LICENSE)

package/SKILL.md

@@ -0,0 +1,23 @@
+---
+name: implement
+description: Implement a piece of work based on a spec or set of tickets.
+disable-model-invocation: true
+license: MIT
+metadata:
+  author: Matt Pocock
+  adapted_by: Igor Guariroba
+  version: 1.0.0
+---
+
+
+Implement the work described by the user in the spec or tickets. Before editing, record the starting HEAD and existing staged/unstaged/untracked changes. Preserve the user's work and use that starting SHA as the review base.
+
+Read `../tdd/SKILL.md` and apply it where possible, at pre-agreed seams. Resolve skill references relative to this skill directory; Pi loads their instructions through file reads, not a Skill tool.
+
+Work in the current Pi session by default. When independent work benefits from delegation, read `references/pi-workers.md` and use fresh Pi processes; each concurrent writer needs its own worktree. Herdr is optional under that guide's conditions.
+
+Run typechecking regularly, single test files regularly, and the full test suite once at the end.
+
+Once implemented and validated, read `../code-review/SKILL.md` to review both your commits and your uncommitted changes against that SHA. Fix actionable findings and rerun the affected checks before concluding.
+
+Commit only your work to the current branch. Report the commit, acceptance criteria covered, checks run and any remaining blockers; completion requires every requested criterion to be accounted for.

package/package.json

@@ -1,6 +1,29 @@
 {
   "name": "@igor-guari/pi-skill-implement",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Implement a piece of work based on a spec or set of tickets.",
+  "keywords": [
+    "pi-package",
+    "pi-skill",
+    "pi",
+    "implement",
+    "engineering-skills"
+  ],
+  "author": "Igor Guariroba",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/IgorGuariroba/pi-skill-implement.git"
+  },
+  "homepage": "https://github.com/IgorGuariroba/pi-skill-implement#readme",
+  "pi": {
+    "skills": [
+      "."
+    ]
+  },
+  "files": [
+    "SKILL.md",
+    "*.md",
+    "references/"
+  ]
+}

package/references/pi-workers.md

@@ -0,0 +1,33 @@
+# Workers no Pi
+
+Referência compartilhada para delegação em processos Pi independentes. Um **worker** é outro processo Pi com contexto próprio; o coordenador continua responsável pelo resultado.
+
+## Preparar e executar
+
+1. Confira `pi --help` para as opções da instalação. Crie um diretório de execução fora do repositório (`mktemp -d`) e um prompt por tarefa. Registre papel, cwd absoluto, escopo permitido, referências absolutas à spec/tickets/skills, resultado esperado e critério de conclusão. Compartilhe ponteiros, não o histórico da conversa.
+2. Execute cada tarefa com cwd explícito e contexto novo. Exemplo de comando para `process_start` (substitua os caminhos):
+
+   ```bash
+   cd /absolute/worktree && pi --print --no-session @/absolute/run/task.md > /absolute/run/result.md 2> /absolute/run/stderr.log
+   ```
+
+   Use o modelo/provider solicitado, se houver; caso contrário, mantenha os defaults configurados. `--no-session` evita persistir/reutilizar a conversa; configurações e instruções do projeto continuam disponíveis. Carregue outras skills lendo seus `SKILL.md` por caminho absoluto no prompt. Pi não precisa de uma ferramenta `Skill` para isso.
+3. Inicie tarefas independentes com chamadas separadas de `process_start`, cada uma com `watch`: `success: {exitCode: {eq: 0}}`, `failure: {exitCode: {ne: 0}}` e `timeoutMs` finito conforme o trabalho (por exemplo, 600000 para revisão). Após registrar os watches, informe a espera e encerre o turno. Os resultados chegam automaticamente; use `process_logs` para diagnóstico, não polling manual.
+4. Ao receber a conclusão, leia resultado e stderr e confira os artefatos. Exit code zero comprova execução, não cumprimento da tarefa. Uma resposta sem evidência, com bloqueio ou trabalho parcial é incompleta. Em timeout, inspecione e pare o processo antes de repetir ou liberar seu worktree. Preserve prompts, resultados e logs até entregar o trabalho.
+
+Se `process_start`/watch não estiverem disponíveis, escolha o caminho Herdr abaixo quando aplicável; caso contrário, execute tarefas sequencialmente com timeout explícito na ferramenta disponível. Registre a perda de paralelismo. Falha de autenticação ou diálogo que exija interação deve ser reportado ao usuário; não invente aprovações nem transfira segredos em prompts.
+
+## Contratos e isolamento
+
+- **Implementação:** um worktree e branch exclusivos por worker escritor. O resultado informa commit(s), critérios atendidos, comandos/testes e resultados, pendências e status Git. Só aceite conclusão após conferir esses itens.
+- **Revisão/exploração:** leitura apenas do código; saída final em stdout, capturada pelo coordenador. Autorize escrita de notas externas apenas quando a tarefa exigir. Com `bash`, uma instrução de leitura não é sandbox: mantenha o escopo explícito e verifique o status Git antes/depois. Para leitura estrita sem shell, a instalação oferece `--tools read,grep,find,ls --no-mcp`; o coordenador pode fornecer diff e commits em arquivos externos.
+- **Integração:** um único escritor na branch de integração. O coordenador serializa merges; workers de tickets não atualizam essa branch. Nenhum reset destrutivo ou limpeza forçada de alterações alheias.
+- **Conclusão:** o coordenador valida commits, testes e critérios de aceitação. Estado de processo/pane não substitui essa validação.
+
+## Herdr: acompanhamento visível
+
+Quando o usuário mencionar/pedir Herdr e `HERDR_ENV=1`, leia `../skills/herdr/SKILL.md` (relativo a este arquivo) e consulte a CLI instalada antes de controlar panes. Fora do Herdr, continue com processos Pi; Herdr não é pré-requisito.
+
+Use os comandos documentados de pane para executar o mesmo comando `pi --print --no-session` em um shell disponível, preservando foco e cwd explícito. Capture saída, stderr e exit code em arquivos exclusivos fora do repositório. Aguarde via `watch_create` com polling barato do arquivo de exit code, sucesso zero, falha não zero e timeout finito. Publique esse arquivo apenas depois que o Pi terminar. Após registrar o watch, encerre o turno. Em timeout, inspecione o pane antes de repetir.
+
+Se preferir um Pi interativo reconhecido por Herdr, confira primeiro se a CLI instalada oferece esse kind e siga a skill Herdr para iniciar, enviar prompt e aguardar. Cada tarefa independente começa em um processo/sessão nova. `idle`/`done` indica estado da interface, não aceitação do trabalho: leia a resposta e valide os artefatos. Crie workspaces/tabs ou outra topologia somente quando o usuário os solicitar; encerre apenas recursos criados para esta execução.