Skip to content

docs: prune private-era planning notes - #5

Merged
saagpatel merged 2 commits into
mainfrom
codex/public-docs-prune
May 18, 2026
Merged

docs: prune private-era planning notes#5
saagpatel merged 2 commits into
mainfrom
codex/public-docs-prune

Conversation

@saagpatel

Copy link
Copy Markdown
Owner

What

  • Remove private-era roadmap, sprint, handoff, decision, and agent execution notes from the public docs tree.
  • Add docs/project-history.md as a concise public history page and keep docs/plans/README.md as a redirect-style archive note.
  • Move the still-useful approval packet checklist into docs/writeback-safety-model.md and update doc-contract tests to use active docs.

Why

The repo is public now. The old planning files were not secret-bearing, but they exposed local-path and worker-instruction noise that made the project look like an internal operating log instead of a maintained public tool.

How

  • Kept current product docs authoritative: README, modes, architecture, release gates, weekly review, and writeback safety.
  • Pruned detailed historical plans from docs/plans/ and docs/superpowers/.
  • Preserved the project-level lessons in a short public history page.

Testing

  • python3 -m pytest -q -p no:cacheprovider - 2066 passed, 2 skipped, 1 warning.
  • ruff check src/ tests/ - passed.
  • Markdown local link check - passed.
  • gitleaks detect --source . --redact --verbose - no leaks found.

Performance Impact

None expected; docs and doc-contract tests only.

Risk / Notes

  • This intentionally removes old detailed planning files from the current public tree. They remain in git history, but no longer appear as active documentation.
  • Local git push is blocked by app policy in this environment, so the branch commit was created through the GitHub API.

saagpatel added 2 commits May 18, 2026 01:15
- Replace detailed historical planning files with concise public history docs
- Move approval packet checklist into the active writeback safety model
- Update doc-contract tests to assert against active public docs

Tests: python3 -m pytest -q -p no:cacheprovider; ruff check src/ tests/; markdown local link check; gitleaks detect --source . --redact --verbose
- Replace detailed historical planning files with concise public history docs
- Move approval packet checklist into the active writeback safety model
- Update doc-contract tests to assert against active public docs

Tests: python3 -m pytest -q -p no:cacheprovider; ruff check src/ tests/; markdown local link check; gitleaks detect --source . --redact --verbose
@saagpatel
saagpatel merged commit 38cf6b1 into main May 18, 2026
1 check passed
@saagpatel
saagpatel deleted the codex/public-docs-prune branch June 12, 2026 12:18
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