Presale Generator

Wtyczka Presale Generator automatyzuje proces wyceny projektów programistycznych i analizy technicznych zapytań ofertowych (RFP). Przekształca nieustrukturyzowane dokumenty w hierarchiczną strukturę podziału prac (WBS), szacuje nakład pracy w roboczogodzinach, opracowuje harmonogram wdrożenia oraz wylicza zapotrzebowanie na obsadę zespołu.

Architektura i komponenty

Presale Generator działa jako w pełni lokalny kontener workera łączący:

Silnik orkiestracji stanu: 53 funkcyjne narzędzia MCP zarządzające maszynami stanów, wersjami iteracji, rejestrami ryzyk i drzewami WBS.
Potok ekstrakcji dokumentów w Pythonie: Wydajne parsery (markitdown, pdftotext, pandoc, openpyxl, python-docx, docling) odczytujące zapytania ofertowe w wielu formatach.
Zestaw skilli: 22 polecenia CLI oraz 24 wyspecjalizowane prompty dekomponujące dokumenty równolegle za pomocą subagentów.

Maszyna stanów procesu wyceny

Prace nad ofertą są organizowane w odrębne szanse (opportunities) inicjalizowane poleceniem /presale:add <nazwa>. Analiza postępuje deterministycznie przez kolejne fazy cyklu życia:

flowchart LR
  Extract["1. Ekstrakcja<br/>Wielosilnikowe parsowanie"] --> Analyze["2. Analiza<br/>Aktorzy, FR, NFR, Luki"]
  Analyze --> Breakdown["3. Podział prac<br/>Epiki, Funkcje, Zadania"]
  Breakdown --> Estimate["4. Estymacja<br/>Godziny i strumienie"]
  Estimate --> Plan["5. Planowanie<br/>Harmonogram i obsada"]

Polecenie /presale:continue weryfikuje warunki wstępne procesu, przechodząc do kolejnego etapu wyłącznie wtedy, gdy artefakty z poprzedniej fazy spełniają kryteria jakościowe (quality gates).

Struktura skilli

Główne skille orkiestrujące delegują zadania do wyspecjalizowanych workerów przetwarzających poszczególne fragmenty dokumentacji:

Skill nadrzędny	Zakres działania
`presale-rfp-analyzer`	Dekompozycja dokumentów RFP na równoległe fragmenty, ekstrakcja wymagań i identyfikacja luk technicznych.
`presale-breakdown`	Strukturyzacja wymagań funkcjonalnych w hierarchię Epików, Funkcji i Zadań (WBS).
`presale-estimator`	Pakietowe rozdzielanie zadań inżynieryjnych między agentów estymujących w celu oceny nakładu godzinowego.
`presale-auto-assume`	Przekształcanie nierozstrzygniętych luk technicznych w formalne założenia projektowe z oceną ryzyka.
`presale-cross-reference-builder`	Walidacja pełnej identyfikowalności (traceability) wymagań w wygenerowanych artefaktach.
`presale-risk-aggregator`	Konsolidacja i priorytetyzacja ryzyk technicznych, architektonicznych i harmonogramowych.
`presale-team-composition`	Wyliczanie zapotrzebowania na obsadę zespołu na podstawie stosu technologicznego i strumieni prac.
`presale-timeline`	Kompilacja harmonogramów realizacji z uwzględnieniem dostępności inżynierów, świąt i zależności zadań.
`presale-use-cases`	Opracowywanie ustrukturyzowanych specyfikacji przypadków użycia z przepływami alternatywnymi i wyjątkami.

Wykaz poleceń

Główne polecenia procesu presales działają w przestrzeni /presale::

Polecenie	Przeznaczenie
`/presale:add <nazwa>`	Inicjalizacja struktury katalogów nowej szansy sprzedażowej.
`/presale:select <nazwa>`	Powiązanie aktywnej sesji ze wskazaną szansą.
`/presale:extract`	Parsowanie dokumentów w folderze szansy do znormalizowanego formatu Markdown.
`/presale:analyze`	Uruchomienie automatycznej ekstrakcji wymagań i analizy luk.
`/presale:create-wbs`	Generowanie hierarchicznej struktury WBS.
`/presale:estimate`	Wyliczenie alokacji godzinowej dla zadań.
`/presale:timeline`	Generowanie harmonogramu kamieni milowych wdrożenia.
`/presale:team`	Generowanie rekomendowanego składu i alokacji zespołu projektowego.
`/presale:continue`	Wznowienie wykonywania procesu od bieżącego aktywnego punktu kontrolnego.
`/presale:status`	Wyświetlenie metryk postępu fazy oraz wskaźników kompletności artefaktów.

Zarządzanie iteracjami (`/presale:iteration`)

create: Zapisanie bieżącego stanu WBS jako niezmiennego punktu kontrolnego wersji (snapshot).
list: Pobranie listy zarejestrowanych iteracji.
switch: Przywrócenie aktywnego stanu projektu do wskazanego punktu kontrolnego wersji.
compare: Wyliczenie macierzy różnic pomiędzy dwiema iteracjami wyceny.

Konfiguracja

Presale Generator działa całkowicie offline i nie wymaga poświadczeń zewnętrznych API chmurowych:

Włącz wtyczkę w swoim projekcie w ustawieniach Desktop lub poleceniem speedwave plugin enable presale-generator --project <nazwa>.
Zainicjalizuj szansę poleceniem /presale:add <nazwa-szansy>.
Skopiuj dokumenty zapytania ofertowego do wygenerowanego katalogu wejściowego i rozpocznij analizę.

Bezpieczeństwo i poufność danych

Kontener Presale Generator wykonuje się całkowicie wewnątrz odizolowanego lokalnego kontenera bez wychodzącego ruchu sieciowego. Wgrane dokumenty ofertowe oraz wygenerowane hierarchie WBS pozostają lokalnie w repozytorium projektu. Szczegóły znajdziesz w rozdziale Zarządzanie poświadczeniami.