Origem: Humano, 2026-09-25: "precisa acessar o AI Workspace doc por doc, ver o que está certo, o que precisa melhorar e atualizar, olhar as referências". A fase 1 (req-176/177/178) entregou só a infraestrutura e 3 docs piloto.
Lote Vinculado: BATCH-184 (onda 1). As ondas seguintes abrem um batch cada.
Status: approved.
Autonomia: Nível 2 (commit e push autorizados pelo Humano em 2026-09-25). Deploy só no Lab ([REDACTED]).
Procedimento: skill c2f-documentation, com leitura profunda do código, pt-br e en na mesma passagem e docs:audit zerado por doc.
1. Regras da migração
-
Doc legada não é fonte, é pista. Ela indica o assunto; o conteúdo novo sai do código. O que a doc legada afirma e o código não confirma é descartado.
-
Ao migrar, o legado correspondente é apagado nos dois idiomas, no mesmo commit. O histórico fica no git e na branch
legacy/ai-workspace-pre-docs. -
Manual de usuário e doc técnica de um módulo viram uma doc só (
reference/modules/<id>.md), com uma seção "Como usar" e uma de referência técnica. -
Relatos de versão (
-v2.6.3,-CONCLUIDO, "Fase 1", "Correções implementadas") não são doc. O que for comportamento vigente entra na doc do assunto; o resto é descartado. O histórico de versões fica emCHANGELOG.md. -
Informação sensível (hosts, IPs, caminhos de VPS, credenciais) nunca migra. Na dúvida,
visibility: restricted.
2. Mapa: legado → árvore nova
Legenda: M = migrar (reescrever do código), F = fundir em outra doc, N = nova (sem legado), D = descartar.
2.1 Referência de bibliotecas (reference/libraries/<nome>.md), 44 arquivos
| Destino | Legado pt-br / en | Ação |
|---|---|---|
arquivo, autenticacao, comunicacao, configuracao, formato, formulario, ftp, geral, gestor, host, html, ia, interface, ip, lang, log, pagina, paypal, pdf, plugins, plugins-consts, plugins-installer, usuario, variaveis, widgets |
bibliotecas/BIBLIOTECA-<NOME>.md / libraries/LIBRARY-<NAME>.md |
M |
banco |
BIBLIOTECA-BANCO.md + en BANCO-V2-DOCS.md |
M + F |
modelo |
(feita no piloto) | ✔ |
2fa, assets-externos, cron, editor-texto, hooks, html-editor, jwt, modulo-distribuido, oauth, oauth2, recursos, seguranca, sitemap, stripe |
— | N (docs:extract --create) |
| — | bibliotecas/README.md, bibliotecas/ROADMAP.md |
D (substituídos pelo índice gerado e pelo docs:audit) |
2.2 Referência de módulos (reference/modules/<id>.md), 33 módulos
| Destino | Legado | Ação |
|---|---|---|
admin-arquivos, admin-categorias, admin-componentes, admin-environment, admin-layouts, admin-modos-ia, admin-paginas, admin-prompts-ia, admin-templates, contatos, dashboard, modulos, modulos-grupos, modulos-operacoes, publisher, publisher-pages, usuarios, usuarios-perfis, variables |
modulos/<id>.md + manual/modulos/<id>.md |
M + F |
admin-atualizacoes |
modulos/admin-atualizacoes.md + manual/modulos/atualizacoes.md |
M + F |
admin-ia |
modulos/admin-ia.md + manual/modulos/recursos-ia.md |
M + F |
admin-plugins |
modulos/admin-plugins.md + manual/modulos/plugins.md |
M + F |
perfil-usuario |
modulos/perfil-usuario.md + modulos/PERFIL-USUARIO-SIGNUP-HOOKS.md + manual/modulos/meu-perfil.md |
M + F |
forms |
modulos/forms.md |
M |
admin-cron, forms-search, forms-submissions, galleries, interface, pages-index, publisher-highlights, publisher-index |
— | N |
menus |
(feita no piloto) | ✔ |
| — | manual/modulos/{componentes,layouts,paginas,templates}.md |
F nos admin-* equivalentes |
| — | modulos/README.md, manual/README.md, manual/modulos/README.md |
D |
2.3 Conceitos (concepts/)
| Destino | Legado | Ação |
|---|---|---|
architecture.md |
CONN2FLOW-SISTEMA-CONHECIMENTO, CONN2FLOW-GESTOR-DETALHAMENTO, CONN2FLOW-MODULOS-OVERVIEW, CONN2FLOW-MODULOS-DETALHADO |
M + F |
request-lifecycle.md |
CONN2FLOW-ROTEAMENTO-DETALHADO (+ roteador de gestor.php) |
M |
resources.md |
CONN2FLOW-SISTEMA-RECURSOS, CONN2FLOW-LAYOUTS-PAGINAS-COMPONENTES, CORRECOES-CHECKSUM-SHA256 |
M + F |
global-variables.md |
CONN2FLOW-VARIAVEIS-GLOBAIS |
M |
hooks.md |
CONN2FLOW-HOOKS, CONN2FLOW-HOOKS-DISPATCH-BANCO-INTEGRACOES-v1, HOOK-APPLY-FILTERS-HTML-EDITOR-IA |
M + F |
widgets.md |
(trechos de BIBLIOTECA-WIDGETS) |
N |
multilingual.md |
CONN2FLOW-SISTEMA-MULTILÍNGUE-HIBRIDO, CONN2FLOW-SISTEMA-HIBRIDO-MULTILANGUE-CONCLUIDO |
M + F |
plugins.md |
CONN2FLOW-PLUGIN-ARCHITECTURE, CONN2FLOW-PLUGIN-INSTALADOR-FLUXO |
M + F |
projects.md |
CONN2FLOW-SISTEMA-PROJETOS, CONN2FLOW-PROTECAO-BANCO-PROJETOS, CONN2FLOW-AUTOMACAO-EXPORTACAO, CONN2FLOW-HISTORICO-EXPORTACAO |
M + F |
css-and-tailwind.md |
CONN2FLOW-FRAMEWORK-CSS |
M |
admin-interface.md |
en INTERFACE-V2-ARCHITECTURE, CONN2FLOW-SISTEMA-PREVIEW-MODALS, CONN2FLOW-MENU-RESPONSIVO-DASHBOARD-I18N-v2.6.3 |
M + F |
system-updates.md |
CONN2FLOW-ATUALIZACOES-SISTEMA |
M |
ai-security.md |
estrategia-seguranca-ia-publica |
M (avaliar restricted) |
vision/*.md |
visao/* / vision/* |
M (revisar e mover) |
2.4 Guias (guides/) e referência de CLI/API
| Destino | Legado | Ação |
|---|---|---|
guides/installation.md |
CONN2FLOW-INSTALADOR-DETALHADO, CONN2FLOW-ADAPTACAO-POS-INSTALACAO, en PHP85-INSTALL-GUIDE |
M + F. Pedido do Humano (2026-09-25): o guia aponta sempre para a última versão do instalador no GitHub (link estável releases/latest, nunca versão fixa), com o passo a passo de download e instalação. Antecipado para logo após a onda 1. |
guides/development-environment.md |
CONN2FLOW-AMBIENTE-DESENVOLVIMENTO, CONN2FLOW-AMBIENTE-DOCKER, CONN2FLOW-CLOUDFLARE-TUNNEL |
M + F |
guides/dev-tools-vscode.md |
GUIA-PAINEL-DEV-TOOLS-VSCODE |
M |
guides/ci-cd.md |
CONN2FLOW-GITHUB-ACTIONS |
M |
guides/create-a-module.md, guides/create-a-plugin.md, guides/deploy-a-project.md |
— | N |
reference/cli/index.md (+ uma doc por família de comandos) |
— | N (52 comandos em cli/src/Commands) |
reference/api/index.md |
— | N (controladores/api/*) |
2.5 Descartes diretos
README.md da raiz de docs/, CONN2FLOW-CHANGELOG-HISTORY.md (duplica CHANGELOG.md) e changelogs/* (arquivos históricos, já presentes no git e no CHANGELOG.md). Descartados na onda 5, junto com a criação de whats-new/.
3. Ondas
| Onda | Batch | Escopo | Critério de saída |
|---|---|---|---|
| 1 | BATCH-184 | Fundação: concepts/resources, concepts/global-variables, concepts/request-lifecycle, concepts/hooks; bibliotecas banco, gestor, variaveis, pagina, interface |
Score 0 no audit, legado removido, publicado no Lab |
| 2 | a abrir | As outras 38 bibliotecas | idem |
| 3 | a abrir | Os 32 módulos restantes | idem |
| 4 | a abrir | Guias, reference/cli, reference/api |
idem |
| 5 | a abrir | Conceitos restantes, vision/, whats-new/, descartes finais |
docs:audit sem legacy e sem missing |
| 6 | a abrir | SDD do Core publicado no site (pedido do Humano, 2026-09-25): novo publisher docs-sdd com os documentos numerados, human-requests, implementation, decisions, validation e backlog do conn2flow/sdd/ (nunca de projetos privados). Exige um modo "fonte SDD" no docs:build (sem frontmatter: título pelo # H1, seção pela pasta, só pt-br, archive/ resumido) e um filtro de conteúdo sensível (hosts de lab, caminhos de VPS, IPs, e-mails) antes de publicar. |
Páginas SDD publicadas no Lab sem dado sensível; links internos reescritos |
Cada onda pode ser dividida em mais de um batch se a leitura do código exigir. O critério é a qualidade por doc, não a velocidade.