GTPX standard (SynarchPro)

GTPX je standard za strojno + ljudski čitljive tekstualne dokumente koji opisuju projekt, audit problema, plan rješenja i sve prateće setove (.gtpx.txt).

Cilj: da totalni laik kroz pregledni UI može proizvesti “top rješenje” za većinu online problema (npr. speed, CRO, WP, devops, bugfix), a da AI agent može pouzdano parsirati i izvršavati.

Naming & verzioniranje

Preporučeni format (referentni):

projectA_v1.0.0_TYPE.gtpx.txt

projectA = slug projekta (bez razmaka, a-z0-9_)
v1.0.0 = semver verzija projekta
TYPE = jedan od allowed tipova (vidi dolje)
.gtpx.txt = ekstenzija (tekstualno, git-friendly)

Allowed GTPX tipovi

Audit problema

obavezno

..._current_problem_audit.gtpx.txt

Plan rješenja

obavezno

..._plan.gtpx.txt

Additional info (upitnik)

..._additional_info.gtpx.txt

Info (DNA projekta)

..._info.gtpx.txt

Set1 (skripte + audit)

..._set1.gtpx.txt

Language HR (i18n)

..._language-hr.gtpx.txt

Testing (audit testiranja)

..._testing.gtpx.txt

README (upute)

..._readme.gtpx.txt

SQL shema

..._sql_shema.gtpx.txt

Install / update / docker

..._install.gtpx.txt

HR audit (tko je radio + vrijeme + što)

..._hr-audit.gtpx.txt

Primjeri (copy-ready)

Ispod su minimalni referentni primjeri. Ovdje definiramo format blokova i obavezna polja. (Kasnije ćemo dodati strožu sintaksu i validatore kroz parser.)

1) current_problem_audit

# GTPX type: current_problem_audit project: projectA version: 1.0.0 language: hr created_at: 2026-02-11 source: freelance_post ## 1) Sažetak - Problem: <1-2 rečenice> - Simptomi: <bullet list> - Impact: <što je kritično> ## 2) Okruženje (zatečeno) - stack: <wp/laravel/node/nginx/etc> - hosting: <provider> - access: <što imamo / što nemamo> ## 3) Repro koraci 1. ... 2. ... ## 4) Strojno čitljiv problem (machine_readable) problem_id: PRB-001 signals: - name: "ttfb_ms" observed: 2100 target: 600 - name: "errors" observed: "500 sporadično" target: "0" ## 5) Pretpostavke + rizici - pretpostavke: ... - rizici: ... ## 6) Potrebni dokazi (dok prikupljamo) - logovi: ... - screenshot: ... - profileri: ...

2) plan

# GTPX type: plan project: projectA version: 1.0.0 language: hr created_at: 2026-02-11 ## 1) Cilj - <što isporučujemo> ## 2) Scope (što ulazi / ne ulazi) in_scope: - ... out_of_scope: - ... ## 3) Faze + taskovi phase: 1 name: "Audit + mjerenja" tasks: - id: T-101 title: "Prikupi logove i baseline metrike" deliverable: "audit update" estimate_h: 2 phase: 2 name: "Implementacija" tasks: - id: T-201 title: "Fix X" deliverable: "PR / deploy" estimate_h: 4 ## 4) Rokovi + dinamika plaćanja milestones: - name: "Phase 1 done" eta_days: 1 payment: "30%" - name: "Final delivery" eta_days: 3 payment: "70%" ## 5) Acceptance criteria - <objektivna provjera>

3) additional_info (upitnik)

# GTPX type: additional_info project: projectA version: 1.0.0 language: hr created_at: 2026-02-11 ## Upute klijentu - Ispuni pitanja ispod. Ako ne znaš odgovor, napiši "ne znam". ## Pitanja (accordion UI) q: - id: Q-01 title: "Koji je hosting i imate li pristup panelu?" hint: "npr. cPanel, Plesk, Cloud panel..." - id: Q-02 title: "Imate li pristup serveru (SSH) i/ili Git repozitoriju?" - id: Q-03 title: "Kada je problem prvi put primijećen (datum + vrijeme)?" - id: Q-04 title: "Koje promjene su rađene zadnjih 7 dana?" - id: Q-05 title: "Koje metrike su vam bitne (TTFB, LCP, konverzije, error rate)?"

4) info (DNA projekta)

# GTPX type: info project: projectA version: 1.0.0 language: hr created_at: 2026-02-11 status: state: "awaiting_client_answers" last_update: 2026-02-11 links: audit: "projectA_v1.0.0_current_problem_audit.gtpx.txt" plan: "projectA_v1.0.0_plan.gtpx.txt" additional_info: "projectA_v1.0.0_additional_info.gtpx.txt" set1: "projectA_v1.0.0_set1.gtpx.txt" language_hr: "projectA_v1.0.0_language-hr.gtpx.txt" testing: "projectA_v1.0.0_testing.gtpx.txt" readme: "projectA_v1.0.0_readme.gtpx.txt" sql_shema: "projectA_v1.0.0_sql_shema.gtpx.txt" install: "projectA_v1.0.0_install.gtpx.txt" hr_audit: "projectA_v1.0.0_hr-audit.gtpx.txt"

5) set1 (skripte + audit nadogradnje)

# GTPX type: set1 project: projectA version: 1.0.0 language: hr created_at: 2026-02-11 ## Promjene - change: "Add caching headers" files: - path: "nginx/site.conf" action: "modify" notes: "Smanjuje TTFB na statiku" ## Script blocks file: "nginx/site.conf" content: <PASTE FILE HERE>

6) language-hr

# GTPX type: language-hr project: projectA version: 1.0.0 created_at: 2026-02-11 strings: app.title: "SynarchPro" flow.enter_code: "Unesite šifru projekta" flow.submit: "Pošalji odgovore" status.awaiting: "Čeka se odgovor klijenta"

7) testing

# GTPX type: testing project: projectA version: 1.0.0 language: hr created_at: 2026-02-11 tests: - id: "TTFB" method: "curl -w" result: "ok" - id: "Smoke" method: "open / run basic flows" result: "ok" notes: - "Dodati Lighthouse CI kasnije"

8) readme

# GTPX type: readme project: projectA version: 1.0.0 language: hr created_at: 2026-02-11 ## Kako koristiti 1. Otvori project flow link i unesi šifru 2. Ispuni upitnik 3. Pregledaj plan i prihvati ponudu ## Kontakt - support: ...

9) sql_shema

# GTPX type: sql_shema project: projectA version: 1.0.0 created_at: 2026-02-11 -- migrations / schema changes ALTER TABLE projects ADD COLUMN status VARCHAR(64) NOT NULL DEFAULT 'new';

10) install

# GTPX type: install project: projectA version: 1.0.0 created_at: 2026-02-11 ## Standalone packaging - target: "docker" - compose: "docker-compose.yml" - env: ".env.example" ## Update protokol 1) backup 2) migrate 3) deploy 4) smoke test

11) hr-audit

# GTPX type: hr-audit project: projectA version: 1.0.0 created_at: 2026-02-11 contributors: - name: "Freelancer A" role: "Implementer" hours: 6 notes: "Fix + deploy" - name: "Synarch Agent" role: "Planner/Reviewer" hours: 0.5 notes: "Audit + plan generation"

SynarchPro project flow

Klijent dobije mail s jedinstvenom šifrom (npr. 123456) i linkom na /SynarchPro/project_flow. Tamo ispunjava accordion upitnik. Nakon odgovora se generiraju set datoteke i “real-time” status.

Minimalna logika (koncept)

1) Parse freelance post → /projects/projectA_v1.0.0_current_problem_audit.gtpx.txt 2) Agent kreira plan → /projects/projectA_v1.0.0_plan.gtpx.txt 3) UI editor generira upitnik → /projects/projectA_v1.0.0_additional_info.gtpx.txt 4) Klijent odgovori → kreira se /info + /set1 + ostali setovi 5) Nakon odobrenja freelancera → klijent vidi: opis, faze, cijenu, dinamiku, real-time logove

UI “desktop” koncept

Left: projects + file sets
Center: editor + preview (gtpx blocks)
Right: validator + TOC + status

Sljedeći korak u razvoju je parser/validator koji provjerava allowed tipove i required polja, i “reader” endpoint da ChatGPT može čitati projekte iz dev.avhcode.com/SynarchPro/projects.