Manutenção

Migrate: leve um projeto Lagune baseado em manifest para as skills e os plugins

Leve um projeto Lagune baseado em manifest para o Lagune baseado em skills, mantendo o seu charter, os artefatos, o rastreamento e as suas próprias especializações.

🔀 Leve um projeto Lagune baseado em manifest para o Lagune baseado em skills, mantendo tudo o que você escreveu.

Aviso de descontinuação

Um projeto com manifest continua funcionando como está até a v1.x: o npx lagune repassa init, pull, update, add, remove, list e o dashboard para o lagune@0.15.0, a última versão baseada em manifest.

Como migrar​

  1. Confirme que o seu trabalho atual está commitado e então rode o migrate a partir da raiz do projeto:

    npx lagune migrate
  2. Faça um commit só com o que ele alterou, para que a migração continue sendo uma única mudança revisável.

  3. Instale os comandos do seu agente, como mostra a página de instalação.

  4. Se o projeto já tiver um artefato de detect, plan ou harden, peça ao /lagune-repair para reconciliar as referências antigas neles e nas suas próprias especializações:

    /lagune-repair Reconcilie as especializações aplicadas (antes chamadas de sub-skills) nos artefatos em `.lagune/memory/` (`detect.md`, `plan.md` e `harden.md`) com os nomes que o novo catálogo lista, e reescreva cada chamada que as minhas próprias especializações em `.lagune/catalog/` fazem aos hooks antigos em `.lagune/hooks/` como uma chamada à ferramenta `lagune_read` ou `lagune_write`.

O que muda​

AntesDepois
.lagune/templates/, .lagune/hooks/ e .lagune/specializations.mdRemovidos: cada skill traz o próprio template, e o engine executa os hooks
As cópias das especializações nativas em .lagune/skills/Removidas: o engine serve as nativas
As suas próprias especializações em .lagune/skills/Movidas para .lagune/catalog/
.lagune/skills.json, o índice das suas próprias especializaçõesIncorporado ao .lagune/configs.json
As categorias do manifestRegistradas em .lagune/configs.json
Os comandos antigos do agente, como /lagune.detectRemovidos: instalar o Lagune traz os novos, como /lagune-detect
O bloco do Lagune no .gitignoreRemovido, junto com o arquivo quando ele não tinha mais nada
.lagune/proofs/, ignorado por aquele blocoMantido fora dos commits pelo próprio .gitignore
.lagune/manifest.jsonApagado, por último

O seu trabalho de segurança continua como está: o charter, o artefato que cada fase produziu e o mapa de rastreamento com os caminhos para os quais cada achado aponta.

Perguntas frequentes

Sim. Os projetos baseados em manifest estão descontinuados e só continuam funcionando até a v1.x, então execute npx lagune migrate para migrar o seu.

O seu charter, todos os artefatos das fases, o mapa de rastreamento, as suas categorias e as suas próprias especializações. As especializações vão para .lagune/catalog/, e o índice delas se junta às suas categorias em .lagune/configs.json.

Depois do migrate, como a página de instalação mostra para o seu agente. Instalar antes também funciona, já que o migrate mantém o novo /lagune.

Faça o pull da migração e então execute npx lagune migrate uma vez. Ele remove o que o Lagune baseado em manifest deixou no seu clone, que o controle de versão nunca carregou, e mantém as suas provas fora dos commits.