Move agent journals to the unified wiki knowledge base

[Sistema2D]

Language / Idioma:
PT-BR | EN-US

---

PT-BR - Mover os journals dos agentes para a wiki unificada

Contexto

Atualmente, os agentes podem gerar e manter arquivos de Journal como parte do processo incremental de registro de conhecimento, decisões, aprendizados, observações e histórico operacional.

No entanto, quando esses journals ficam fora da estrutura central da wiki, a base de conhecimento incremental pode se tornar fragmentada, dificultando consulta, manutenção, auditoria e reutilização por outros agentes ou por pessoas envolvidas no projeto.

Problema

A ausência de um caminho oficial e padronizado para os journals dos agentes pode gerar inconsistência na organização da documentação. Diferentes agentes podem salvar seus registros em locais distintos, com nomes variados ou fora da estrutura principal de conhecimento do FrameCode VibeWork.

Isso pode causar:

• dispersão da base de conhecimento incremental;
• dificuldade para localizar o histórico de um agente específico;
• perda de contexto entre execuções;
• duplicidade de registros;
• menor previsibilidade para auditoria e manutenção;
• enfraquecimento da wiki como fonte central de conhecimento do framework.

Proposta

Mover o Journal gerado e mantido pelos agentes para a wiki, utilizando o caminho padronizado:

FCVW/wiki/agents/<nome do agente>_journal.md

Essa mudança deve garantir que toda a base de conhecimento incremental permaneça centralizada, unificada e acessível dentro da estrutura oficial da wiki.

Diretriz recomendada

Cada agente deve manter seu próprio arquivo de Journal dentro de FCVW/wiki/agents/, usando um nome previsível e derivado do nome do agente.

Exemplo:

FCVW/wiki/agents/refactor_agent_journal.md
FCVW/wiki/agents/audit_agent_journal.md
FCVW/wiki/agents/planning_agent_journal.md

O Journal deve ser tratado como parte da base de conhecimento incremental do projeto, e não como um artefato isolado ou temporário.

Arquivos provavelmente afetados

• AGENTS.md
• FCVW/WORKFLOW.md
• FCVW/AUDIT.md
• FCVW/wiki/README.md, se existir
• FCVW/wiki/agents/, se a estrutura ainda não existir
• Qualquer documentação que mencione o local atual dos journals dos agentes

Critérios de aceitação

• A documentação define FCVW/wiki/agents/<nome do agente>_journal.md como caminho oficial para journals dos agentes.
• Cada agente passa a ter um Journal próprio e previsível dentro de FCVW/wiki/agents/.
• AGENTS.md orienta os agentes a criar, atualizar e consultar seus journals nesse caminho.
• A wiki passa a ser reconhecida como local central da base de conhecimento incremental.
• Journals existentes fora da wiki são movidos ou referenciados a partir do novo caminho.
• AUDIT.md verifica se os journals dos agentes estão no local correto.
• A documentação evita múltiplos caminhos concorrentes para o mesmo tipo de registro.

---

EN-US - Move agent journals to the unified wiki knowledge base

Context

Agents may currently generate and maintain Journal files as part of the incremental process of recording knowledge, decisions, lessons learned, observations, and operational history.

However, when these journals are stored outside the central wiki structure, the incremental knowledge base may become fragmented, making it harder to search, maintain, audit, and reuse by other agents or people involved in the project.

Problem

The absence of an official and standardized path for agent journals may lead to inconsistent documentation organization. Different agents may store their records in different locations, with different naming conventions, or outside the main FrameCode VibeWork knowledge structure.

This may cause:

• fragmentation of the incremental knowledge base;
• difficulty locating the history of a specific agent;
• loss of context between executions;
• duplicated records;
• reduced predictability for audit and maintenance;
• weakening of the wiki as the framework’s central knowledge source.

Proposal

Move the Journal generated and maintained by the agents to the wiki, using the standardized path:

FCVW/wiki/agents/<agent_name>_journal.md

This change should ensure that the entire incremental knowledge base remains centralized, unified, and accessible within the official wiki structure.

Recommended guideline

Each agent should maintain its own Journal file under FCVW/wiki/agents/, using a predictable name derived from the agent name.

Example:

FCVW/wiki/agents/refactor_agent_journal.md
FCVW/wiki/agents/audit_agent_journal.md
FCVW/wiki/agents/planning_agent_journal.md

The Journal should be treated as part of the project’s incremental knowledge base, not as an isolated or temporary artifact.

Likely affected files

• AGENTS.md
• FCVW/WORKFLOW.md
• FCVW/AUDIT.md
• FCVW/wiki/README.md, if it exists
• FCVW/wiki/agents/, if the structure does not exist yet
• Any documentation that mentions the current location of agent journals

Acceptance criteria

• The documentation defines FCVW/wiki/agents/<agent_name>_journal.md as the official path for agent journals.
• Each agent has its own predictable Journal inside FCVW/wiki/agents/.
• AGENTS.md instructs agents to create, update, and consult their journals in this path.
• The wiki is recognized as the central location for the incremental knowledge base.
• Existing journals outside the wiki are moved or referenced from the new path.
• AUDIT.md verifies whether agent journals are stored in the correct location.
• The documentation avoids multiple competing paths for the same type of record.