# AUDIT REPORT — Documentation & Code Alignment (Vilmax Cockpit)

**Data audytu:** 2026-08-27
**Audytor:** Devin (read-only audit)
**Zakres:** `C:\xampp\htdocs\vilmax\` (root) + `C:\xampp\htdocs\vilmax\vilmax-cockpit\` (repo + docs)
**Weryfikacja kodu:** `npm test` → **509/509 pass, 0 fail** (uruchomione na żywo, 2026-08-27)
**Reguła:** READ-ONLY. Żaden plik nie został zmodyfikowany, przeniesiony ani usunięty.

---

## 0. KLUCZOWE ODKRYCIA (TL;DR)

1. **Root `vilmax/` NIE jest repozytorium git.** Nie ma `.git`. Wszystkie pliki w root są luźnymi plikami roboczymi poza faktycznym repo `vilmax-cockpit/` (które ma `.git`, branch `main`).
2. **Trzy pliki w root są STARYMI DUPLIKATAMI** kanonicznych wersji w `vilmax-cockpit/`: `AGENTS.md`, `ARCHITECTURE_SPEC.md`, `MVP_PLAN.md`. Różnica = TYLKO prefiksy ścieżek (`_audit/` vs `../_audit/`, `ARCHITECTURE_SPEC.md` vs `docs/ARCHITECTURE_SPEC.md`). Commit `ad5a8c9` ("Docs: przeniesienie AGENTS.md + ARCHITECTURE_SPEC.md + MVP_PLAN.md do repo") przeniósł je do repo — root to pozostałości.
3. **Dokumentacja twierdzi, że `vilmaxFR.js` istnieje jako fallback** (AGENTS.md §14.5, PROGRESS.md §4, MIGRATION doc §1.2). **FAŁSZ** — `vilmaxFR.js` NIE istnieje w `src/`, `src/adapters/index.js` rejestruje tylko `bobochicFR`. Realny doc/code mismatch.
4. **`MANUAL-TESTING.md` (referowany w `FIRST_SESSION.md`) nie istnieje.** Stare odniesienie.
5. **Liczne pliki dump/scratchpad w root** (`.bobochic-*.html/.xml/.txt/.cjs`, `.draft-structure.txt`, `.npm-test-*.txt`, `.olx-title-out.txt`, `.smoke-out.txt`, `.test-out.txt`, `package-lock.json`) — artefakty jednorazowe z budowy adaptera Bobochic (26.08), poza repo, bezpieczne do usunięcia.
6. **Liczniki testów w docs są niespójne** (historycznie): README=509 (aktualne ✓), RUNCOMFY_SETUP=487, PROMPT-NOWA-SESJA=487, HANDOFF-B3=359, AUDIT-migration=274. To oczekiwane — to zrzuty stanów historycznych; tylko README i PROGRESS są żywe.

---

## 1. INVENTORY TABLE

### 1A. Root `C:\xampp\htdocs\vilmax\` (poza repo git)

| File Path | Location | Co zawiera (1-2 zdania) | Status vs Codebase | Recommended Action |
|---|---|---|---|---|
| `AGENTS.md` | Root | Reguły projektowe v2.0 (stack, zakazy, Repo-First, Approval Gate). | **Outdated duplicate** — identyczne treścią z `vilmax-cockpit/AGENTS.md`, różni się tylko prefiksami ścieżek (`_audit/` zamiast `../_audit/`, brak `docs/` przed nazwami plików). | **Delete** (kanon w repo) |
| `ARCHITECTURE_SPEC.md` | Root | Technical Design Document v2.0 (604 linie, Node.js, zero DB). | **Outdated duplicate** — identyczne z `vilmax-cockpit/docs/ARCHITECTURE_SPEC.md` poza prefiksami ścieżek. | **Delete** (kanon w repo) |
| `MVP_PLAN.md` | Root | Plan wdrożenia MVP v2.0 (420 linii, 8 modułów, fazy). | **Outdated duplicate** — identyczne z `vilmax-cockpit/docs/MVP_PLAN.md` poza prefiksami ścieżek. | **Delete** (kanon w repo) |
| `vixplan.md` | Root | Strategiczna wizja systemu (PHP/MariaDB/Redis, 12 modułów, model biznesowy D2C, seeding konta, harmonogram faz). Sam deklaruje bycie superseded przez MVP_PLAN/ARCHITECTURE_SPEC/AGENTS. | **Historical vision** — unikalna treść (model biznesowy, strategia seedingowa, fazy przychodów) NIEobecna w repo. Stack PHP/MariaDB/Redis jest przestarzały (obecnie Node.js/dysk). | **Keep as historical reference** (lub archive do `_docs/`) |
| `FIRST_SESSION.md` | Root | Przewodnik po pierwszej sesji (Faza 0 + Faza 1). Status: Faza 0+1 zakończone, referuje commity, `vilmaxFR.js` stub. | **Outdated** — referuje `vilmaxFR.js` (usunięty), `docs/MANUAL-TESTING.md` (nie istnieje), stare commity. Faza 0+1 od dawna zakończona i udokumentowana w PROGRESS.md. | **Archive** (historyczny zrzut sesji) |
| `NEW_SESSION_PROMPT.md` | Root | Prompt do nowej sesji (moduły 3-8). Referuje `vilmaxFR.js` stub, ścieżki root. | **Superseded** — zastąpiony przez `vilmax-cockpit/docs/PROMPT-NOWA-SESJA.md` (nowszy, Etap 2 frontend, poprawne ścieżki). | **Archive/Delete** (superseded) |
| `vixhub_repo_first_audit_report.md` | Root | Audyt Repo-First konta GitHub DamianMalenta (10 repo). Mapa reużywalnych komponentów (slicehub_pro, dywanowy-bazar, kebabkiller). 46 KB. | **Unique reference** — matryca reużycia dla Repo-First Policy. Wartościowe dla Etapu 2 (wzorce outbox, webhook, CredentialVault). | **Keep** (referencja Repo-First) lub archive do `_docs/` |
| `vixhub_omnichannel_re_audit_report.md` | Root | Dodatkowy audyt silosu omnichannel/e-commerce w slicehub_pro (cart, checkout, gateway, webhooks, PWA storefront). 39 KB. | **Unique reference** — gotowy szkielet sklepu D2C do adaptacji w Etapie 2 (WooCommerce). | **Keep** (referencja Etap 2) lub archive do `_docs/` |
| `package-lock.json` | Root | Pusty stub lockfile (`"packages": {}`, name "vilmax"). 85 B. | **Misleading** — prawdziwy lockfile jest w `vilmax-cockpit/package-lock.json` (164 KB). Root nie ma `package.json`. | **Delete** |
| `.bobochic-canapes.html` | Root | Scraped HTML listingu kanap bobochicparis.com (535 KB). | **Scratchpad** — użyte do budowy `bobochicFR.js` (produkcja). | **Delete** |
| `.bobochic-product.html` | Root | Scraped HTML PDP FUJI (942 KB). | **Scratchpad** — fixture testowy już w `test/fixtures/bobochic/fuji-angle-convertible.html`. | **Delete** |
| `.bobochic-sitemap.xml` | Root | Scraped sitemap bobochicparis.com (358 KB). | **Scratchpad** — jednorazowy. | **Delete** |
| `.bobochic-features.txt` | Root | Wyjście `.bobochic-parse.cjs` (56 cech FUJI, 56 linii). | **Scratchpad** — ekstrakcja już w adapterze + testach. | **Delete** |
| `.bobochic-parse.cjs` | Root | Jednorazowy skrypt CJS parsujący HTML Bobochic (43 linie). | **Scratchpad** — CJS (nie ESM), narusza konwencje projektu. | **Delete** |
| `.draft-structure.txt` | Root | Zrzut JSON struktury draftu (96 KB). | **Scratchpad** — jednorazowy inspekcji. | **Delete** |
| `.npm-test-baseline.txt` | Root | Stary zrzut `npm test` (575 linii, 26.08 00:23). | **Scratchpad** — przed migracją, nieaktualny. | **Delete** |
| `.npm-test-spec.txt` | Root | Stary zrzut `npm test` (571 linii, 26.08 00:24). Near-duplikat baseline (584 różnice = głównie timestampy). | **Scratchpad** — near-duplikat baseline. | **Delete** |
| `.olx-title-out.txt` | Root | Stary zrzut testów olx-title (13 pass/3 fail, legacy tara era, 26.08 00:35). | **Scratchpad** — z epoki tara (usunięte), 3 faile to pre-existing legacy. | **Delete** |
| `.smoke-out.txt` | Root | Stary zrzut smoke (ECONNREFUSED — serwer nie był uruchomiony, 26.08 00:51). | **Scratchpad** — bezużyteczny (błąd połączenia). | **Delete** |
| `.test-out.txt` | Root | Stary zrzut `npm test` (25 KB, 26.08 00:56). | **Scratchpad** — nieaktualny. | **Delete** |

### 1B. `vilmax-cockpit/` root (w repo git)

| File Path | Location | Co zawiera | Status vs Codebase | Recommended Action |
|---|---|---|---|---|
| `AGENTS.md` | Cockpit root | Kanoniczne reguły projektowe v2.0. | **Current** — źródło prawdy. Referuje `vilmaxFR.js` jako "wzorzec referencyjny" (§14.5) — **niezgodne z kodem** (vilmaxFR.js usunięty). | **Keep** (poprawić wzmianki vilmaxFR) |
| `README.md` | Cockpit root | Project README, szybki start, komendy. Mówi 509 testów. | **Current** — 509/509 pass potwierdzone. | **Keep** |
| `HANDOFF-B2.md` | Cockpit root | Handoff B2 (Moduł 5 Social). Snapshot: 219/219 pass, kontekst 118/118. | **Historical snapshot** — z momentu B2 (przed B3 i Etapem 2). Liczniki nieaktualne. | **Archive** (do `docs/archive/`) |
| `HANDOFF-B3.md` | Cockpit root | Handoff B3 (Moduł 8 Saturn, MVP complete). Snapshot: 359/359 pass. | **Historical snapshot** — z momentu B3 (przed Etapem 2). Licznik 359 nieaktualny (obecnie 509). | **Archive** (do `docs/archive/`) |
| `render.yaml` | Cockpit root | Render.com deploy config. | **Current** — `name: vilmax-cockpit` (poprawione w commicie `eee9dee`; uwaga w AUDIT-migration o legacy nazwie "dywanowy-bazar" jest przestarzała). | **Keep** |
| `server.js`, `package.json`, `index.html`, `vite.config.js`, `vitest.config.js`, `.env.example`, `.dockerignore`, `.gitignore` | Cockpit root | Kod produkcyjny / config. | **Current** — część działającego repo. | **Keep** |

### 1C. `vilmax-cockpit/docs/` (w repo git)

| File Path | Location | Co zawiera | Status vs Codebase | Recommended Action |
|---|---|---|---|---|
| `ARCHITECTURE_SPEC.md` | docs/ | Kanoniczny TDD v2.0 (604 linie). | **Current** — źródło prawdy. | **Keep** |
| `MVP_PLAN.md` | docs/ | Kanoniczny plan MVP v2.0 (420 linii). | **Current** — źródło prawdy. | **Keep** |
| `PROGRESS.md` | docs/ | Żywy log postępu (90 KB, najnowszy 27.08 13:58). | **Current** — najnowszy. Referuje `vilmaxFR.js` jako fallback (§4, §4.2) — **niezgodne z kodem**. | **Keep** (poprawić wzmianki vilmaxFR) |
| `ROADMAP.md` | docs/ | Dwufazowe wdrożenie (Faza 1 cashflow, Faza 2 D2C). 27.08. | **Current**. | **Keep** |
| `BENCHMARK_BOBOCHIC.md` | docs/ | Analiza feature-by-feature vs Bobochic. 27.08. | **Current**. | **Keep** |
| `PROMPT-NOWA-SESJA.md` | docs/ | Prompt nowej sesji (Etap 2 frontend). Mówi 487 testów. | **Current treść**, **stary licznik** (487 vs 509). | **Keep** (odświeżyć licznik) |
| `RUNCOMFY_SETUP.md` | docs/ | Instrukcja deployment RunComfy. Mówi 487 testów. | **Current treść**, **stary licznik** (487 vs 509). | **Keep** (odświeżyć licznik) |
| `MIGRATION-CARPET-TO-FURNITURE.md` | docs/ | Log migracji dywan→meble (Fazy 1-4). | **Historical** — dokumentuje archiwizację plików tara. §1.2 mówi "zostaje bobochicFR + vilmaxFR" — **niezgodne z kodem** (vilmaxFR usunięty). | **Keep as historical** (poprawić wzmiankę vilmaxFR) |
| `AUDIT-furniture-migration-2026-08-26.md` | docs/ | Audyt migracji (274/274 pass). Notuje render.yaml name "dywanowy-bazar" (legacy). | **Historical snapshot** — 274 pass nieaktualne; uwaga o render.yaml przestarzała (już naprawione). | **Keep as historical** |
| `proposal/EXECUTIVE_SUMMARY.md` | docs/proposal | Executive summary dla zarządu. 27.08. | **Current**. | **Keep** |
| `proposal/PRESENTATION_DECK.md` | docs/proposal | Prezentacja Marp dla zarządu. 27.08. | **Current**. | **Keep** |
| `proposal/index.html` | docs/proposal | HTML wersja prezentacji. 27.08. | **Current**. | **Keep** |

---

## 2. DEEP DIFFS OF KEY DOCS

### 2.1 Root `AGENTS.md` vs `vilmax-cockpit/AGENTS.md`

- **Linie:** 230 vs 230 (identyczna długość)
- **Różnice treści:** ZERO różnic merytorycznych. Jedynie prefiksy ścieżek:
  - Root: `_audit/dywanowy-bazar/`, `ARCHITECTURE_SPEC.md`, `MVP_PLAN.md`
  - Cockpit: `../_audit/dywanowy-bazar/`, `docs/ARCHITECTURE_SPEC.md`, `docs/MVP_PLAN.md`
- **Wniosek:** Root to kopia zanim przeniesiono docs do repo (commit `ad5a8c9`). Prefiksy w root są **niepoprawne** względem obecnej struktury (root nie ma `_audit/` jako subdir — `_audit/` jest w root `vilmax/`, ale `AGENTS.md` w root referuje go jako `_audit/` co jest poprawne DLA root, lecz kanon jest w repo). Wersja cockpit jest kanoniczna (poprawne ścieżki względne z `vilmax-cockpit/`).

### 2.2 Root `ARCHITECTURE_SPEC.md` vs `vilmax-cockpit/docs/ARCHITECTURE_SPEC.md`

- **Linie:** 604 vs 604
- **Różnice:** 2 linie różniące się — wyłącznie prefiksy `../_audit/` vs `_audit/` w sekcji Repo-First i Definition of Done.
- **Wniosek:** Identyczny jak wyżej — root to stara kopia.

### 2.3 Root `MVP_PLAN.md` vs `vilmax-cockpit/docs/MVP_PLAN.md`

- **Linie:** 420 vs 420
- **Różnice:** 1 linia — prefiks `../_audit/` vs `_audit/` w Kroku 0.1.
- **Wniosek:** Identyczny — root to stara kopia.

### 2.4 Root `vixplan.md` — unikalna treść nieobecna w repo

`vixplan.md` zawiera treść NIEobecną nigdzie w `vilmax-cockpit/docs/`:
- **Model biznesowy D2C** (omijanie pośredników, 30-50% marży w fabryce, Make-to-Order).
- **Strategia seedingowa konta Allegro** (1 na 10 klientów wystawia opinię; próbniki/pufy jako produkty wejściowe na Allegro Smart; pierwsze 10-15 opinii 5.0).
- **Harmonogram faz przychodów** (Faza 0 Rozruch ~10-22k zł → Faza 3 Ugruntowana 240-500k+ zł/mies.).
- **Stack PHP 8.2/MariaDB/Redis** — PRZESTARZAŁY (obecnie Node.js/dysk wg ARCHITECTURE_SPEC v2.0). Sam dokument deklaruje superseding.
- **12 modułów wizji** (vs 8 modułów MVP) — w tym moduł 8 (sklep D2C WooCommerce/PayPo/Ratami) i moduł 12 (Master Configurator), które są Etap 2/3.

**Wartość:** Historyczna wizja strategiczna + model biznesowy/seeding NIEobecne w ROADMAP.md (która skupia się na fazach technicznych, nie na seeding opinii). Rekomendacja: zachować jako referencję historyczną.

### 2.5 Root `vixhub_repo_first_audit_report.md` + `vixhub_omnichannel_re_audit_report.md` — unikalne referencje Repo-First

Te dwa raporty (łącznie 85 KB) zawierają **matrycę reużycia komponentów** z audytu konta GitHub DamianMalenta:
- `slicehub_pro/core/`: `OrderEventPublisher`, `WebhookDispatcher`, `CredentialVault`, `PromisedTimeEngine`, `AssetResolver`, `SceneResolver`, `AsciiKeyEngine`, `Money`, `Uuid`.
- `dywanowy-bazar/src/`: `baselinker.js`, `badgeRenderer.js`, `badgePlanner.js`.
- `kebabkiller/backend/src/video/`: `montageEngine`, `frameExtractor`, `compositeStartFrame`.
- `slicehub_pro/api/online/`, `api/cart/`, `api/gateway/`: kompletny silnik e-commerce (cart, checkout, gateway, idempotency, rate-limit, PWA storefront, Leaflet order tracker).

**Wartość:** Bezpośrednio wspiera Repo-First Policy (AGENTS.md §3). Wzorce outbox/webhook już zaadaptowane w Module 8 (Saturn). Silnik e-commerce jest referencją dla Etapu 2 (WooCommerce). **Nigdzie indziej w repo nie ma tej matrycy.** Rekomendacja: zachować (lub przenieść do `_docs/` / `docs/repo-first-audit/`).

### 2.6 `FIRST_SESSION.md` (root) vs `PROMPT-NOWA-SESJA.md` (docs/)

- `FIRST_SESSION.md` (root, 27 KB): przewodnik Fazy 0+1. Status z 25.08. Referuje `vilmaxFR.js` stub, `docs/MANUAL-TESTING.md` (nie istnieje), commity Fazy 0.
- `PROMPT-NOWA-SESJA.md` (docs/, 8.6 KB): prompt Etapu 2 frontend. Status z 27.08. Poprawne ścieżki, aktualne moduły.
- **Wniosek:** `FIRST_SESSION.md` jest całkowicie superseded przez PROGRESS.md + PROMPT-NOWA-SESJA.md. Referuje nieistniejące pliki.

---

## 3. DOC/CODE MISMATCHES (do poprawy w kanonicznych docs)

| Mismatch | Gdzie w docs | Stan kodu | Rekomendacja |
|---|---|---|---|
| `vilmaxFR.js` "pozostaje jako wzorzec referencyjny/fallback" | `AGENTS.md` §14.5 (linie 172, 174, 180, 206), `PROGRESS.md` §4 (linie 41, 66), `MIGRATION-CARPET-TO-FURNITURE.md` §1.2 (linia 30) | `vilmaxFR.js` **NIE ISTNIEJE** w `src/`. `src/adapters/index.js` rejestruje tylko `bobochicFR`. | Poprawić docs: usunąć wzmianki o vilmaxFR jako aktywnym fallbacku, oznaczyć jako "usunięty w Fazie 3 migracji". |
| `docs/MANUAL-TESTING.md` referowany | `FIRST_SESSION.md` (linie 19, 37) | Plik **nie istnieje**. | Usunąć odniesienia (FIRST_SESSION do archiwizacji). |
| Licznik testów 487 | `RUNCOMFY_SETUP.md` (linia 6), `PROMPT-NOWA-SESJA.md` (linia 36) | Obecnie **509/509**. | Odświeżyć licznik. |
| Licznik 359/274/219/118 | `HANDOFF-B3.md`, `AUDIT-furniture-migration`, `HANDOFF-B2.md` | Historyczne snapshoty. | Oczekiwane — oznaczyć jako snapshoty (lub archive). |
| render.yaml name "dywanowy-bazar" (legacy) | `AUDIT-furniture-migration-2026-08-26.md` §1 | `render.yaml` ma `name: vilmax-cockpit` (naprawione w `eee9dee`). | Uwaga w audyt jest przestarzała — dodać sprostowanie. |

---

## 4. PROPOSED CLEANUP PLAN (do potwierdzenia przez człowieka)

> **ŻADNA akcja nie została wykonana.** Poniżej to propozycja. Każdy krok wymaga zatwierdzenia.

### Krok 1 — Usunięcie starych duplikatów docs z root (bezpieczne)

Usunąć z `C:\xampp\htdocs\vilmax\`:
- `AGENTS.md` (duplikat `vilmax-cockpit/AGENTS.md`)
- `ARCHITECTURE_SPEC.md` (duplikat `vilmax-cockpit/docs/ARCHITECTURE_SPEC.md`)
- `MVP_PLAN.md` (duplikat `vilmax-cockpit/docs/MVP_PLAN.md`)
- `package-lock.json` (pusty stub, mylący)

**Uzasadnienie:** Kanoniczne wersje w repo. Root nie jest repo git. Prefiksy ścieżek w root są niepoprawne względem struktury. Zero utraty treści.

### Krok 2 — Usunięcie scratchpad/dump z root (bezpieczne)

Usunąć z `C:\xampp\htdocs\vilmax\`:
- `.bobochic-canapes.html`, `.bobochic-product.html`, `.bobochic-sitemap.xml` (scrape HTML — fixture testowy już w `test/fixtures/bobochic/`)
- `.bobochic-features.txt`, `.bobochic-parse.cjs` (jednorazowy parser — ekstrakcja w adapterze)
- `.draft-structure.txt` (zrzut draftu)
- `.npm-test-baseline.txt`, `.npm-test-spec.txt`, `.olx-title-out.txt`, `.smoke-out.txt`, `.test-out.txt` (stare zrzuty testów)

**Uzasadnienie:** Artefakty jednorazowe z budowy adaptera (26.08). Wszystka wartość jest w kodzie/testach. Poza repo git.

### Krok 3 — Archiwizacja dokumentów historycznych z root

Przenieść do `C:\xampp\htdocs\vilmax\_docs\archive\` (lub `vilmax-cockpit/docs/archive/`):
- `FIRST_SESSION.md` (superseded, referuje nieistniejące pliki)
- `NEW_SESSION_PROMPT.md` (superseded przez `docs/PROMPT-NOWA-SESJA.md`)

**Uzasadnienie:** Historyczne zrzuty sesji. Zachować dla kroniki, ale oznaczyć jako archiwum.

### Krok 4 — Zachowanie referencji Repo-First (decyzja: root vs przeniesienie)

Zachować w root LUB przenieść do `vilmax-cockpit/docs/repo-first-audit/`:
- `vixhub_repo_first_audit_report.md` (matryca reużycia komponentów)
- `vixhub_omnichannel_re_audit_report.md` (silnik e-commerce dla Etapu 2)
- `vixplan.md` (wizja strategiczna + model biznesowy/seeding)

**Uzasadnienie:** Unikalna treść wspierająca Repo-First Policy i Etap 2. Nigdzie indziej w repo. **Pytanie do człowieka:** zostawić w root (luźne referencje) czy przenieść do `docs/` (w repo, wersjonowane)?

### Krok 5 — Archiwizacja handoffów w repo

Przenieść do `vilmax-cockpit/docs/archive/`:
- `HANDOFF-B2.md` (snapshot B2, 219/219)
- `HANDOFF-B3.md` (snapshot B3, 359/359)

**Uzasadnienie:** Historyczne snapshoty z momentu ukończenia modułów. Liczniki nieaktualne. Zachować dla kroniki, ale nie w głównym drzewie docs.

### Krok 6 — Poprawka doc/code mismatches w kanonicznych docs (po zatwierdzeniu)

W `vilmax-cockpit/`:
- `AGENTS.md` §14.5: poprawić wzmianki o `vilmaxFR.js` (usunięty w Fazie 3 migracji; tylko `bobochicFR` aktywny).
- `docs/PROGRESS.md` §4, §4.2: poprawić wzmianki o `vilmaxFR.js` jako fallbacku.
- `docs/MIGRATION-CARPET-TO-FURNITURE.md` §1.2: poprawić "zostaje bobochicFR + vilmaxFR" → "zostaje tylko bobochicFR".
- `docs/RUNCOMFY_SETUP.md` + `docs/PROMPT-NOWA-SESJA.md`: odświeżyć licznik testów 487 → 509.
- `docs/AUDIT-furniture-migration-2026-08-26.md`: dodać sprostowanie — render.yaml name już naprawione.

**Uzasadnienie:** Zgodność docs z kodem (Definition of Done AGENTS.md §15).

---

## 5. PODSUMOWANIE

| Kategoria | Liczba plików | Akcja |
|---|---|---|
| Stare duplikaty docs (root) | 3 | Delete |
| Scratchpad/dump (root) | 11 | Delete |
| Pusty stub (root) | 1 | Delete |
| Historyczne sesje (root) | 2 | Archive |
| Unikalne referencje (root) | 3 | Keep lub przenieść do docs/ |
| Historyczne handoffy (repo) | 2 | Archive do docs/archive/ |
| Kanoniczne docs (repo) | 12 | Keep (5 z drobnymi poprawkami) |
| Kod produkcyjny (repo) | 8 | Keep |

**Stan kodu:** 509/509 testów zielonych. Wszystkie 8 modułów MVP zaimplementowane + Etap 2 (Visual AI, RunComfy, Kling wideo) w trakcie. Repo spójne i działające — jedynie dokumentacja ma historyczne niespójności (vilmaxFR.js, liczniki testów).

**Następny krok:** Czeka na decyzję człowieka co do Kroków 1-6 powyżej.