Kihagyás

BMAD context-preload pattern (Sprint B)#

[!success] ÉLES 2026-05-19-tól Minden BMAD-skill (PRD / Architecture / project-context / dev-story / stb.) első lépésként betölti a MyForge Vault 11.11 state-jét a bmad-vault-bridge CLI-n keresztül. PRD/Arch generálás 3-5× gyorsabb, cross-projekt tanulás automatikus.

TL;DR#

A BMAD-agent NEM vakon nyitja a workflow-t — ELŐSZÖR megkérdezi/detektálja a projekt-slug-ot, lefuttatja a bmad-vault-bridge --context <slug> --top-k 10 --json parancsot, és a kapott JSON-t (project-md + KO-DB top-K + Memgraph chunks + recent sessions + meglévő BMAD-artifactok) bevezeti az agent working-context-jébe mielőtt step-01 (discover) elkezdődne.

Eredmény: a discovery-summary már tudja mit használ a projekt (stack, domain-ek, döntések), és NEM kérdezi újra a project-md-ben lévő dolgokat.

A háttér (Sprint A)#

bmad-vault-bridge (2026-05-18 ÉLES) egy CLI Python-script (/usr/local/bin/bmad-vault-bridge) ami 3 módban dolgozik:

Mode Flag Funkció
Ingest --ingest <file> BMAD-markdown → KO-DB triplet + Memgraph chunk
Watch --watch <dir> Folyamatos figyelés új BMAD-artifactokra
Context --context <slug> --top-k N --json Pre-load output JSON

Sprint A a bridge-et megírta. Sprint B a BMAD-skill-eket meghívja vele.

Workflow diagram#

User: "Generate project-context for boulium"
  ↓
BMAD-skill (bmad-generate-project-context)
  ↓
step-00-vault-preload.md  ← ÚJ (Sprint B)
  ├─ Detect slug: boulium (CLI arg / .active-session / ask)
  ├─ Run: bmad-vault-bridge --context boulium --top-k 10 --json
  └─ Inject output into agent working context
       ↓
       JSON keys:
       ├─ project_file: /root/obsidian-vault/02-Projects/boulium.md
       ├─ project_snippet: ~2KB frontmatter+intro
       ├─ ko_top_k: 10 subjects, 24 facts (cross-source ranked)
       ├─ semantic_top_k: 22 bge-m3 chunks (Memgraph cosine)
       ├─ recent_sessions: last 5 sessions
       └─ bmad_artifacts: existing PRD/Arch/etc.
  ↓
step-01-discover.md  ← már RICH baseline-nal indul
  ├─ Skip questions answered by project_snippet
  ├─ Surface vault-preload-source facts transparently
  └─ Add frontmatter `vault_preload.ran: true`
  ↓
step-02-generate.md
step-03-complete.md

Frontmatter-konvenció#

Generált BMAD-artifact (PRD / Arch / project-context / stb.) frontmatter-be KÖTELEZŐ tag:

---
vault_preload:
  ran: true              # vagy false ha step-00 skip-elt
  slug: boulium
  ko_facts: 24
  chunks: 22
  sessions: 5
  bridge_version: 1
  timestamp: 2026-05-19T10:00:00Z
---

Ez lehetővé teszi:

  • Downstream-skill (pl. dev-story) detektálja hogy a PRD már vault-preloaddal készült → NEM kell újra futtatni a bridge-et.
  • Audit-script (vault-bmad-coverage) szűrni tudja a preload-elt vs. preload-nélküli artifactokat.
  • Future-proof: bridge_version field jelzi a séma-változásokat.

Pre/post benchmark (mock-PRD generation)#

A becslés egy "boulium Friends-MVP v2" PRD-re (közepes komplexitás):

Fázis NO preload WITH preload Delta
Discovery questions 12-15 kérdés 3-5 kérdés -8 to -12
Stack identification manual file-scan (4-6 tool-call) KO-DB ko_top_k (0 tool-call) -4 to -6
Recent-decisions context 0 (agent vak) recent_sessions 5 db +5 context
Existing-PRD detection manual ls bmad_artifacts pre-listed -1 tool-call
Total agent-time ~12-18 perc ~3-5 perc ~3-5× gyorsulás
Cross-project learning ❌ izolált ✅ KO-DB cross-rank unlock

[!info] Benchmark mérése Ez mock-becslés a Sprint A bridge-output-méret + tipikus discovery-conversation-mintázat alapján. Valódi A/B mérés (5-5 PRD) Sprint B+1 (2026-05-26+) follow-up.

Smoke-test (2026-05-19)#

3 projekt verifikálva (mind PASS):

Projekt project_file ko_top_k semantic recent_sessions bmad_artifacts
boulium ✅ 02-Projects/boulium.md ✅ 10 ✅ 22 ✅ 4 ✅ 1
kgc-berles ✅ 02-Projects/kgc-berles.md ✅ 10 0 0 0
mapesz ✅ 02-Projects/mapesz.md ✅ 10 0 ✅ 1 0

Megjegyzés: a boulium a leggazdagabb (24 KO-DB fact + 22 chunks + 4 sessions) mert ott készült már embed-backfill. A többi projekt KO-DB-szegény state-ben is működik (10 top-K + project-md alap).

Kapcsolódó#

Implementáció#