Plano de Migração para Docs por Negócio

Documento canônico: 08-business-docs/migration-plan.md

Status: plano de execucao futura Issue: #59

---

Objetivo

Criar um caminho controlado para separar documentacao profunda por negocio sem quebrar o Docs Tech Human, o Playbook ou os materiais comerciais.

A migracao deve reduzir duplicacao e aumentar clareza:

Docs Tech Human
   ↓ resumo e contexto de uso
Docs do dono
   ↓ fonte profunda
Playbooks
   ↓ entendimento guiado
Sites comerciais
   ↓ conversao

---

Principios

1. Nao migrar por ansiedade. Um Docs proprio so nasce quando houver audiencia, conteudo e dono operacional claro.
2. Nao duplicar profundidade. Se uma pagina pertence a Trustyu.ai ou NeedyU.ai, Tech Human deve manter resumo e links.
3. Nao quebrar links. Toda migracao precisa de pagina de resumo, redirect ou aviso.
4. Nao mudar marca sem decisao. Trust Score so vira Trustyu Score quando a decisao de marca for aprovada.
5. Nao esconder contexto. O Playbook Tech Human continua mostrando como tudo se conecta.

---

Fase 0 — Transicao no Docs Tech Human

Status desta issue.

Entregas:

• criar 08-business-docs/;
• publicar secao negocios no Docs Tech Human;
• documentar docs.trustyu.ai;
• documentar docs.needyu.ai;
• documentar plano de migracao;
• atualizar governanca de donos canonicos.

Criterio de aceite:

• cada conceito tem dono canonico explicito;
• Tech Human nao posiciona JARVIS, Forge ou Score como produto principal TH;
• existe plano futuro para Docs Trustyu e Docs NeedyU;
• paginas de transicao tem padrao de aviso editorial.

---

Fase 1 — Bootstrap de docs.trustyu.ai

Quando executar:

• Trustyu.ai tiver site ou narrativa publica propria madura;
• houver necessidade real de founders, Venture Clients, investidores ou operadores lerem conteudo profundo sem passar pela Tech Human;
• Forge, JARVIS e Score precisarem de manual proprio.

Entregas:

• escolher repo e stack;
• configurar dominio docs.trustyu.ai;
• criar estrutura minima;
• migrar docs Trustyu prioritarios;
• ajustar paginas Tech Human para resumo;
• atualizar Playbook Tech Human com links profundos;
• criar, se necessario, playbook.trustyu.ai.

Arquivos iniciais a migrar:

Atual	Futuro
01-strategy/trustyu-forge-operating-model.md	docs.trustyu.ai/forge/modelo-operacional
01-strategy/vpc-trustyu-jarvis.md	docs.trustyu.ai/tese/venture-builder-ai e docs.trustyu.ai/jarvis/metodo-de-execucao
00-foundation/trust-score-product.md	docs.trustyu.ai/score/produto-escalavel
00-foundation/trust-score-methodology.md	docs.trustyu.ai/score/metodologia

---

Fase 2 — Bootstrap de docs.needyu.ai

Quando executar:

• NeedyU.ai tiver site de produto ativo ou rollout comercial;
• houver clientes enterprise, usuarios ou parceiros pedindo onboarding;
• integracoes, seguranca ou suporte exigirem documentacao propria.

Entregas:

• escolher repo e stack;
• configurar dominio docs.needyu.ai;
• criar estrutura minima de produto;
• migrar proposta de valor para pagina de produto;
• criar onboarding de usuario, time e administrador;
• documentar integracoes e seguranca;
• ajustar paginas Tech Human para resumo;
• atualizar Playbook Tech Human com links profundos.

Arquivos iniciais a migrar:

Atual	Futuro
01-strategy/vpc-needyu.md	docs.needyu.ai/produto/o-que-e-needyu-ai
04-operations/thunting-product.md	docs.needyu.ai/ecossistema/uso-em-thunting
04-operations/governanca-continua-product.md	docs.needyu.ai/ecossistema/uso-em-governanca-continua
01-strategy/customer-journey-e2e.md	docs.needyu.ai/ecossistema/uso-com-tech-human

---

Fase 3 — Reducao do Docs Tech Human

Depois que os Docs do dono existirem, cada pagina Tech Human sobre conceito externo deve ser revisada.

Nova estrutura padrao:

1. O que e
2. Quem e o dono canonico
3. Como aparece na Tech Human
4. Quando vender / usar / encaminhar
5. O que nao dizer
6. Link para Docs profundo do dono

O que remover:

• detalhes tecnicos profundos;
• playbooks internos do dono;
• manuais de produto;
• operacao sensivel;
• pricing, margem, tese de equity ou informacao interna que nao pertence ao Docs publico.

---

Fase 4 — Atualizacao do Playbook e sites

Quando links canonicos existirem:

• Playbook Tech Human deve apontar para o Docs do dono;
• sites comerciais devem usar apenas textos curados e publicos;
• materiais comerciais devem referenciar a origem correta;
• README do repositorio deve listar os novos Docs;
• issues antigas devem ser comentadas com links novos.

---

Padrao de redirect e link

Situacao	Acao
Pagina Tech Human vira resumo	Manter URL e trocar profundidade por contexto
Pagina muda para Docs do dono	Adicionar link visivel para a fonte profunda
Pagina antiga nao deve existir	Criar redirect se for site; comentar issue/PR se for fonte repo
Playbook apontava para transicao	Atualizar para Docs canonico do dono

---

Checklist antes de mover uma pagina

• O dono canonico esta documentado?
• A audiencia do novo Docs existe?
• O conteudo e profundo o bastante para justificar outro dominio?
• O resumo Tech Human continua claro?
• O Playbook nao perdeu contexto?
• Links internos foram atualizados?
• A mudanca foi registrada em issue e PR?
• O deploy foi validado?

---

Criterio de conclusao da migracao

A migracao completa termina quando:

• docs.trustyu.ai guarda Trustyu.ai, Forge, JARVIS e Score;
• docs.needyu.ai guarda produto, onboarding, integracoes, seguranca e suporte;
• docs.techhuman.com.br guarda Tech Human e apenas resumos/contexto dos outros negocios;
• playbook.techhuman.com.br mostra o mapa e aponta para os Docs corretos;
• materiais comerciais nao contradizem a fonte profunda;
• nenhuma pagina vende JARVIS, Forge ou NeedyU.ai como produto principal da Tech Human.