149 lines
6.9 KiB
Markdown
149 lines
6.9 KiB
Markdown
# CC Brief — Bee Regen Execution (writer + sleeping)
|
||
|
||
**Author:** PM (autorizovano bez dodatne Marko ratifikacije — Stavka 1 "sam odradi" direktiva 2026-04-22)
|
||
**For:** Claude Code (waggle-os repo, post Sprint 10 close)
|
||
**Date:** 2026-04-22
|
||
**Task:** Task #24 — Regen 2 preostala bela bee asset-a
|
||
**Priority:** Medium (non-blocking za Sprint 10; unblocks Task #16 + Task #18 post-Sprint-10)
|
||
**Budget:** ≤ $2.00 (2 gens × $0.70-0.90 + $0 upscale/deploy)
|
||
|
||
---
|
||
|
||
## Kontekst (kratko)
|
||
|
||
Post 2026-04-21 batch regen 9 bee personas-a, preostala su 2 asset-a koja zadržavaju white-dominant backgrounds što kvari canon koherenciju sa novih 9. Marko ratifikacija 2026-04-22: regen oba u dark-first canon. Ovaj brief je autorizovan direktno od PM-a kao "sam odradi" tok — CC izvršava bez dodatne Marko ratifikacije dok ne stigne contact sheet za go/no-go na kraju.
|
||
|
||
Source brief sa subject strings i style canon: `briefs/2026-04-22-bee-writer-sleeping-regen-brief.md`. CC čita taj fajl za kompletne subject string-ove; ovaj brief dodaje execution mechanics.
|
||
|
||
---
|
||
|
||
## Execution scope
|
||
|
||
**Autoritativno izvršenje bez dodatnih PM/Marko check-in-ova do contact sheet deliverable-a.**
|
||
|
||
CC ima autoritet da:
|
||
1. Kreira Python gen script u waggle-os tmp folderu (ne commit-uje u repo)
|
||
2. Pokreće Nano Banana Pro gen preko `generativelanguage.googleapis.com/v1beta` sa postojećim Marko GEMINI_API_KEY env varijablom
|
||
3. Radi multi-reference gen (bee-researcher-dark.png + icon-draft-dark.jpeg) verbatim iz 2026-04-21 pipeline-a
|
||
4. Radi Lanczos upscale 1024→2048 preko PIL
|
||
5. Kreira backup folder u waggle-os repo-u pre overwrite-a
|
||
6. Overwritu-je ciljne fajlove u `apps/www/public/brand/`
|
||
7. Generiše 13-tile contact sheet PNG za vizuelni go/no-go
|
||
|
||
CC NEMA autoritet da:
|
||
1. Modifikuje subject strings — koristi verbatim iz source brief-a
|
||
2. Menja style canon (palette, outline weight, composition rules)
|
||
3. Gen dodatne bee personas-e (scope je strogo 2: writer + sleeping)
|
||
4. Modifikuje bilo koji drugi asset u `brand/` folderu osim ciljna 2
|
||
5. Commit-uje rezultat u waggle-os glavnu granu bez PM review-a
|
||
6. Push na origin/main bez PM autorizacije
|
||
|
||
---
|
||
|
||
## Gen run protokol
|
||
|
||
**Step 1 — Prerequisite check:**
|
||
```bash
|
||
# Verify GEMINI_API_KEY present
|
||
# Verify source canon references present:
|
||
# apps/www/public/brand/bee-researcher-dark.png
|
||
# apps/www/public/brand/icon-draft-dark.jpeg
|
||
# Verify PIL available (pip install Pillow if needed)
|
||
```
|
||
|
||
**Step 2 — Backup:**
|
||
```
|
||
mkdir apps/www/public/brand/_backup-pre-regen-20260422-writer-sleeping/
|
||
cp bee-writer-dark.png _backup-pre-regen-20260422-writer-sleeping/
|
||
cp bee-sleeping-dark.png _backup-pre-regen-20260422-writer-sleeping/
|
||
```
|
||
|
||
**Step 3 — Gen writer first:**
|
||
- Subject string: verbatim iz source brief §Character brief — bee-writer-dark
|
||
- Multi-reference: bee-researcher-dark.png (primary) + icon-draft-dark.jpeg (anchor)
|
||
- Native output: 1024×1024
|
||
- Save to tmp path: `tmp/gen-runs/2026-04-22-writer-<ISO>.png`
|
||
|
||
**Step 4 — Internal QA check na writer:**
|
||
Automatski brightness histogram check na raw gen output — ako mean luminance > 0.45 (što bi signaliralo previše belog), flag u log-u i re-gen 1× sa dodatnim emphasis "NO WHITE BACKGROUND" u prompt. Max 2 re-gen pokušaja pre escalation.
|
||
|
||
**Step 5 — Gen sleeping:**
|
||
Ako writer prošao Step 4, prelazi na sleeping sa identičnim protokolom. Subject string verbatim iz source brief §Character brief — bee-sleeping-dark.
|
||
|
||
**Step 6 — Upscale oba:**
|
||
Lanczos PIL upscale 1024→2048 square format. Output:
|
||
- `tmp/gen-runs/bee-writer-dark-2048-2026-04-22.png`
|
||
- `tmp/gen-runs/bee-sleeping-dark-2048-2026-04-22.png`
|
||
|
||
**Step 7 — Contact sheet generation:**
|
||
13-tile contact sheet PNG (5×3 ili 4×4 grid sa 2 filler) combining all 13 bee personas from final state (11 canon + 2 new). Output: `tmp/gen-runs/contact-sheet-13-2026-04-22.png`.
|
||
|
||
**Step 8 — PM delivery:**
|
||
Napisati exit ping u `sessions/2026-04-22-bee-regen-exit.md` sa:
|
||
- Link na contact sheet PNG (relativna putanja)
|
||
- Brightness histogram rezultati za oba gen-a
|
||
- Budget actual iskorišćenje
|
||
- File timestamp i veličina oba final asset-a
|
||
- Eksplicitno: "Awaiting Marko vizuelni go/no-go na contact sheet pre deploy override-a"
|
||
|
||
---
|
||
|
||
## Deploy gate (PM-authorized, not CC-autonomous)
|
||
|
||
CC NE overwrituje ciljne fajlove `bee-writer-dark.png` i `bee-sleeping-dark.png` dok PM ne potvrdi Marko go/no-go na contact sheet. Ovo je single manual gate u inače autonomom toku — zato što overwrite waggle-os repo fajlova zahteva eksplicitnu ratifikaciju per repo access boundaries (`.auto-memory/feedback_repo_access_boundaries.md`).
|
||
|
||
Tok posle CC exit ping-a:
|
||
1. PM pregleda contact sheet
|
||
2. PM šalje Marko kratki ping sa contact sheet preview
|
||
3. Marko: go/no-go
|
||
4. Ako go → PM autorizuje CC da overwrite + create commit + push na origin/main
|
||
5. Ako no-go → PM drafta refinement brief sa specifičnim feedback-om → CC re-gen max 2× → ponovi go/no-go
|
||
|
||
---
|
||
|
||
## Exit criteria (Task #24 CLOSE)
|
||
|
||
- [ ] bee-writer-dark.png 2048×2048 deploy-ovan u `apps/www/public/brand/`, no white dominant area, canon-aligned, Marko go approved
|
||
- [ ] bee-sleeping-dark.png 2048×2048 deploy-ovan u istu putanju, no white dominant area, canon-aligned, Marko go approved
|
||
- [ ] Contact sheet 13×1 prolazi Marko vizuelni go/no-go kao stilski koherentan set
|
||
- [ ] Backup folder `_backup-pre-regen-20260422-writer-sleeping/` postoji u repo-u
|
||
- [ ] Commit na main sa jasnom porukom "brand: regen bee-writer-dark + bee-sleeping-dark (Task #24 CLOSE)"
|
||
- [ ] Push na origin/main
|
||
- [ ] PM exit ping sa Task #24 CLOSE verdict
|
||
|
||
Task #24 CLOSE automatski otvara Task #16 (claude.ai/design upload resume) kao spreman za izvršenje.
|
||
|
||
---
|
||
|
||
## Escalation triggers
|
||
|
||
1. **Gen API failure / auth error** — 2 retry max, pa IMMEDIATE PM ping
|
||
2. **Budget alarm > $2.00 hit** — IMMEDIATE PM ping, pauza run
|
||
3. **Brightness histogram fail posle 2 re-gen pokušaja** — IMMEDIATE PM ping, ne proceed sa drugim asset-om
|
||
4. **PIL / upscale library issue** — IMMEDIATE PM ping
|
||
5. **Repo write permission issue** — IMMEDIATE PM ping, ne pokušavaj da force
|
||
|
||
---
|
||
|
||
## Anti-pattern check
|
||
|
||
- Ne scope-creepuj u gen dodatnih assets-a (celebrating, researcher koji su canon reference)
|
||
- Ne modifikuj subject strings da "poboljšaš" output — verbatim iz source brief-a
|
||
- Ne commit-uj tmp gen runs u repo — tmp ostaje u `tmp/gen-runs/`
|
||
- Ne overwrituj ciljne fajlove pre Marko go na contact sheet
|
||
- Ne push bez PM autorizacije
|
||
|
||
---
|
||
|
||
## Related
|
||
|
||
- `briefs/2026-04-22-bee-writer-sleeping-regen-brief.md` — source subject strings + style canon
|
||
- `.auto-memory/project_bee_assets_regen.md` — prethodni 2026-04-21 regen pipeline i learnings
|
||
- `.auto-memory/feedback_repo_access_boundaries.md` — waggle-os write governance
|
||
- `decisions/2026-04-22-personas-card-copy-locked.md` — sibling LOCKED
|
||
- `decisions/2026-04-22-landing-personas-ia-locked.md` — sibling LOCKED
|
||
|
||
---
|
||
|
||
**End of brief. Autorizovano za izvršenje post Sprint 10 close. PM on call za 5 escalation triggers.**
|