oleg.m/waggle-os
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
0c3e2ead3beaffba9d5004ef7fd87d871d5e6886
waggle-os/docs/briefs/2026-04-22-cc-bee-regen-execution.md
Oleg Maslov 0c3e2ead3b
Some checks failed
Installer Smoke / installer-smoke (push) Has been cancelled
Details
moving
2026-09-02 10:10:29 +02:00

6.9 KiB
Raw Blame History

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:

# 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.

Reference in New Issue View Git Blame Copy Permalink