Getting started

Introduction

GTPX je standard za pisanje projekata tako da budu jasni ljudima i precizni AI-u. Cilj je da se više ništa ne “izgubi u prijevodu”: problem, plan, struktura, kod i audit su zapisani na jednom mjestu.

Za laika

Ti zalijepiš problem → sustav postavi pitanja → dobiješ plan i ponudu.

Za tim

Jedan izvor istine: svi rade po istom dokumentu i verziji.

Za AI

Deterministička struktura: AI zna gdje tražiti i što smije mijenjati.

Quick start (3 minute)

Ovo je minimalni “mentalni model”: GTPX je “paket istine” o projektu. Ne piše se radi forme, nego radi kontrole, brzine i reproducibilnosti.

GTPX structure

Tipični projekt koristi više GTPX dokumenata (info, plan, audit, schema, setovi koda…). Svaki dokument ima stabilne sekcije (META/LOGIC/VERSIONING/CODE/AI CONTEXT).

Naming & versioning

Ime datoteke nosi kontekst i verziju, npr.: projectA_v1.0.0_plan.gptx.txt

RULES

Granice i dogovori (što je zaključano, što je dopušteno, način rada).

PLAN

Faze, taskovi, acceptance kriteriji, dependencies, rizici.

SCHEMA

SQL/JSON schema i ugovori (contract-first).

CODE blocks

Kod se zapisuje u blokovima s type, path, role, content.

Minimalni primjer (GTPX blok)

{
  "type": "md",
  "path": "/docs/01_introduction.md",
  "role": "docs",
  "content": "# Introduction\nGTPX je standard..."
}

EVENT types

Standardizirani događaji (npr. PREFLIGHT_RUN, PLAN_APPROVED, BUILD_DONE…).

Example: Upwork — Hero redesign

Input

Korisnik zalijepi Upwork opis zadatka (tekst).

Output

Sustav generira upitnik, parametre, plan, rok, cijenu i ugovor.

Example: WordPress speed regression

Audit problema → plan optimizacije → testiranje → release notes.

UI flow for layman

Zalijepi problem
Odgovori na pitanja
Dobiješ plan + ponudu + ugovor
Praćenje izvedbe kroz audit i evente

Export & packaging

Export opcije (kasnije): ZIP, GPTX bundle, URL share, installer protokol.