diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index 41d1529..3dea6f6 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -6,6 +6,15 @@ - +## AI / agent + reviewer (quick) + +- [ ] **Scope:** matches `docs/live/03` ACTIVE / stated intent; no unrelated drive-by edits +- [ ] **Contract / API:** if public HTTP, headers, or `errorCode` shape changed, called out in Summary (and `PROJECT_CONTEXT` if needed) +- [ ] **Auth / tenant / secrets:** if touched → set **Risk** to medium or high; no secrets or PII in diff or logs +- [ ] **Live docs:** `docs/live/02` + `03` updated when milestone facts or next steps changed +- [ ] **Tests / E2E:** gates below run as applicable; note if `e2e:seeded` or timing-sensitive UI was exercised +- [ ] **Human review:** required before merge when risk is **medium** or **high** (`docs/GOVERNANCE.md` §4) + ## Quality gates - [ ] Frontend: `npm run lint` diff --git a/docs/DOCUMENTATION_EXCELLENCE.md b/docs/DOCUMENTATION_EXCELLENCE.md index 0434252..8b6b3e8 100644 --- a/docs/DOCUMENTATION_EXCELLENCE.md +++ b/docs/DOCUMENTATION_EXCELLENCE.md @@ -28,7 +28,7 @@ A merge előtt a **reviewer** (vagy önellenőrzés önálló tulajdonosnál) er 4. **AI-generált diff:** a szerződés-, auth- és biztonságérzékeny sorok **emberi értelmezést** kaptak (nem csak „zöld a teszt”). 5. **Titkok:** nincs token, jelszó, PII commit; secret scan / supply-chain jobok figyelése a változás súlyához igazítva. -**Olcsó, de kötelező eszköz:** a [`templates/pr-body.example.md`](templates/pr-body.example.md) kitöltése — összefoglaló + **test plan pontos parancsokkal**. +**Olcsó, de kötelező eszköz:** a [`templates/pr-body.example.md`](templates/pr-body.example.md) kitöltése — összefoglaló + **test plan pontos parancsokkal**. A GitHub webes űrlap ugyanígy indul: [`.github/PULL_REQUEST_TEMPLATE.md`](../.github/PULL_REQUEST_TEMPLATE.md) — benne az **AI / ügynök + reviewer (gyors)** checklist (merge előtti önellenőrzés / review rögzítés). --- diff --git a/docs/live/02_allapot.md b/docs/live/02_allapot.md index 2583c1d..d934302 100644 --- a/docs/live/02_allapot.md +++ b/docs/live/02_allapot.md @@ -6,6 +6,7 @@ Drift-proof observability egy greenfield lowcode platformban. ## Folyamat — AI / Cursor (takarékos mód) - Irányelvek: [`ai-cursor-token-efficiency.md`](ai-cursor-token-efficiency.md), [`docs/DEVELOPMENT_WORKFLOW.md`](../DEVELOPMENT_WORKFLOW.md) §10; `.cursorignore` a repo gyökerében. - **Review + doc-sáv (9–10-es cél):** [`DOCUMENTATION_EXCELLENCE.md`](../DOCUMENTATION_EXCELLENCE.md) (emberi minimum merge előtt; anti-drift); governance: [`GOVERNANCE.md`](../GOVERNANCE.md) §8–9. +- **PR űrlap (GitHub):** [`.github/PULL_REQUEST_TEMPLATE.md`](../../.github/PULL_REQUEST_TEMPLATE.md) — **AI / ügynök + reviewer (gyors)** checklist új PR-nél. - Git: alapértelmezett trunk **`main`** (PR base, `scripts/gh-pr-push-merge.*`, `iter-end`); új branch mindig **`main`**-ről. A remote-on maradhat történeti **`master`** védett szabállyal — új PR-ok **`main`**-re mennek (`gh pr create --base main`). AI szabály: `.cursor/rules/repo-workflow-prs.mdc` (explicit `main`, ne `master` PR base). ## Jelenlegi állapot – kész diff --git a/docs/live/03_kovetkezo_lepesek.md b/docs/live/03_kovetkezo_lepesek.md index 083b1c2..35f621e 100644 --- a/docs/live/03_kovetkezo_lepesek.md +++ b/docs/live/03_kovetkezo_lepesek.md @@ -33,6 +33,7 @@ Részletes indoklás és régebbi iterációk: [`03_ARCHIVE.md`](03_ARCHIVE.md) ## Minichecklist (kontextusvesztés után) - **PR / iteráció ritmus:** [`DEVELOPMENT_WORKFLOW.md`](../DEVELOPMENT_WORKFLOW.md) **§5a** +- **PR sablon:** új PR-nél töltsd ki a GitHub **AI / ügynök + reviewer (gyors)** checklistet — [`.github/PULL_REQUEST_TEMPLATE.md`](../../.github/PULL_REQUEST_TEMPLATE.md) - Branch: `feat/` a legfrissebb `main`-ről - ACTIVE: **E2E MVP** ✅ [`e2e-smoke-plan.md`](e2e-smoke-plan.md) · opcionális bővítés · **minőség 68** (**68a–k**) ✅ [`roadmap-iter-68-quality.md`](roadmap-iter-68-quality.md) · **termék 67 (a–d)** ✅ [`roadmap-iter-67-product.md`](roadmap-iter-67-product.md); **66+** enterprise ✅; integrációs tesztek (fő sor lefedve: admin/*, BFF, …); **65** ✅ (**PR #112–114**); **64** ✅ (**PR #106–110**); **63** ✅ (**PR #102–105**); **E2E smoke MVP** ✅ [`e2e-smoke-plan.md`](e2e-smoke-plan.md); **58c+** touch (**PR #99**); **58c+ CDK** defer — [`workflow-visual-builder.md`](workflow-visual-builder.md); **62c** + **62c+ doksi** (**PR #93**, **PR #95**, **PR #97**); **62b2** mergeelve; **62** / **61** lezárva - `git status` → staged / unstaged diff --git a/docs/live/ai-cursor-token-efficiency.md b/docs/live/ai-cursor-token-efficiency.md index aff051d..1dc78fd 100644 --- a/docs/live/ai-cursor-token-efficiency.md +++ b/docs/live/ai-cursor-token-efficiency.md @@ -19,6 +19,7 @@ A Cursor / „Auto” használat **token-alapon** számolódik. A repó minősé 4. **Composer** több fájlhoz; **Chat** egy szűk edithez (lásd §10). 5. **Iteráció végén** `02` + `03` + `pr-body.md` — kevesebb „mi volt a DoD?” kör a chatben. 6. **Modell** (UI): gyors/Auto a napi kis munkára; erősebb modell csak architektúra / kockázatos domain logikához (részletek §10a). +7. **PR megnyitásakor** töltsd ki a GitHub sablon **AI / ügynök + reviewer (gyors)** részét — [`.github/PULL_REQUEST_TEMPLATE.md`](../../.github/PULL_REQUEST_TEMPLATE.md) (scope, szerződés, auth, live doc, review-kötelezettség). ## Mit nem jelent? diff --git a/docs/templates/pr-body.example.md b/docs/templates/pr-body.example.md index 067b448..8c95eb1 100644 --- a/docs/templates/pr-body.example.md +++ b/docs/templates/pr-body.example.md @@ -13,6 +13,15 @@ - +## AI / ügynök + reviewer (gyors) + +- [ ] **Scope:** egyezik a `docs/live/03` ACTIVE / felhasználói szándékkal; nincs kapcsolódó „drive-by” szerkesztés +- [ ] **Szerződés / API:** ha változott a nyilvános HTTP, header vagy `errorCode` alak → Summary-ben jelezve (`PROJECT_CONTEXT` ha kell) +- [ ] **Auth / tenant / titok:** ha érintett → **Risk** medium vagy high; diffben / logban nincs titok és PII +- [ ] **Live doc:** `docs/live/02` + `03` frissült, ha a milestone tényei vagy a következő lépések változtak +- [ ] **Teszt / E2E:** lenti gate-ek lefutva (ahogy releváns); jelezd, ha `e2e:seeded` vagy időzítés-érzékeny UI volt +- [ ] **Emberi review:** merge előtt kötelező, ha a kockázat **medium** vagy **high** — [`GOVERNANCE.md`](../GOVERNANCE.md) §4 + ## Quality gates - [ ] Frontend: `npm run lint`