{"slug": "keeping-project-decisions-across-claude-code-and-codex-sessions-with-docs", "title": "Keeping project decisions across Claude Code and Codex sessions with docs-governance", "summary": "A developer released docs-governance, an MIT-licensed project of reusable skills, templates, and audit scripts that uses small Markdown files to preserve project decisions, constraints, and status across Claude Code and Codex coding-agent sessions. The workflow splits context into rules, decision records, navigation notes, status files, and change logs so a fresh session can recover why a design was chosen rather than only reading the code. The developer asks for feedback on whether the audit surfaces useful problems and whether keeping the records current is manageable in existing projects.", "body_md": "A fresh coding-agent session can read the code, but the reasons behind it are often harder to recover. Why was a design chosen? Which paths are misleading? What is a regression test protecting?\n\nI built docs-governance to make that context easier to maintain across Claude Code and Codex sessions. It is an MIT-licensed project with reusable skills, templates, and audit scripts.\n\nThe basic workflow uses small Markdown files with different responsibilities:\n\nLarger projects can add architecture documents, decision records, interface contracts, and test evidence as needed. The aim is to give the next session a clear place to look without putting every detail into one growing instruction file.\n\nSuppose a regression test protects an unusual compatibility requirement. The test shows the expected behavior but may not explain why a simpler implementation is wrong.\n\nIn this workflow, the lasting constraint belongs in the rules or a decision record. Navigation notes point to the relevant module and test. Current status records unfinished work. The change log records what changed and why. This is an example of organizing context, not a guarantee that an agent will follow it perfectly.\n\nYou can begin with a governance audit before changing existing project documents. The repository includes installation instructions for Claude Code and Codex and the shared methodology.\n\n[https://github.com/qshanx/docs-governance](https://github.com/qshanx/docs-governance)\n\nThese records still need maintenance. Stale status notes or outdated decisions can mislead the next session. I would appreciate feedback on whether the audit identifies useful problems and whether keeping the files current is manageable in an existing project.\n\nIf you try it, an issue describing what worked or failed would help shape the project. A GitHub star is welcome if you want to follow development.\n\nHow do you preserve project decisions between coding-agent sessions today?", "url": "https://wpnews.pro/news/keeping-project-decisions-across-claude-code-and-codex-sessions-with-docs", "canonical_source": "https://dev.to/_665ebb9fe210726956bcdb/keeping-project-decisions-across-claude-code-and-codex-sessions-with-docs-governance-3aaj", "published_at": "2026-09-27 02:54:23+00:00", "updated_at": "2026-09-27 03:30:35.167671+00:00", "lang": "en", "topics": ["ai-agents", "developer-tools", "ai-tools", "mlops"], "entities": ["docs-governance", "Claude Code", "Codex", "GitHub", "qshanx"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/keeping-project-decisions-across-claude-code-and-codex-sessions-with-docs", "markdown": "https://wpnews.pro/news/keeping-project-decisions-across-claude-code-and-codex-sessions-with-docs.md", "text": "https://wpnews.pro/news/keeping-project-decisions-across-claude-code-and-codex-sessions-with-docs.txt", "jsonld": "https://wpnews.pro/news/keeping-project-decisions-across-claude-code-and-codex-sessions-with-docs.jsonld"}}