# Grantforge GSD — Główny Tryb Działania

Od maja 2026 **GSD (Grantforge Spec-Driven Development)** jest głównym sposobem działania całego systemu.

## Struktura

- `gsd_orchestrator.py` — centralny mózg (fazy, Konstytucja, polski HitL, audyt)
- `gsd_state.py` — rozszerzony stan z PolishHitlQuestion i audit_trail
- `bridge.py` — most do rzeczywistych agentów z `backend/agents/`
- `email_notifier.py` — wysyłka pytań zatwierdzających na Gmail
- `run_gsd_project.py` — zalecany runner do uruchamiania procesów
- `docs/` — Konstytucja i SWARM (wczytywane przez agenty)

## Jak uruchomić (główny tryb)

```bash
cd backend
python -m gsd.run_gsd_project --project-id "proj-123" --nip "5260000000"
```

Lub z poziomu API (po podłączeniu):

```python
from backend.gsd.gsd_orchestrator import GrantforgeGSDOrchestrator
from backend.gsd.gsd_state import create_gsd_state

state = create_gsd_state(project_id=project.id, profile=profile)
orch = GrantforgeGSDOrchestrator(state)
final_state = orch.run_full_gsd_flow()
```

## Polskie Pytania Zatwierdzające

W kluczowych momentach (Clarification, Matching, Audyt, Export) system generuje pytanie po polsku i może je wysłać mailem (Gmail).

## Integracja z istniejącym kodem

- Rzeczywiste agenty (`wizard_node`, `matcher_node`, `auditor`...) są wywoływane przez `bridge.py`.
- Stary `supervisor.py` jest traktowany jako legacy / komponent niskiego poziomu.
- GSD narzuca Konstytucję i pełny ślad audytu na cały proces.

## Status

GSD jest aktywny jako **główny tryb działania**.