-
1. Zacznij od jednego pytania biznesowego
Wybierz jedno pytanie biznesowe, jego właściciela i źródło. Zapisz krótką odpowiedź, którą właściciel może przejrzeć: to Twój pierwszy model.
Przykład z publicznego modelu PrestaShop:
- Pytanie
- Czy ten koszyk może stać się zamówieniem?
- Wybrany warunek
- Koszyk nie jest pusty, a każda pozycja ma ilość większą od zera.
- Źródło i przegląd
- Publiczna reguła zamówienia; przegląda ją właściciel reguły po stronie produktu.
- Do rozstrzygnięcia
- Czy prośba o zakup na później też powinna stać się zamówieniem?
Nie włączaj innych domen do tej pierwszej części modelu. Mały model łatwiej sprawdzić, przejrzeć i rozbudować.
-
2. Pobierz publiczne repozytorium
Użyj własnego agenta w Claude Code, Codex lub Cursor, aby zbudować model swojego systemu z Archally. Publiczne repozytorium zawiera schemat Blueprint, lokalne narzędzia do sprawdzania, agenta modelującego, polecenia i umiejętności metodyczne. Razem pomagają zapisać wspólny słownik, przepływy, reguły i decyzje w YAML, który Ty i Twój agent możecie czytać i rozwijać. Model możesz też napisać ręcznie i sprawdzić lokalnie. Renderery Archally Pro działają lokalnie na licencji offline, na odrębnych warunkach komercyjnych.
Zestaw zawiera agenta blueprint-modeler, polecenia blueprint-new i blueprint-check-all oraz umiejętności ddd-modeling, event-storming-modeler i capability-mapping.
- Quick Start w README (po angielsku)
- Przewodnik po zestawie dla agentów AI w Claude Code, Codex i Cursor (po angielsku)
- Gotowe przykłady (po angielsku)
Czytaj README i przewodniki z tej samej wersji co Twój model.
Otwórz publiczne repozytorium Blueprint (po angielsku) -
3. Pracuj ze swoim agentem AI w konsoli
Blok powłoki zawiera polecenia do terminala. Blok prośby zawiera instrukcję, którą wpisujesz swojemu agentowi AI. Każdy blok ma przycisk kopiowania.
Przygotuj repozytorium
Mając Node 22 lub nowszy, sklonuj repozytorium i zbuduj jego lokalne narzędzia. To kroki przygotowania, a nie instalator.
git clone https://github.com/Archally/blueprint-schema.gitcd blueprint-schemanpm installnpm run buildSkopiowano. Kopiowanie się nie udało. Tekst jest zaznaczony: skopiuj go za pomocą klawiatury.
Otwórz folder w swoim agencie
- Claude Code: otwórz terminal w folderze repozytorium i uruchom
claude. - Codex: otwórz terminal w folderze repozytorium, uruchom
codexi zaufaj folderowi, aby załadował się agent blueprint-modeler. - Cursor: otwórz sam folder repozytorium jako przestrzeń roboczą przez File, Open Folder.
Każde z tych środowisk czyta zestaw tylko z otwartego folderu, więc otwórz sam folder repozytorium.
Poproś o jedną zmianę o określonym zakresie
Daj agentowi AI jedno pytanie, jego zakres, źródła i schemat. Poproś, aby oddzielił obserwacje od wniosków i nazwał to, co pozostaje otwarte.
Read the rule orders.SR001 and the command orders.CMD001 in examples/prestashop/.blueprint/v2.8/orders/.Using the selected cart rule and its command link, draft a short explanation of when this condition is met. Cite the rule, separate observations from inferences, and flag whether it settles the empty-cart request.Skopiowano. Kopiowanie się nie udało. Tekst jest zaznaczony: skopiuj go za pomocą klawiatury.
To przykładowa prośba, a nie zapis rzeczywistej sesji z agentem AI.
Przejrzyj proponowaną zmianę
Poprawna zmiana w YAML nadal może wyolbrzymiać regułę. W tym wymyślonym przykładzie agent AI proponuje:
summary: "A non-empty cart always places an order."Osoba przeglądająca odrzuca „always”: reguła wymaga też ilości większych od zera, a inne warunki pozostają otwarte. Poprawione podsumowanie brzmi:
summary: "Selected condition: non-empty cart and positive line quantities."Właściciel reguły po stronie produktu nadal decyduje, czy pusty koszyk może stać się zamówieniem.
Uruchom kontrole i przejrzyj wynik
Poproś agenta AI o uruchomienie kontroli z zestawu:
Run /blueprint-check-all examples/prestashop/.blueprint/v2.8Skopiowano. Kopiowanie się nie udało. Tekst jest zaznaczony: skopiuj go za pomocą klawiatury.
W Claude Code i Cursor możesz też wpisać polecenie po ukośniku. W Codex poproś tak, jak napisano, aby agent AI wykonał plik polecenia. Zatwierdź trzy polecenia npm run, gdy agent o to poprosi, a potem przeczytaj wyniki z właścicielem reguły.
Gdy agenci pracują w kilku krokach
- Daj każdemu agentowi AI jedną zmianę o określonym zakresie, gotową do podjęcia, wraz z kryteriami jej odbioru.
- Przydzielaj pracę roli tylko wtedy, gdy ma ona uprawnienia i narzędzia, których ta praca wymaga.
- Pozytywny wynik kontroli modelu nie dowodzi, że system działa tak, jak go opisano.
- Decyzję właściciela rozstrzyga tylko jego rzeczywista odpowiedź.
- Następca wznawia pracę od zweryfikowanego stanu, a pracę odbiera się na podstawie dowodów, a nie deklaracji, że jest skończona.
- Claude Code: otwórz terminal w folderze repozytorium i uruchom
-
4. Sprawdzaj i raportuj publicznymi narzędziami
W katalogu głównym przygotowanego repozytorium możesz samodzielnie uruchomić kontrole i raport:
npm run validate -- examples/prestashop/.blueprint/v2.8 --schemas schemanpm run check -- examples/prestashop/.blueprint/v2.8npm run quality -- examples/prestashop/.blueprint/v2.8npm run render -- examples/prestashop/.blueprint/v2.8 -o prestashop-report.md -t PrestaShopSkopiowano. Kopiowanie się nie udało. Tekst jest zaznaczony: skopiuj go za pomocą klawiatury.
- Walidacja sprawdza zgodność ze schematem i odwołania.
- Kontrola semantyczna zgłasza problemy strukturalne, a bramka jakości wskazuje brakujące lub słabe opisy.
- Publiczny renderer Blueprint tworzy raport Markdown z osadzonymi diagramami Mermaid. Inne narzędzia również mogą czytać model YAML.
Kontrole nie rozstrzygają prawdy biznesowej. Kod wyjścia 0 nie oznacza, że model jest kompletny ani poprawny: przeczytaj wyniki i przejrzyj znaczenie z osobami, które za nie odpowiadają.
Schemat, przykłady, dokumentacja, walidator referencyjny i zestaw dla agentów AI są na licencji Apache-2.0. Konstruktor modelu, kontrola semantyczna, bramka jakości i renderer są na licencji FSL-1.1-ALv2. Zobacz mapę licencji w repozytorium. (po angielsku)
-
5. Zobacz więcej z Archally Pro
Pro jest opcjonalne. Wybierz narzędzie do pytania odbiorcy, a potem potwierdź obsługiwany zakres i dostęp dla swojego modelu.
Bogatsze widoki tego samego modelu
Wybierz wizualizację do pytania, na które chcesz odpowiedzieć. Pro oferuje renderery diagramów i raportów oraz interaktywne przeglądarki tego samego modelu.
Renderery Pro działają lokalnie na licencji offline, na odrębnych warunkach komercyjnych. Zapytaj o dostęp.
Poznaj narzędzia Pro do wizualizacjiKontekst modelu dla Twoich agentów AI
Włącz model do Spec Driven Development (SDD) i cyklu rozwoju oprogramowania (SDLC) z AI.
Pro obejmuje Blueprint MCP i CLI bp. GraphQL jest częścią zaplecza przeglądarki.
Agent AI może odpytywać ustrukturyzowany kontekst modelu przez Blueprint MCP. Nie gwarantuje to trafnej odpowiedzi ani nie dowodzi braku skutku, którego model nie opisuje.
Napisz, na jakie pytanie Twój zespół potrzebuje odpowiedzi, a potwierdzimy, co Pro obsługuje dla Twojego modelu.
Zapytaj o dostęp do Archally Pro
Wolisz, aby InPerceptic ocenił Twój system razem z Tobą? Przeczytaj o pilotażu