component-standardize

name: component-standardize description: Orkestrator (dirigent) standardizacije komponente — čita konsolidovani full-audit, pravi task-listu, dispatchuje taskove jedan-po-jedan uz nezavisnu verifikaciju, beleži lessons i staje na rizik-tačkama radi korisničke potvrde. version: 1.0 complexity: L3 category: combined depends_on: - component-full-audit - pre-flight - component-contract-fix - post-op-verify used_by: []

Skill: Component Standardize (Orkestrator)

🛡️ Mandatory Compliance (Workflow Gates)

[!IMPORTANT] Ovaj skill je podređen globalnim pravilima projekta. Nepoštovanje workflow-a smatra se kritičnim neuspehom.

1. DOKUMENTACIJA JE ZAKON: Pročitaj rules.md i README.md.
2. /pre-flight: Mora se pokrenuti PRE svake izmene koda (per-task).
3. /post-op: Mora se pokrenuti POSLE svake izmene koda (per-task verifikacija).
4. PLANNING GATE (Rule #12): Plan/task lista se prezentuje i čeka korisničko odobrenje PRE izvršenja.
5. CROSS-REPO: Svaka izmena DynUI Prisma baze/registry-ja/docs je SAMO predlog uz needs_user_confirmation.

🎯 Cilj

Dirigent koji vodi komponentu do potpune usaglašenosti u Form Studiju, povezujući postojeće skilove i provere u jedan tok: čita konsolidovani FULL-AUDIT, pretvara nalaze u task-listu sa predlozima rešenja, dispatchuje taskove jedan po jedan uz nezavisnu verifikaciju (skripta/tsc/post-op, nikad self-report), beleži svaku nepokrivenu situaciju u lessons-learned, i staje na rizik-tačkama radi korisničke potvrde.

Izvršni model (bitno): Orkestrator = glavni agent koji prati ove instrukcije. Stanje i handoff žive u cache fajlovima (.agents/cache/), tako da fresh agent može da nastavi sred-run. Samo glavni agent može da pita korisnika → sve HARD kapije su u glavnoj petlji (preko AskUserQuestion). Sub-agenti su opcioni akcelerator za teške izolovane taskove, ne nosilac procesa.

Protokol statusa, handoff blok i lifecycle: docs/guides/ORCHESTRATION-PROTOCOL.md.

📥 Ulaz (Input)

• Obavezan: putanja do .agents/cache/FULL-AUDIT__<Component>__<TS>.json (ili registryKey — tada prvo pokreni component-full-audit).
• Implicitno: korisnička potvrda na HARD kapijama.

📤 Izlaz (Output)

• Task fajl: .agents/cache/active/STANDARDIZE__<Component>__<TIMESTAMP>.md (po TASK-TEMPLATE).
• Per-task tragovi: PREFLIGHT__* i POSTOP__* po svakom tasku (izvor znanja + šta je promenjeno).
• Završni: .agents/cache/STANDARDIZE__<Component>__<TS>.md (status DONE) + dopune u COMPONENT-STABILIZATION-LESSONS.md. (Prefiks za ovaj skill: STANDARDIZE)

📋 Koraci

Korak A — Učitaj audit i napravi task-listu

• Učitaj FULL-AUDIT__*.json; grupiši findings po seam (generation → consumption → rag → zona-b).
• Kreiraj .agents/cache/active/STANDARDIZE__<Component>__<TS>.md iz TASK-TEMPLATE: po jedan task po nalazu/grupi, sa [STATUS: TODO], predlogom rešenja, i na dnu handoff blokom (next_skill/next_agent/instructions/updated_at).
• Tranzicija: FULL-AUDIT ACTIVE → IN_PROGRESS; task fajl PENDING_APPROVAL.

Korak B — HARD KAPIJA #1 (prvi task)

• Prezentuj task-listu korisniku (AskUserQuestion): opcije Nastavi prvi task (Preporuka) / Izmeni redosled-obim / Other (komentar). Tek po odobrenju → task fajl APPROVED.

Korak C — Petlja po tasku (redom)

Za svaki task (status TODO → IN_PROGRESS):

1. pre-flight za taj task → PREFLIGHT__<task>__<TS>.md (izvor znanja, blast radius).
2. Izvrši fix:
   • DB/JSON nalazi (default_null/placement/missing/extra/empty_options/case_duplicate) → component-contract-fix logika (cross-repo = predlog + potvrda).
   • Consumption/UI nalazi (enrich forwarding, panel dedup, native-hide) → direktne izmene u ui/src/....
3. Nezavisna verifikacija (task → IN_REVIEW) — razlikuj tip taska (lesson DynButton 2026-06-03):
   • write task (menja kod/JSON/DB): ciljana skripta (re-audit_component_contract.py/audit_props_quality.py) ili post-op-verify (tsc --noEmit/build) → POSTOP__<task>__<TS>.md.
   • read-only verifikacioni task (npr. provera category/taksonomije): post-op build je N/A; verifikacija = sama analiza izvora. NE generisati prazne PREFLIGHT/POSTOP fajlove — trag se vodi u task fajlu.
4. Ako prolazi → task DONE. Ako ne → REWORK (isti task, attempt++).
   • Retry-guard: posle attempt == 2 neuspeha → HARD KAPIJA #2 (vidi politiku) ili BLOCKED.
5. Lessons: ako je nalaz pattern/anti-pattern koji skill ne pokriva → dopuni COMPONENT-STABILIZATION-LESSONS.md (simptom → uzrok → ispravno) i, ako se ponavlja, predloži doradu skilla (HARD KAPIJA #3).

Korak D — Završetak

• Kada su svi nalazi DONE → FULL-AUDIT i task fajl prelaze u DONE; premesti task fajl iz active/.
• HARD KAPIJA #6 (finalna isporuka): AskUserQuestion sa mišljenjem+predlogom orkestratora — opcije Sledeća komponenta (Preporuka) / Vrati tekuću na korekciju / Other.

🚦 Politika kapija (rizik-tačke)

HARD gate (AskUserQuestion; PRVA opcija = preporuka orkestratora sa (Preporuka), Other = slobodan komentar korisnika):

1. Prvi task komponente.
2. Dorada posle N=2 neuspeha verifikacije / BLOCKED.
3. Kreiranje/izmena skilla.
4. Izmena audit skripte.
5. Cross-repo izmena (DB/registry/docs — needs_user_confirmation).
6. Finalna isporuka komponente.

AUTONOMNO (bez kapije): interni handoff, per-task pre-flight/execute/post-op za „zelene" niskorizične taskove, označavanje DONE posle nezavisne verifikacije, doc update u okviru obima.

🛠️ Alati & Skripte

🔴 Eskalacioni Okidači

• attempt == 2 na istom tasku bez DONE → HARD KAPIJA (#2), ne nastavljaj autonomno.
• Nalaz zahteva cross-repo DB izmenu → predlog + needs_user_confirmation, čekaj potvrdu (#5).
• Otkriven pattern/anti-pattern van skilla → zabeleži u lessons (#3 ako traži izmenu skilla).
• post-op padne (tsc/build) → task ostaje IN_REVIEW, ne označavaj DONE.

📊 Output Format (Cache Fajl)

.agents/cache/active/STANDARDIZE__<Component>__<TIMESTAMP>.md — po TASK-TEMPLATE, uz handoff blok na dnu:

<!-- STATUS: APPROVED -->
# TASK: STANDARDIZE <Component> — <DATUM>
> updated_at: <ISO>

## 📋 Koraci (taskovi)
### [T1] <nalaz F1> — [STATUS: DONE] (attempt 1)
- Akcija / Predlog rešenja / Verifikacija / Nalazi
### [T2] <nalaz F2> — [STATUS: IN_PROGRESS]
...

## 🔗 Handoff
> next_skill: <skill> · next_agent: <main|sub> · instructions: <...>

## ⏭️ Sledeći Korak + Procena
> **Sledeći Korak**: → <task / kapija / isporuka>

⏭️ Sledeći Korak + Procena (OBAVEZNO na kraju output fajla!)

Sledeći Korak: [→ sledeći task / HARD kapija / finalna isporuka] Kompleksnost: L3 🔴 Preporuka Modela: Heavy — Molim korisnika da podesi pre nastavka.

Status: ✅ Active Poslednje ažuriranje: 2026-06-03 12:00