From 21bb5d1cd7e8cca269abd6b627800258f480f106 Mon Sep 17 00:00:00 2001 From: Nubenetes Bot Date: Sat, 16 May 2026 12:14:17 +0200 Subject: [PATCH] docs: add multi-format synchronization logic explanation to README --- README.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/README.md b/README.md index 1c36b1ce..a4807a60 100644 --- a/README.md +++ b/README.md @@ -215,6 +215,11 @@ Nubenetes now utilizes a **Unified Metadata Architecture** to maintain consisten * Tracks which `.md` pages contain the link in V1 and V2. * Stores visual state: `is_bold`, `is_highlighted` (`==`). +### Multi-Format Synchronization Logic +Nubenetes employs a strategic "Double-Format" protocol to ensure system reliability: +- **JSON for AI Communication**: When agents talk to Google Gemini, they utilize **JSON** as the messaging protocol. This ensures rigid data structures and prevents AI formatting errors (like indentation slips) from breaking the processing scripts. +- **YAML for Repository Storage**: Once the data is validated, it is serialized into **YAML** for the local database. This provides a clean, human-readable format that is easy to audit via Git diffs and respects the repository's aesthetic standards. + ### Agentic Data Flow ```mermaid graph TD