Skip to content

docs: consolidate per-module STATUS/PLAN notes into AGENTS.md#526

Merged
andiwand merged 1 commit into
mainfrom
refactor-agent-md-files
Jun 14, 2026
Merged

docs: consolidate per-module STATUS/PLAN notes into AGENTS.md#526
andiwand merged 1 commit into
mainfrom
refactor-agent-md-files

Conversation

@andiwand

@andiwand andiwand commented Jun 13, 2026

Copy link
Copy Markdown
Member

Converges the untracked per-module STATUS.md + PLAN.md (and the PDF PLAN-stage0.md subplan) into a single AGENTS.md per module, so the agent notes can be tracked in git instead of living as untracked scratch files — and are picked up by the repo's agent-instruction discovery convention, which looks for AGENTS.md (not AGENT.md).

What changed

Each module now has one AGENTS.md reading top-to-bottom — scope → what works → layout → pipeline → design decisions → tests → open work:

Module Was Now
pdf/ STATUS + PLAN + PLAN-stage0 AGENTS.md
oldms/ STATUS + PLAN AGENTS.md
oldms/text/ STATUS + PLAN AGENTS.md
oldms/presentation/ STATUS + PLAN AGENTS.md
oldms/spreadsheet/ STATUS + PLAN AGENTS.md

Trimming & accuracy

  • PDF stage 0 folded down. WP1–4 (filters, xref/object streams, inherited attributes, encryption) have landed, so the detailed per-WP design (now in the code) is dropped; only the remaining WP5 xref-recovery work and the forward roadmap (stages 1–5) are kept, with verbose justifications tightened.
  • Fixed two stale facts in the root AGENTS.md: it called .xls "planning notes only" (actually working BIFF8 text extraction with tests) and linked the now-removed STATUS.md/PLAN.md paths.
  • Verified module file-listing tables against the directories; no source comments or READMEs referenced the old filenames. Tracked README.md files (reference links) left untouched.

Docs only — no code changes.

Base automatically changed from pdf-stage0-encryption to main June 13, 2026 23:32
@andiwand andiwand force-pushed the refactor-agent-md-files branch from ff5ada0 to f0d04b0 Compare June 14, 2026 07:46
@andiwand andiwand marked this pull request as ready for review June 14, 2026 08:53
@andiwand andiwand enabled auto-merge (squash) June 14, 2026 08:53

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f0d04b04af

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread AGENT.md Outdated
Converge the untracked per-module STATUS.md + PLAN.md (and the PDF
PLAN-stage0.md subplan) into a single AGENTS.md per module, so the agent
notes are tracked in git and auto-loaded by the repo's agent-instruction
discovery convention (which looks for AGENTS.md, not AGENT.md).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@andiwand andiwand force-pushed the refactor-agent-md-files branch from f0d04b0 to be15b48 Compare June 14, 2026 09:01
@andiwand andiwand changed the title docs: consolidate per-module STATUS/PLAN notes into AGENT.md docs: consolidate per-module STATUS/PLAN notes into AGENTS.md Jun 14, 2026
@andiwand andiwand enabled auto-merge (squash) June 14, 2026 09:02
@andiwand andiwand disabled auto-merge June 14, 2026 09:43
@andiwand andiwand merged commit 77242a7 into main Jun 14, 2026
11 checks passed
@andiwand andiwand deleted the refactor-agent-md-files branch June 14, 2026 09:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant