Docs Canônicos por Negócio

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

Status: arquitetura aprovada para transicao Issue: #59 Data: 04 Maio 2026

Decisao

O ecossistema passa a ter uma arquitetura de documentacao por dono canonico.

Enquanto docs.trustyu.ai e docs.needyu.ai nao existem, o docs.techhuman.com.br pode publicar documentos de transicao para explicar o mapa completo. Esses documentos nao devem transformar Trustyu.ai, JARVIS, Trustyu Forge, Trust Score/Trustyu Score ou NeedyU.ai em produtos principais da Tech Human.

Regra central:

Tech Human explica o ecossistema. Cada negocio guarda sua verdade profunda quando tiver Docs proprio.

Arquitetura de alto nivel

Negocio	Docs atual	Docs canonico futuro	Papel
Tech Human	`docs.techhuman.com.br`	`docs.techhuman.com.br`	Fonte profunda da empresa comercial, produtos TH, operacao e materiais
Trustyu.ai	transicao em `docs.techhuman.com.br/negocios`	`docs.trustyu.ai`	Fonte profunda de venture builder, Forge, JARVIS e Trust Score/Trustyu Score
NeedyU.ai	transicao em `docs.techhuman.com.br/negocios`	`docs.needyu.ai`	Fonte profunda do SaaS, produto, onboarding, integracoes e uso enterprise

O Playbook Tech Human continua sendo o mapa visual do conjunto. Ele pode apontar para paginas de transicao enquanto os Docs proprietarios nao existem. Quando os Docs do dono existirem, o Playbook deve apontar para eles.

Onde cada conceito deve morar

Conceito	Dono canonico	Profundidade fica em	Tech Human deve manter
Tech Human	Tech Human	`docs.techhuman.com.br`	Documento completo
BMAI Diagnostico	Tech Human	`docs.techhuman.com.br`	Documento completo
AI-First Blueprint	Tech Human	`docs.techhuman.com.br`	Documento completo
CTO aaS + Squad	Tech Human	`docs.techhuman.com.br`	Documento completo
TH Build	Tech Human	`docs.techhuman.com.br`	Documento completo, com JARVIS explicado como metodo usado por baixo
THunting	Tech Human	`docs.techhuman.com.br`	Documento completo
Governanca Continua	Tech Human	`docs.techhuman.com.br`	Documento completo
Trustyu.ai	Trustyu.ai	futuro `docs.trustyu.ai`	Resumo, handoff e contexto de uso
Trustyu Forge	Trustyu.ai	futuro `docs.trustyu.ai/forge`	Resumo e criterio de quando a conversa vira Trustyu
JARVIS	Trustyu.ai	futuro `docs.trustyu.ai/jarvis`	Efeito para cliente e uso em TH Build, sem vender como produto TH
Trust Score / Trustyu Score	Trustyu.ai	futuro `docs.trustyu.ai/score`	Produto operado pela Tech Human e rota comercial atual
NeedyU.ai	NeedyU.ai	futuro `docs.needyu.ai`	Como aparece embedded, standalone, em governanca e THunting

Rotas Publicas Aprovadas

Decisao registrada na issue #104.

Conceito	Rota publica	Status	Regra editorial
JARVIS	`jarvis.trustyu.ai`	site ativo	Metodo Trustyu; Tech Human mostra o efeito na execucao, nao vende como produto principal
Trustyu Forge	`trustyu.ai/forge`	pagina planejada	Pagina propria dentro da Trustyu.ai; nao SKU da Tech Human
Trust Score / Trustyu Score	`score.trustyu.ai`	pagina planejada	Framework/produto Trustyu operado comercialmente pela Tech Human
CTO aaS + Squad	`techhuman.com.br/cto-and-cpo-aas-servico-cto`	site ativo	Oferta Tech Human; nova URL limpa deve vir no novo site

trustscore.trustyu.ai fica reservado apenas para eventual rebrand futuro. Enquanto a marca publica for Trust Score, o destino de produto planejado e score.trustyu.ai.

Padrao de aviso editorial

Todo documento de transicao sobre conceito de outro dono deve abrir com aviso claro.

Modelo curto:

Nota editorial: este documento aparece no Docs Tech Human porque explica o ecossistema. O dono
canonico deste conceito e [Trustyu.ai/NeedyU.ai]. Quando o Docs do dono estiver ativo, esta pagina
deve virar resumo e apontar para a fonte profunda.

Modelo para pagina de produto operado pela Tech Human:

Nota editorial: a Tech Human opera e comercializa esta capacidade hoje, mas a documentacao profunda
do framework pertence ao dono canonico [Trustyu.ai/NeedyU.ai]. Esta pagina explica como a Tech Human
usa, vende ou integra o conceito no ecossistema.

Entregaveis desta arquitetura

Documento	Funcao
`trustyu-docs-architecture.md`	Arquitetura de `docs.trustyu.ai`, inventario canonico e migracao de Forge, JARVIS e Score
`needyu-docs-architecture.md`	Arquitetura de `docs.needyu.ai`, produto SaaS, onboarding, integracoes e uso enterprise
`migration-plan.md`	Plano de migracao, regras de espelhamento, links e criterio de aceite

O que fica no Docs Tech Human

O Docs Tech Human deve manter:

arquitetura do ecossistema;
produtos Tech Human;
portas comerciais;
materiais comerciais e operacionais TH;
contexto de como Trustyu.ai, Forge, JARVIS, Score e NeedyU.ai aparecem na Tech Human;
avisos editoriais de transicao;
links para os Docs do dono quando existirem.

O Docs Tech Human nao deve manter, no longo prazo:

manual profundo de JARVIS;
processos internos completos da Trustyu Forge;
documentacao tecnica de produto NeedyU.ai;
APIs, onboarding e suporte profundo de NeedyU.ai;
tese de capital completa da Trustyu quando docs.trustyu.ai existir.

Roadmap de criacao dos Docs proprietarios

Fase	Resultado
0	Arquitetura aprovada nesta pasta e publicada em `docs.techhuman.com.br/negocios`
1	Criar repo/site de `docs.trustyu.ai` com Starlight ou stack equivalente
2	Migrar Trustyu.ai, Forge, JARVIS e Score para Docs Trustyu
3	Criar repo/site de `docs.needyu.ai`
4	Migrar produto, onboarding, integracoes, seguranca e enterprise de NeedyU.ai
5	Reduzir paginas Tech Human para resumo, contexto de uso e links profundos

Regra final

Se uma pagina nao sabe quem e o dono canonico, ela ainda nao esta pronta para publicar.

Se a Tech Human explica algo que pertence a Trustyu.ai ou NeedyU.ai, a pagina precisa dizer:

por que esse conceito aparece na Tech Human;
quem e o dono profundo;
o que a Tech Human pode vender ou usar;
o que deve migrar quando o Docs do dono existir.