ai-workflow-skill/docs/roadmaps/archive/web-product-monorepo-doc.md

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

• create an active execution roadmap for this documentation workstream
• add the web-product monorepo planning document under docs/
• update the implementation roadmap to reference the new document
• validate the changed docs for consistency
• 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