README
Documentation index This folder is the source of truth for project docs, day-to-day handoff notes, and decisions. Quick links - Handoff (start...
Documentation index This folder is the source of truth for project docs, day-to-day handoff notes, and decisions. ### Quick links - Handoff (start here): `docs/HANDOFF.
Documentation index
This folder is the source of truth for project docs, day-to-day handoff notes, and decisions.
Quick links
- Handoff (start here):
docs/HANDOFF.md - Changelog:
CHANGELOG.md - Merchant docs (launch readiness):
docs/merchant/README.md - Deploy (staging on Render):
docs/deploy/render.md - Runbook (how to run/operate/debug):
docs/RUNBOOK.md - Architecture (high-level system overview):
docs/ARCHITECTURE.md - Decision log (ADRs):
docs/decisions/ - Daily handoffs:
docs/handoff/ - App Store materials:
docs/app-store/ - Spikes / research:
docs/spikes/
How to keep this useful
- Update a daily handoff note whenever you stop mid-stream (even if it’s 5 minutes).
- Record meaningful product/technical choices as ADRs (short and skimmable).
- Add user-facing changes (or operationally relevant changes) to the changelog.
Provenance
- Source file:
docs/README.md - Source URL: https://github.com/maggielerman/shopify-ai-product-optimizer/blob/main/docs/README.md