oro onboarding

Visão geral

Fluxo explícito para adoção segura de Git hooks e bloco gerenciado de .gitignore. oro init permanece sem instalação automática.

Preview somente leitura

oro onboarding plan --path .
oro onboarding plan --path . --protect-branches main,develop

Mostra paths, branches, conflitos e limites Git; não escreve arquivos. --protect-branches é opt-in explícito. Sem essa flag, preview não inclui hooks.

Apply

oro onboarding apply --path . --protect-branches main,develop --dry-run
oro onboarding apply --path . --protect-branches main,develop --yes

Apply real exige --yes. Sem --protect-branches, só gerencia .gitignore. Hooks existentes, Husky/customização não suportada, core.hooksPath e linked worktrees causam bloqueio, sem overwrite.

Uninstall

oro onboarding uninstall --path .       # preview sem escrita
oro onboarding uninstall --path . --yes # remoção opt-in, conteúdo íntegro apenas

Limitações e homologação

--no-verify ignora pre-commit; fast-forward merge não aciona pre-merge-commit. Hooks locais não substituem CI nem branch policy remota. Somente Linux homologado; macOS, Windows e Git Bash pendentes. Sem wiring em planner/executor e sem integração automática em init.