feat: add prototype syncing for local dev and AI context

This commit introduces a new feature to synchronize prototypes
from an external repository for local development and to provide
context for AI tools.

- Added `make sync-prototypes` target to Makefile to build and
 copy prototypes from the adjacent 'client-krow-poc' repository.
- Added `.geminiignore` entries to prevent Gemini from ignoring
 prototypes, ensuring they are available for context.
- Added `.gitignore` entries to ignore generated prototype files,
 except for the `.keep` files, to keep the directories.
- Added `04-sync-prototypes.md` documentation to explain how to
 sync prototypes.
- Removed empty `internal/prototypes/.keep` file.

.geminiignore

@@ -77,6 +77,9 @@ __pycache__/
 # -----------------------------------------------------------------------------
 # Specific Directories
 # -----------------------------------------------------------------------------
+# Prototypes: We WANT Gemini to see these for context if they are synced locally,
+# even if they are ignored by Git. So we do NOT ignore them here.
+
 # Temporary migration folders
 _legacy/
 krow-workforce-export-latest/

.gitignore

@@ -159,6 +159,12 @@ __pycache__/
 # unless it contains sensitive info. Here we explicitly ignore the raw file.
 internal/launchpad/iap-users.txt
 
+# Generated Prototypes (must be synced locally via 'make sync-prototypes')
+internal/launchpad/prototypes/web/*
+!internal/launchpad/prototypes/web/.keep
+internal/launchpad/prototypes/mobile/**/*
+!internal/launchpad/prototypes/mobile/**/.keep
+
 # Temporary migration artifacts
 _legacy/
 krow-workforce-export-latest/

Makefile

@@ -41,6 +41,7 @@ help:
 	@echo ""
 	@echo "  --- DEVELOPMENT TOOLS ---"
 	@echo "  make install-git-hooks - Installs git pre-push hook to protect main/dev branches."
+	@echo "  make sync-prototypes   - Builds and copies prototypes from adjacent 'client-krow-poc' repo."
 	@echo ""
 	@echo "  --- DATA CONNECT MANAGEMENT ---"
 	@echo "  make dataconnect-init         - Initializes Firebase Data Connect."

README.md

@@ -62,6 +62,7 @@ This project uses a modular `Makefile` for all common tasks.
 -   **[01-backend-api-specification.md](./docs/01-backend-api-specification.md)**: (Legacy) Reference for data schemas.
 -   **[02-codemagic-env-vars.md](./docs/02-codemagic-env-vars.md)**: Guide for CI/CD environment variables.
 -   **[03-contributing.md](./docs/03-contributing.md)**: Guidelines for new developers and setup checklist.
+-   **[04-sync-prototypes.md](./docs/04-sync-prototypes.md)**: How to sync prototypes for local dev and AI context.
 
 ## 🤝 Contributing
 New to the team? Please read our **[Contributing Guide](./docs/03-contributing.md)** to get your environment set up and understand our workflow.

makefiles/tools.mk

@@ -1,8 +1,12 @@
 # --- Development Tools ---
 
-.PHONY: install-git-hooks
+.PHONY: install-git-hooks sync-prototypes
 
 install-git-hooks:
 	@echo "--> Installing Git hooks..."
 	@ln -sf ../../scripts/git-hooks/pre-push .git/hooks/pre-push
 	@echo "✅ pre-push hook installed successfully. Direct pushes to 'main' and 'dev' are now blocked."
+
+sync-prototypes:
+	@echo "--> Synchronizing prototypes from external repository..."
+	@./scripts/sync-prototypes.sh