pre-flight - SKILL.md Agent Skill

name: pre-flight description: Obavezna analiza zahteva i planiranje pre izmene koda version: 1.0 complexity: L2 category: audit depends_on: - none used_by: - execute - micro-fix

Skill: Pre-Flight Analysis & Planning

🛡️ Mandatory Compliance (Workflow Gates)

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

DOKUMENTACIJA JE ZAKON: Pročitaj .agents/rules/rules.md i docs/README.md.

/pre-flight: Mora se pokrenuti PRE bilo kakve akcije (Analiza + DTP provera).

/post-op: Mora se pokrenuti POSLE pisanja koda (Build + Compliance Audit).

🎯 Cilj

Pre-flight skill obavlja inicijalni pregled i analizu zahteva. Vrši Visual Triage (da li je problem layout ili token), proverava dokumentaciju (.docs.md, anti-patterns.md), i mapira "Blast radius" (šta će sve biti zahvaćeno ako se ovo menja). Rezultat se kešira i koristi kao ulaz za naredne skilove.

📥 Ulaz (Input)

Obavezan: Opis problema ili zahteva (tekst, link, screenshot referenca)
Obavezan: Komponenta ili domen koji je zahvaćen (npr. FormStudio, DynUI, RAG)
Opcionalan: Specifični fajl ili direktorijum koji trebalo bi pregledati
Opcionalan: Informacija o prethodnom stanju/verziji

📤 Izlaz (Output)

Cache fajl: .agents/cache/PREFLIGHT__<TARGET>__<TIMESTAMP>.md
(Prefiks za ovaj skill: PREFLIGHT)
Format: Strukturirani Markdown sa sekcijama za analizu, pronađene probleme, i preporuke
Lokacija alternativna: Direktni izveštaj u odgovoru sa  tagovima

📋 Koraci

Korak 1 — Kontekst i Dokumentacija

Pročitaj relevantnu domenu iz docs/domains/ (D1-D8)
Pročitaj .agents/rules/rules.md za obavezna pravila
Pronađi postojeće analize u .agents/cache/ sa istom lemom (npr. *__FormStudio__*)

Korak 2 — Visual Triage

Odredi je li problem: Layout, Token, Typing, Build ili Docs
Ako je Layout → proverite .module.css, Grid strukture, responsive pravila
Ako je Token → proverite token JSON izvor i token compliance bazu
Ako je Typing → proverite .types.ts i JSDoc anotacije
Ako je Build → pokreni npm run build ili pytest prema kontekstu

Korak 3 — Blast Radius Mapiranje

Pronađi sve fajlove koji koriste zahvaćenu komponentu/modul
Lista koliko fajlova bi bilo zahvaćeno (ako >3 fajla → M1 eskalacija)
Pronađi sve testove koji pokrivaju zahvaćenu oblast

Korak 4 — Pronalaženje Dokumentacije

Pronađi .docs.md za komponentu (ako postoji)
Pronađi anti-patterns.md koji se tiče problema
Pronađi primer iz .stories.tsx ili .json_examples/

Korak 5 — Sažetak i Preporuka

Sažmi trenutno stanje (šta radi, šta ne radi)
Preporuči sledeći korak (PLAN, INSPECT, EXECUTE ili eskalacija)
Proceni kompleksnost (L1 ⚡, L2 🔶 ili L3 🔴)
Sačuvaj cache fajl prema formatu

🛠️ Alati & Skripte

Skripta	Namena	Pozivanje
`scripts/check_doc_anchors.py`	Doc↔kod sidra (PATH/SYMBOL) — provera pre izmene	`python scripts/check_doc_anchors.py <doc.md>`
`<dynui-root>/scripts/audits/golden-standard-audit.js`	Token compliance (CROSS-REPO, DynUI repo)	`node golden-standard-audit.js` (u DynUI repou)
`<dynui-root>/scripts/audits/audit-tsx-live-tokens.js`	CSS varijable u React propovima (CROSS-REPO)	`node audit-tsx-live-tokens.js` (u DynUI repou)
`<dynui-root>/scripts/audits/db-token-inspect.ts`	Prisma baza token provera (CROSS-REPO)	`npx tsx db-token-inspect.ts` (u DynUI repou)
`npm run build`	Build verification	`npm run build` (za UI) ili `pytest` (za API)

🔴 Eskalacioni Okidači

Više od 3 fajla zahvaćeno → Pre PLAN faze, zatraži eksplicitan korisnikov reviewed
Blast radius = ceo projekat → L3 model obavezan, eskalacija korisniku
Nedostaje dokumentacija (nema .docs.md) → INSPECT skill obavezan pre PLAN
Build je već slomljen → Eskalacija na REPAIR skill pre nego što počneš nove izmene

📊 Output Format (Cache Fajl)

.agents/cache/PREFLIGHT__<TARGET>__<TIMESTAMP>.md

# Pre-Flight Analysis: <TARGET> — <DATUM>

## 📋 Sažetak
<Kratka procena: šta je pronađeno, koliko je kritično>

## 🎯 Problem Klasifikacija
- **Tip**: [Layout / Token / Typing / Build / Docs]
- **Obuhvat**: [Lokalni / Regionalni / Globalni]
- **Prioritet**: [⚡ Low / 🔶 Medium / 🔴 Critical]

## 📊 Blast Radius
- Fajlovi zahvaćeni: <broj>
- Lista fajlova:
  - `file1.tsx`
  - `file2.css`
  - ...

## 📚 Pronađena Dokumentacija
- `.docs.md`: <URL ili "Nedostaje">
- `anti-patterns.md`: <pronađeni relevantni delovi>
- Primeri: <referenca na `.stories.tsx` ili `.json_examples/`>

## 🔍 Pronađeni Problemi
1. <Problem 1>
2. <Problem 2>
...

## ✅ Preporuke
- <Preporuka 1>
- <Preporuka 2>

<!-- DONE -->

## ⏭️ Sledeći Korak + Procena
> **Sledeći Korak**: → [PLAN / INSPECT / EXECUTE]
> **Kompleksnost**: [L1 ⚡ / L2 🔶 / L3 🔴]
> **Preporuka Modela**: [Fast / Mid / Heavy]

Status: ✅ Active
Poslednje ažuriranje: 2026-05-22