Add web product monorepo planning docs

2026-03-20 00:05:22 +08:00
parent b6ba470190
commit 0355d7a847
3 changed files with 487 additions and 1 deletions
@@ -0,0 +1,56 @@
+# Web Product Monorepo Doc
+
+## Status
+
+- `completed`
+
+## Owner
+
+- Codex
+
+## Started At
+
+- `2026-03-19`
+
+## Goal
+
+- Capture the agreed monorepo skeleton and web-product backend/frontend direction in a durable project document under `docs/`.
+- Keep the implementation roadmap synchronized so future agents can pick up the web milestone without rediscovering the repository shape.
+
+## Scope
+
+- add a new planning document for the web-product monorepo direction
+- update the implementation roadmap to reference the new document
+- archive this execution roadmap when the documentation work is complete
+
+## Checklist
+
+- [x] create an active execution roadmap for this documentation workstream
+- [x] add the web-product monorepo planning document under `docs/`
+- [x] update the implementation roadmap to reference the new document
+- [x] validate the changed docs for consistency
+- [x] archive this execution roadmap with a completion summary
+
+## Files
+
+- `docs/web-product-monorepo.md`
+- `docs/implementation-roadmap.md`
+- `docs/roadmaps/active/web-product-monorepo-doc.md`
+
+## Decisions
+
+- keep the work scoped to documentation and roadmap sync rather than implementation
+- treat the current repository as the future backend monorepo root rather than proposing an immediate backend repo split
+
+## Blockers
+
+- none
+
+## Next Step
+
+- use `docs/web-product-monorepo.md` as the planning reference when implementation starts for `cmd/orchd`, `apps/web`, and the shared application/query layers
+
+## Completion Summary
+
+- added `docs/web-product-monorepo.md` to capture the agreed monorepo skeleton, React frontend direction, `chi` backend direction, and phased migration plan
+- updated `docs/implementation-roadmap.md` so future agents can discover and use the new web-product planning document as the next milestone entrypoint