docs: add AGENTS.md for odf and ooxml modules#602
Open
andiwand wants to merge 1 commit into
Open
Conversation
Add design/orientation docs for AI agents covering the ODF and OOXML engines, aligned with the existing oldms/ and pdf/ AGENTS.md style: rationale, load-bearing design decisions, and current status/gaps rather than restating code (feature checklists stay in the READMEs). - odf/: central doc for all four ODF types (one engine) - ooxml/: central doc (shared packaging/encryption/OPC relationships) plus per-format docs for text (docx), presentation (pptx), spreadsheet (xlsx) - link the new docs from the top-level AGENTS.md directory map Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NDRJJ85vgG6umQvdpNYYU8
This was referenced Jul 13, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🤖 Generated with Claude Code
Adds design/orientation docs (
AGENTS.md) for the ODF and OOXML engines, aligned with the existingoldms/andpdf/docs: rationale, load-bearing design decisions, and current status/gaps — not a restatement of code. Feature checklists stay in the per-moduleREADME.mds to avoid duplication.New files
src/odr/internal/odf/AGENTS.md— central ODF doc (all four types in one engine)src/odr/internal/ooxml/AGENTS.md— central OOXML doc (shared packaging / encryption / OPC relationships)src/odr/internal/ooxml/text/AGENTS.md— docxsrc/odr/internal/ooxml/presentation/AGENTS.md— pptxsrc/odr/internal/ooxml/spreadsheet/AGENTS.md— xlsxAGENTS.mddirectory map now links the new docsFraming
oldms/pdf, ODF and OOXML keep the parsed XML DOM resident and theElementRegistryis a thin index ofpugi::xml_nodes over it — which is why ODF and docx alone can edit and save.Notable gaps surfaced from reading the code
table_first_columnthrows;table_dimensionsstill queries ODFtable:names — copy-pasted from the ODF adapter). The same ODF-name copy-paste is latent in the docx table/cell adapter.is_text_nodecopy-paste bug (checksw:tinstead ofa:t); full but unexposed text-edit machinery.These latent-bug items are flagged as "verify and rewrite" rather than asserted as confirmed runtime failures, since they come from code reading, not execution.