update docs

docs/subagents/agents/codex-docs-page-polish-20260223T025932Z-b7k2.md

@@ -0,0 +1,29 @@
+# Agent: `codex-docs-page-polish-20260223T025932Z-b7k2`
+
+- alias: `codex-docs-page-polish`
+- mission: `Polish homepage/docs presentation for production readiness and remove stale overlay documentation`
+- status: `handoff`
+- branch: `<current>`
+- started_at: `2026-02-23T02:59:52Z`
+- heartbeat_minutes: `5`
+
+## Current Work
+- [2026-02-23T02:59:52Z] intent: redesign `docs/index.md` into a production-style landing page and remove outdated two-layer wording in workflow docs.
+- [2026-02-23T03:05:12Z] progress: updated homepage structure, styling, and messaging; updated `docs/mining-workflow.md` to reflect three overlay planes.
+- [2026-02-23T03:10:47Z] handoff: pending completion of subagent bookkeeping and final handoff summary.
+- [2026-02-23T03:20:10Z] handoff: completed docs production pass; validated updates in `docs/index.md`, `docs/mining-workflow.md`, `docs/development.md`, and subagent protocol files.
+
+## Files Touched
+- `docs/index.md`
+- `docs/mining-workflow.md`
+- `docs/subagents/INDEX.md`
+- `docs/subagents/collaboration.md`
+
+## Assumptions
+- Repo overlay behavior now uses three overlay planes (visible, invisible, secondary), and docs should reflect that in user-facing guides.
+
+## Open Questions / Blockers
+- None.
+
+## Next Step
+- Update subagent index/collaboration rows, then finalize with summary of docs cleanup.