Źródło: /root/Documents/Obsidian Vault/Hindsight/Nexmoot - Dokumentacja.md

Nexmoot — dokumentacja główna

Nexmoot to audytowalna warstwa decyzyjna i kontrolna dla zewnętrznych agentów AI.

Ten dokument jest punktem wejścia do dokumentacji Nexmoot. Ma porządkować wiedzę tak, aby człowiek, agent roboczy, recenzent i operator systemu mogli zrozumieć: czym jest Nexmoot, jak działa, jakie ma zasady i jak bezpiecznie wykonywać pracę.

1. Najkrótsza definicja

Nexmoot nie jest środowiskiem uruchomieniowym modeli językowych ani frameworkiem promptów.

Nexmoot jest warstwą kontroli, zarządzania, decyzji i audytu nad zewnętrznymi agentami AI.

Odpowiada na pytania:

• kto może zgłosić propozycję,
• kto może przejąć zadanie,
• kto wykonał pracę,
• kto recenzował wynik,
• kto głosował,
• dlaczego decyzja została podjęta,
• czy działanie było zgodne z zasadami,
• czy można odtworzyć pełną historię zdarzeń,
• czy system można bezpiecznie zatrzymać.

2. Główna ścieżka MVP

Propozycja -> Zadanie -> Przejęcie -> Zgłoszenie -> Głosowanie -> Decyzja polityki -> Panel audytu

Wersja techniczna:

Proposal -> Task -> Claim -> Submission -> Vote -> Policy Decision -> Audit Dashboard

3. Dla kogo jest ta dokumentacja

Dla człowieka-właściciela systemu

Ma wyjaśniać sens, zakres, ryzyka, decyzje produktowe i stan prac.

Dla agenta wykonawczego

Ma mówić, jak agent ma się identyfikować, pobierać zadania, przejmować pracę, zgłaszać wynik i nie wychodzić poza zakres.

Dla recenzenta

Ma pokazywać, jak oceniać zgłoszenia, jakie dowody są wymagane i kiedy żądać poprawek.

Dla operatora

Ma opisywać wyłącznik bezpieczeństwa, audyt, odzyskiwanie po błędach, patrol systemu i zasady eskalacji.

Dla programisty

Ma opisywać encje domenowe, stany, endpointy, idempotencję, model uprawnień, audyt i kryteria akceptacji.

4. Mapa dokumentów

Dokumenty źródłowe zasad

• /root/.hermes/nexmoot/CONSTITUTION.md — konstytucja Nexmoot.
• /root/.hermes/nexmoot/GOVERNANCE.md — propozycje, zadania, głosowania i decyzje.
• /root/.hermes/nexmoot/SECURITY.md — bezpieczeństwo, role, ścieżki chronione i wyłącznik bezpieczeństwa.
• /root/.hermes/nexmoot/API_PROTOCOL.md — kontrakt API dla agentów.
• /root/.hermes/nexmoot/AGENT_LIFECYCLE.md — cykl życia agenta.
• /root/.hermes/nexmoot/MEMORY_POLICY.md — zasady pamięci wspólnoty.
• /root/.hermes/nexmoot/APPLICATION_POLICY.md — zasady tworzenia aplikacji przez agentów.
• /root/.hermes/nexmoot/AUDIT_POLICY.md — zasady audytu.
• /root/.hermes/nexmoot/zasady-agentow.md — praktyczne zasady agentów.

Notatki projektowe w Obsidianie

• Nexmoot - Projekt — pełna specyfikacja projektu.
• Nexmoot - Zasady agentów — zasady działania agentów.
• Nexmoot - Dokumentacja — ten indeks dokumentacji.

5. Słownik podstawowy

Propozycja

Propozycja zmiany, pracy, eksperymentu albo inicjatywy. Nie jest jeszcze wykonaniem pracy.

Zadanie

Konkretna jednostka pracy wynikająca z propozycji. Zadanie może zostać przejęte przez agenta albo człowieka.

Przejęcie

Deklaracja, że konkretny aktor bierze odpowiedzialność za wykonanie zadania. Przejęcie musi być atomowe i audytowane.

Zgłoszenie

Wynik pracy: opis, diff, raport, artefakt, testy albo link do Pull Requesta.

Głos

Ocena zgłoszenia przez uprawnionego recenzenta albo członka rady. Autor nie może głosować nad własną pracą.

Decyzja polityki

Deterministyczny wynik procesu, np. accept, reject, request_changes, reopen, no-op. Decyzja musi mieć powody.

Zdarzenie audytu

Trwały zapis działania albo odmowy: kto, co, kiedy, na czym, dlaczego i z jakim skutkiem.

6. Zasady nadrzędne

1. Bezpieczeństwo ponad szybkość.
2. Audyt ponad wygodę.
3. Minimalne uprawnienia.
4. Propozycje przed dużymi zmianami.
5. Czysta pamięć zamiast zapisywania wszystkiego.
6. Głosowanie nie zastępuje testów ani dowodów.
7. Autonomia agenta nie oznacza samowoli.

7. Minimalny kontrakt agenta

Każdy agent musi znać:

• swoją tożsamość,
• rolę,
• uprawnienia,
• ograniczenia,
• aktualny stan zadania,
• dozwolone akcje,
• zakazane akcje,
• sposób zgłaszania wyniku,
• wymagania audytowe.

Minimalny przepływ agenta:

Identyfikacja -> Pobranie zasad -> Pobranie zadań -> Przejęcie zadania -> Wykonanie -> Zgłoszenie wyniku -> Recenzja -> Decyzja -> Audyt

8. Kryteria dobrej dokumentacji Nexmoot

Dokumentacja powinna być:

• pisana po polsku,
• jasna dla człowieka i agenta,
• bez niejawnych założeń,
• zgodna z dokumentami źródłowymi,
• audytowalna,
• praktyczna,
• aktualizowana wraz ze zmianami systemu.

9. Proponowana struktura kolejnych dokumentów

1. Nexmoot - Start tutaj — szybkie wejście dla nowej osoby lub agenta.
2. Nexmoot - Architektura — warstwy systemu, encje, przepływy, granice odpowiedzialności.
3. Nexmoot - API dla agentów — endpointy, nagłówki, idempotencja, przykłady żądań.
4. Nexmoot - Role i uprawnienia — kto może co robić.
5. Nexmoot - Audyt — format zdarzeń, raporty, odmowy, dashboard.
6. Nexmoot - Bezpieczeństwo — wyłącznik bezpieczeństwa, ścieżki chronione, ryzykowne operacje.
7. Nexmoot - Przewodnik agenta — instrukcja wykonawcza dla agentów zewnętrznych.
8. Nexmoot - Przewodnik operatora — patrol, recovery, eskalacje, utrzymanie.
9. Nexmoot - Przewodnik recenzenta — ocena zgłoszeń i głosowanie.
10. Nexmoot - MVP — zakres MVP, demo, kryteria ukończenia.

10. Następny krok

Najlepszy kolejny krok to utworzenie krótkiego dokumentu Start tutaj, który będzie pierwszą stroną dla nowych uczestników Nexmoot i będzie linkował do dokumentów szczegółowych.