Competition submission

Owner of the text and the go/no-go checklist: the product-manager agent. Deploy config: the pwa-engineer agent. The user submits the form. Agents never submit, e-mail or post anything.

Facts as of 2026-10-24 (re-check docs/product/competition-brief.md and the site before submitting): deadline 30.11.2026, end of day, Polish time. The page also showed "Nabór zakończony" next to the deadline, so the user confirms with the organisers that entries are open.

1. Deploy (Vercel)

• Production = main. main is the only branch and GitHub's default (2026-10-28). Deploy it with pnpm run deploy:prod (tools/deploy-prod.mjs): it refuses anything but a clean main that matches origin/main, then runs vercel deploy --prod. The pre-bash hook asks before it, because it changes what the jury sees. Production URL: https://sprawnie-prototype.vercel.app.
• Not connected to GitHub yet: Vercel builds only when someone runs the deploy. Once the user connects the repo (Vercel → Project → Settings → Git, production branch main), every push to main deploys production by itself and other branches get preview URLs; deploy:prod then stays as the manual fallback.
• Preview URLs sit behind Vercel login: use them for review, never hand one to the jury.
• Vercel project settings: root apps/pwa, build pnpm run build, output dist, Node 22. Turn off Deployment Protection on production so the link works without login, and check it in a private window.
• LLM proxy env vars only if the live assistant is part of the demo. Without them the app must still be complete (scripted mode).
• The link must stay up until the results are announced: no free-tier limits that could pause it, no expiring preview links, and nobody deletes the project.

2. Jury-eye checks (on the production URL)

1. A private window on a phone (iOS Safari and Android Chrome): opens without login, start screen, disclaimer visible, persona choice obvious.
2. "Try it in 60 seconds": from a cold open, the main demo matter finishes in ≤ 3 taps after choosing a persona.
3. Desktop browser: the phone frame renders well (the jury may open it on a laptop).
4. Flaky network: throttle to Slow 4G and load. Then go offline after the first load and reload; the demo still works.
5. Install on both platforms (the pwa-platform skill), then reset the demo.
6. Lighthouse mobile: record the numbers for the description if they're good.
7. pnpm run audit:guardrails, then look at every document view for the watermark and disclaimer (the prototype-guardrails skill).
8. Deep links work: /?osoba=<id> and a direct link to the showcase matter.

3. Form fields

Field	Notes
Name / team name	the user decides
E-mail, city, category	the user's
Concept title	short, our own name, not "mObywatel 2.0" as a mark
Description	30–4000 characters; template below; count with wc -m
Prototype link	https://, production, no login
Extra link (optional)	demo video
Polish technologies (optional)	e.g. Bielik / PLLuM via the provider port, only if actually used and tested
Website (optional)	repo or team page if public
Consents	rules + contact; publication consent applies only if selected

4. Description template (Polish, plain, ≤ 4000 characters)

Problem — one or two sentences: what is hard today (concrete matter, concrete person).
Co działa lepiej niż w prototypie referencyjnym — 3–5 bullets, each measurable:
  "Meldunek: 3 kroki zamiast wizyty w urzędzie" (step counts from docs/services/),
  "Tryb seniora: większy tekst, mniej wyborów, czytanie na głos",
  "Działa offline i instaluje się jak aplikacja".
Komu pomaga — personas in one line each.
Jak sprawdzić w 60 sekund — link, choose persona X, tap A → B → C.
Technologia — PWA, works on any phone; assistant scripted by default, optional Polish model.
Zastrzeżenie — nieoficjalny prototyp, dane fikcyjne.

Every claim must be backed by a flow that works on the production link today. The product-manager agent checks each line against the code (the product-knowledge skill).

5. Demo video (optional, recommended)

We have one: "Jeden dzień z aplikacją", built with Remotion in apps/video (plan and rules: docs/product/demo-video.md). The landing page's "Demo" section plays apps/pwa/public/video/demo-v<n>.mp4 with captions in the page language. For the form, pnpm run render:demo -- --napisy also writes apps/video/out/demo-v<n>-napisy.mp4 with Polish captions burned in. Host it somewhere that stays up (unlisted YouTube or Vimeo).

• Re-render in the last week, so the screens match the final app. Bump the version in apps/video/scripts/render.mjs and DEMO_VIDEO in apps/pwa/src/features/showcase/demo.ts together.
• Watch every frame before upload: no official marks, the "PROTOTYP · nieoficjalny" badge always visible, proposals marked "Propozycja". No script can look inside an MP4.

6. Final checklist and freeze

• pnpm run ci:quality and pnpm run test:e2e green on main
• Production deploy of that commit; URL checked in a private window on two phones
• Guardrails audit clean; disclaimer and watermark visible; no official marks anywhere
• Description ≤ 4000 characters, claims verified, link inside correct
• Video link works logged out; demo video re-rendered from the final app and watched frame by frame
• Organisers confirmed entries are open

Freeze: no production deploys in the last 48 hours before the deadline except fixes for a broken jury path, each confirmed by the user. After submission, production changes only with the user's say-so. The jury may be looking at it at any moment.