deepworkplan-onboard

Transforma um repositório em uma base de código AI-first, orientada a especificação. Esta é a sub-skill onboard da skill Deep Work Plan.

O que faz

O deepworkplan-onboard inspeciona o repositório real — linguagens, frameworks, gerenciador de pacotes, comandos de build/teste/lint, módulos, convenção de testes, formato de deploy — e gera artefatos adaptados a ele. Ele raciocina; nunca copia um template nem deixa um placeholder.

Uso

/deepworkplan-onboard

Comportamento

1. Reconhecimento — detectar a stack real e os comandos de validação; corresponder ao preset de onboarding mais próximo.
2. Arquétipo — classificar como repositório individual ou hub orquestrador.
3. Gerar AGENTS.md + o symlink CLAUDE.md com um bloco Quick Commands real.
4. Gerar docs/ (arquitetura, padrões, testes, segurança e mais) e docs por módulo.
5. Gerar .agents/ (agents, comandos dwp-* enxutos, skills apropriadas à stack, catálogo) + .claude → .agents.
6. Instalar a skill e estruturar um .dwp/ ignorado pelo git (planos, rascunhos) e um espaço de rascunho tmp/.
7. Instalar a revisão local obrigatória do AI Diff Reviewer; detectar todos os addons, atualizar os que o repositório usa e oferecer os que fazem sentido (nunca um só para completar o conjunto); em seguida, fazer a autoverificação.

Notas

Um repositório é totalmente conforme com zero addons opcionais; a revisão local do AI Diff Reviewer faz parte da linha de base desde o padrão 2.3.0. A realidade detectada sempre prevalece sobre as suposições do preset.

Referências de esquemas v7

Para planos v7 — o padrão do pacote 7.x atual — o catálogo de esquemas legíveis por máquina é publicado nestas URLs estáveis. A projeção ativa é um snapshot compartilhado com o v6; não existe plan-state/v6.json nem plan-state/v7.json.

• Manifesto do plano: https://deepworkplan.com/schema/plan-manifest/v7.json
• Contrato do plano: https://deepworkplan.com/schema/plan-contract/v7.json (o contrato v6 mais um marcador de tarefa opcional parallel_safe)
• Evento do diário: https://deepworkplan.com/schema/journal-event/v7.json (acrescenta o evento delegation)
• Snapshot do plano (projeção ativa, compartilhada com o v6): https://deepworkplan.com/schema/plan-snapshot/v6.json
• Manifesto de contexto (compartilhado com o v6): https://deepworkplan.com/schema/context-manifest/v6.json
• Configuração do repositório: https://deepworkplan.com/schema/dwp-config/v1.json
• Descritor de addon: https://deepworkplan.com/schema/addon-descriptor/v1.json
• Pacote de transição de swarm: https://deepworkplan.com/schema/dwp-handoff/v1.json
• Registro de benchmark: https://deepworkplan.com/schema/benchmark-record/v1.json
• Registro de aprendizados: https://deepworkplan.com/schema/learnings-record/v1.json

Planos v6 mantêm seus esquemas v6 (manifesto, contrato, evento do diário); planos v5 existentes continuam usando o esquema de estado v5, e planos antigos nunca são reescritos silenciosamente.

O pacote 7.x atual cria novos planos com v7 por padrão. Os planos existentes mantêm a geração registrada; a migração exige uma solicitação explícita. Os novos planos recebem IDs numéricos monotônicos com pelo menos três dígitos (por exemplo, PLAN_001_add_payment_webhooks/). Como os esquemas v5 congelados contam o ID numérico como uma palavra, os slugs v5 têm 2–4 palavras; os slugs v7 têm 2–5. As pastas existentes sem numeração PLAN_<slug>/ continuam legíveis e nunca são renomeadas. Quando há planos numerados, latest resolve para o plano com o maior ID numérico.