# 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