Pattern: Fork-Join | Team size: 6 agents
Pirma bendra „taryba“ suformuoja standartus ir dizainą (promptų šablonus, kodavimo taisykles, testavimo vartus), tuomet komanda išsišakoja į kelias įgyvendinimo kryptis ir galiausiai sujungia rezultatus per vieną integracijos vartą. Fork-Join tinka, kai reikia detalaus vadovo ir pakartojamos sistemos: vienas branduolys nustato procesą, o šakos leidžia greitai kurti funkcijas ir taisyti klaidas lygiagrečiai, išlaikant vientisumą.
mano programuotoju komanda neturi strukturos kaip dirbdama su dirbtiniu intelektu galetu daug greiciau istaisyti klaidas ir kurti naujas funkcijas. man reikia detalaus vadovo kaip tai padaryti
Create an agent team to sukurti detalią, pakartojamą struktūrą (procesą + artefaktus) kaip programuotojų komanda, dirbdama su dirbtiniu intelektu, galėtų ženkliai greičiau taisyti klaidas ir kurti naujas funkcijas, išlaikant architektūrinį vientisumą, kokybę ir saugumą.
Kontekstas ir tikslas (perskaityk ir laikykis):
- Kalba: visa medžiaga lietuvių kalba.
- Auditorija: 5–12 žmonių programuotojų komanda (mid/senior miksas), turinti esamą produktą ir nuolatinį bugų srautą + feature užklausas.
- Tikslas: sukurti „AI darbo sistemą“: standartus, šablonus, vartus, testavimo strategiją, PR/review praktiką, knowledge base struktūrą ir realius pavyzdžius.
- Išvestys turi būti copy-paste-ready ir pritaikomos bet kokiam stack’ui (nurodyk vietas, kur komandai reikia įrašyti savo technologijas).
- Reikalavimas: aiškūs priklausomybių vartai („šis žingsnis privalo būti atliktas prieš …“), konkrečios rolės ir atsakomybės, matuojami kokybės kriterijai, šablonai, kontroliniai sąrašai.
- Nenaudok abstrakcijų be pavyzdžių: kiekvienam procesui pateik bent 1 konkretų pavyzdį (bug fix ir naujos funkcijos).
Bendri komandinio darbo mechanizmai (privaloma):
- Dirbkite Fork-Join principu:
1) „AI Architektūros Taryba“ (visi agentai kartu) suformuoja bendrus standartus ir karkasą.
2) Tada šakokitės: kiekvienas agentas parengia savo srities artefaktus.
3) Galiausiai „Integracijos Vartininkas“ sujungia, sutikrina prieštaravimus, sutvarko terminiją, užtikrina atsekamumą tarp dokumentų.
- Kiekvienas agentas privalo:
- Pateikti 5–10 „Assumptions & Open Questions“ sąrašą savo failo pradžioje.
- Pateikti „Risks & Mitigations“ (min 5 punktai).
- Pateikti „Quick wins per 7 dienas“ (min 5 punktai).
- Dalinimasis įžvalgomis:
- Kiekvienas agentas, prieš baigdamas savo failą, įrašo skyrių „Reikalinga iš kitų agentų“ su konkrečiais prašymais (min 3).
- Kiekvienas agentas privalo perskaityti bent 2 kitų agentų „Reikalinga iš kitų agentų“ ir atnaujinti savo dokumentą (įdėk skyrių „Gauta iš kitų agentų“).
- Challenge mechanika:
- Kiekvienas agentas turi pateikti 3 kritines pastabas (ne mažiau) bent 2 kitų agentų siūlymams, nurodydamas: „kas negerai“, „kodėl“, „kaip pataisyti“.
- Šias pastabas surašykite į bendrą failą (nurodytą žemiau) ir išspręskite integracijos etape.
Projekto pavadinimas failų keliams:
- Naudokite: outputs/agent_teams_demo/ai_darbo_sistema/
Bendras pristatymo formatas (visiems failams):
- Markdown.
- Naudok H2/H3 antraštes.
- Venk ilgų įžangų; orientuokis į procedūras, šablonus, checklistus, pavyzdžius.
- Kur įmanoma, pateik lenteles.
- Kur pateiki šabloną, jis turi būti su kopijuojamais blokais (tekstiniai template’ai).
FAZĖ 0 — AI Architektūros Taryba (visi agentai kartu; tai privalo būti atlikta prieš bet kokią šaką)
Sukurkite bendrą branduolį ir suderinkite terminiją, kad šakos nekurstų prieštaravimų.
Deliverable 0.1 (privalomas):
- Failas: outputs/agent_teams_demo/ai_darbo_sistema/00_tarybos_sprendimai.md
- Apimtis: 900–1400 žodžių.
- Struktūra:
1) Tikslai (3–6 punktai)
2) Principai (7–10 punktų; pvz. „AI nerašo be testų plano“, „maži PR“, „atsekamumas“)
3) Terminų žodynėlis (min 12 terminų: DoR, DoD, AC, edge cases, quality gates, PR gate, incident, postmortem, kt.)
4) Vienas end-to-end pavyzdys (trumpa schema): nuo bug report → taskų → įgyvendinimo → testų → PR → merge → KB įrašas
5) Neaiškumai ir sprendimo būdas (min 5): ką komanda turi nuspręsti pritaikant sau
- Aiškiai įrašyk priklausomybę: „Visi kiti failai turi atitikti šį dokumentą. Šis dokumentas turi būti sukurtas pirmas.“
Deliverable 0.2 (privalomas challenge log):
- Failas: outputs/agent_teams_demo/ai_darbo_sistema/00_challenge_log.md
- Apimtis: 400–800 žodžių + lentelė.
- Lentelė su stulpeliais: Pasiūlymas | Kritika | Rizika | Pataisymas | Sutarta? (Taip/Ne) | Savininkas
- Šį failą pildykite viso darbo metu; integracijos vartininkas pabaigoje turi sužymėti „Sutarta?“.
FAZĖ 1 — Šakos (pradėti tik užbaigus FAZĘ 0; tai privaloma priklausomybė)
Agentas 1: AI Darbo Metodikos Architektas
Užduotis: sukurti komandai AI naudojimo vadovą: promptų biblioteką, darbo srautą, DoD/DoR ir rizikų valdymą.
Deliverables:
1) Failas: outputs/agent_teams_demo/ai_darbo_sistema/01_ai_darbo_metodika.md
- Apimtis: 1800–2600 žodžių.
- Skyriai (privalomi, tokiais pavadinimais):
- Assumptions & Open Questions (5–10)
- AI naudojimo ribos ir taisyklės (pvz. duomenų apsauga, paslaptys, licencijos) (min 10 taisyklių)
- Komandos rolės ir atsakomybės (RACI mini-lentelė: Dev, TL, QA, PM, „AI driver“, „AI reviewer“)
- DoR (Definition of Ready) su checklistu (min 12 punktų)
- DoD (Definition of Done) su checklistu (min 14 punktų)
- Standartinis darbo srautas: Bugfix (žingsniai 1–12)
- Standartinis darbo srautas: Feature (žingsniai 1–14)
- Promptų biblioteka (min 12 promptų): skirstyk į kategorijas (Spec, Debug, Refactor, Tests, Review, Docs). Kiekvienas promptas turi turėti: Kada naudoti | Įvestys | Promptas | Tikėtinas rezultatas | Dažnos klaidos
- Rizikų valdymas (min 8 rizikos + mitigacijos)
- Quick wins per 7 dienas (min 5)
- Reikalinga iš kitų agentų (min 3)
- Gauta iš kitų agentų (min 3; pridėk po to, kai peržiūrėsi kitų agentų prašymus)
2) Failas: outputs/agent_teams_demo/ai_darbo_sistema/01_praktiniai_pavyzdziai.md
- Apimtis: 900–1400 žodžių.
- Pateik 2 pilnus, konkrečius pavyzdžius (su šablonais):
- Pavyzdys A: bug report → AI klausimai → AC/edge cases → planas → PR aprašymas → KB įrašas
- Pavyzdys B: feature request → spec → task breakdown → test plan → PR aprašymas → release note juodraštis
Agentas 2: Produktinių Reikalavimų Vertėjas (Spec-to-Tasks)
Užduotis: su AI paversti user story/bug reportus į aiškius techninius taskus, acceptance criteria ir edge-case sąrašus.
Deliverables:
1) Failas: outputs/agent_teams_demo/ai_darbo_sistema/02_spec_to_tasks_playbook.md
- Apimtis: 1600–2200 žodžių.
- Skyriai:
- Assumptions & Open Questions
- Įvesties kokybės standartas (kas privalo būti bug reporte / feature requeste) (lentelė)
- AI klausimų rinkinys triage’ui (min 20 klausimų, suskirstytų: funkcionalumas, duomenys, UI, performance, security, observability)
- Acceptance Criteria (AC) rašymo taisyklės (min 10) + 3 geri ir 3 blogi AC pavyzdžiai
- Edge cases katalogas (min 30 edge case kategorijų su pavyzdžiais)
- Task skaidymo metodas (invest, vertical slices, spikes) + sprendimo medis „kada spike?“
- Šablonai:
- Bug triage šablonas
- Feature spec šablonas (max 1 psl)
- Techninių taskų šablonas (su subtasks, rizikom, priklausomybėm)
- Atsekamumas (traceability): kaip susieti AC ↔ testai ↔ PR ↔ release note
- Quick wins per 7 dienas
- Risks & Mitigations
- Reikalinga iš kitų agentų
- Gauta iš kitų agentų
2) Failas: outputs/agent_teams_demo/ai_darbo_sistema/02_ready_to_build_checklist.md
- Apimtis: 300–600 žodžių.
- Vienas puslapis: „Ready-to-build“ checklistas (min 18 punktų) naudojamas prieš pradedant kodinti.
Agentas 3: Kodo Standartų ir Refaktoringo Prižiūrėtojas
Užduotis: užtikrinti, kad AI generuotas kodas atitiktų architektūrą, stilių, saugumą ir būtų refaktorinamas ten, kur reikia.
Deliverables:
1) Failas: outputs/agent_teams_demo/ai_darbo_sistema/03_kodo_standartai_ai_kodui.md
- Apimtis: 1800–2400 žodžių.
- Skyriai:
- Assumptions & Open Questions
- AI generuoto kodo rizikos (min 8) ir kaip jas gaudyti review metu
- Kodavimo standartai (kalbai neutralūs): naming, error handling, logging, i18n, config, dependency boundaries (min 15 taisyklių)
- Architektūriniai „guardrails“ (min 10): kur AI neturi lįsti be žmogaus sprendimo
- Refaktoringo politika: kada refactor vs fix (sprendimo medis) + „boy scout rule“ praktika
- Saugumo kontrolinis sąrašas (min 20 punktų; auth, injection, secrets, PII, SSRF, rate limiting, kt.)
- AI pair-programming protokolas: „Driver“ ir „Navigator“ (žingsniai 1–10)
- PR review checklistas (min 25 punktų) orientuotas į AI sukurtą kodą
- Quick wins per 7 dienas
- Risks & Mitigations
- Reikalinga iš kitų agentų
- Gauta iš kitų agentų
2) Failas: outputs/agent_teams_demo/ai_darbo_sistema/03_refaktoringo_pavyzdys.md
- Apimtis: 500–900 žodžių.
- Vienas konkretus refaktoringo scenarijus: „prieš“/„po“ aprašymas (be realaus kodo, bet su pseudo-struktūra), kokius promptus naudoti, kokius testus pridėti, kaip aprašyti PR.
Agentas 4: Testų Strategas (Coverage & Gates)
Užduotis: sukurti testavimo strategiją (piramidė, kritiniai keliai), AI pagalba apibrėžti minimalius kokybės vartus ir regresiją.
Deliverables:
1) Failas: outputs/agent_teams_demo/ai_darbo_sistema/04_testavimo_strategija_ir_gates.md
- Apimtis: 2000–2800 žodžių.
- Skyriai:
- Assumptions & Open Questions
- Testavimo piramidė komandai (unit/integration/e2e/contract) + kada ką rinktis (lentelė)
- Kritiniai keliai (min 8) ir kaip juos automatizuoti
- Kokybės vartai (Quality Gates) (min 10) su aiškiais slenksčiais (pvz. „nėra flaky testų“, „lint/format“, „min coverage“ – pateik kaip konfigūruojamus kintamuosius)
- Regresijos strategija: kaip pasirinkti minimalų rinkinį per bugfix vs feature
- Flaky testų valdymas: triage, karantinas, taisymo SLA
- Testų rašymo su AI workflow (žingsniai 1–12) + 6 promptai testams (jei kartojasi su agentu 1, suderink ir nurodyk nuorodą)
- Observability: logai, metrikos, alertai kaip „testų“ papildymas (min 6 taisyklės)
- Quick wins per 7 dienas
- Risks & Mitigations
- Reikalinga iš kitų agentų
- Gauta iš kitų agentų
2) Failas: outputs/agent_teams_demo/ai_darbo_sistema/04_test_plan_template.md
- Apimtis: 250–500 žodžių.
- „Test Plan“ šablonas, kurį galima įdėti į ticketą/PR.
Agentas 5: Integracijos Vartininkas (PR/Review Gatekeeper)
Užduotis: sujungti šakų rezultatus: atlikti PR review su AI, valdyti konfliktus, užtikrinti atsekamumą ir kokybę prieš merge.
Deliverables:
1) Failas: outputs/agent_teams_demo/ai_darbo_sistema/05_pr_ir_review_vartai.md
- Apimtis: 1600–2200 žodžių.
- Skyriai:
- Assumptions & Open Questions
- Branch/PR strategija (trunk-based vs GitFlow) – pateik rekomendaciją + kada kuri (sprendimo lentelė)
- PR dydžio taisyklės ir slicing (min 8 taisyklės) + pavyzdžiai
- PR aprašymo šablonas (copy-paste; su AC, test plan, rizikom, rollback, observability)
- AI-assisted code review protokolas (žingsniai 1–10): kaip klausti AI, kaip tikrinti atsakymus, kaip vengti „approval bias“
- Konfliktų sprendimas tarp dokumentų/standartų: kaip priimti sprendimą (mini governance)
- Atsekamumo matrica: ticket → commit/PR → testai → release → KB (lentelė)
- Merge vartai (min 12): kas turi būti „žalia“ prieš merge
- Quick wins per 7 dienas
- Risks & Mitigations
- Reikalinga iš kitų agentų
- Gauta iš kitų agentų
2) Failas: outputs/agent_teams_demo/ai_darbo_sistema/05_integration_notes.md
- Apimtis: 600–1000 žodžių.
- Tai „integracijos žurnalas“: kas sujungta, kokie konfliktai rasti, kokie sprendimai priimti, nuorodos į skyrius/failus.
Agentas 6: Žinių Bazės Kuratorius
Užduotis: kaupti sprendimus, incidentų post-mortem, „playbookus“ ir komandines gerąsias praktikas į lengvai randamą knowledge base.
Deliverables:
1) Failas: outputs/agent_teams_demo/ai_darbo_sistema/06_knowledge_base_struktura.md
- Apimtis: 1600–2200 žodžių.
- Skyriai:
- Assumptions & Open Questions
- KB informacijos architektūra (IA): kategorijos, tag’ai, pavadinimų konvencijos (lentelė)
- „Kas turi patekti į KB“ taisyklės (min 15)
- Incident/postmortem šablonas (copy-paste) + kada privalomas
- „Playbook“ šablonas (copy-paste): simptomai → diagnostika → sprendimai → prevencija
- Sprendimų įrašai (ADR-lite) šablonas (copy-paste) + 3 pavyzdinės antraštės
- Paieškos ir atnaujinimo procesas: kas atsakingas, kaip sensta turinys, „KB review“ ritmas
- AI naudojimas KB kūrimui: 8 promptai (jei kartojasi su agentu 1, suderink ir remkis nuoroda)
- Quick wins per 7 dienas
- Risks & Mitigations
- Reikalinga iš kitų agentų
- Gauta iš kitų agentų
2) Failas: outputs/agent_teams_demo/ai_darbo_sistema/06_kb_minimalus_mvp.md
- Apimtis: 400–700 žodžių.
- „KB MVP per 1 savaitę“ planas: konkretūs puslapiai (min 12), atsakingi asmenys (rolės), ir Done kriterijai.
FAZĖ 2 — Sujungimas (Join) ir galutinė sintezė (privaloma; pradėti tik kai visi šakų deliverables užbaigti)
Integracijos Vartininkas koordinuoja, bet visi agentai turi prisidėti.
Deliverable 2.1 (galutinis vadovas):
- Failas: outputs/agent_teams_demo/ai_darbo_sistema/99_galutinis_vadovas.md
- Apimtis: 2600–3400 žodžių.
- Tai vienas nuoseklus „vadovas komandai“, sudėliotas taip:
1) Santrauka (150–220 žodžių): ką diegiame ir kokią naudą gausime per 30 dienų
2) Komandos darbo modelis su AI (įdiek per 2 savaites) (žingsniai 1–10)
3) Standartai: DoR/DoD (su nuorodomis į failus)
4) Spec → Tasks → Build → Test → PR → Merge → KB: vienas vieningas srautas (su vartais)
5) Kokybės vartai ir metrikos (min 8 metrikos): lead time, cycle time, bug reopen rate, escaped defects, flaky rate, review latency, kt. (pateik formules/kaip matuoti)
6) Promptų „starter pack“ (top 8) su nuorodomis kur pilnas sąrašas
7) 30/60/90 dienų diegimo planas (lentelė: tikslai, veiksmai, atsakingi, rizikos)
8) Anti-patterns (min 10) ir kaip jų išvengti
9) Nuorodų rodyklė į visus failus + kada kurį naudoti (lentelė)
Deliverable 2.2 (kokybės patikra ir uždarymas):
- Failas: outputs/agent_teams_demo/ai_darbo_sistema/99_review_checklist.md
- Apimtis: 300–600 žodžių.
- Checklistas, kuriuo patikrinate, kad:
- Nėra prieštaravimų tarp dokumentų (pateik 8 patikros punktus)
- Visi šablonai copy-paste-ready (pateik 6 patikros punktus)
- Visi procesai turi vartus ir priklausomybes (pateik 6 patikros punktus)
- Yra bent 2 end-to-end pavyzdžiai (patikra)
- Challenge log išspręstas (patikra)
Priklausomybės (privaloma laikytis):
- 00_tarybos_sprendimai.md turi būti pilnai parengtas prieš pradedant 01–06 failus.
- 00_challenge_log.md pradedamas FAZĖJE 0 ir pildomas iki pat pabaigos.
- 99_galutinis_vadovas.md ir 99_review_checklist.md kuriami tik po to, kai užbaigti visi 01–06 deliverables ir 05_integration_notes.md.
- Kiekvienas agentas privalo į savo failus įdėti nuorodas į kitus dokumentus (cross-links) bent 5 vietose.
Galutinė sintezė/review (paskutinis veiksmas, privalomas):
- Visi agentai perskaito 99_galutinis_vadovas.md ir 00_challenge_log.md.
- Kiekvienas agentas pateikia po 5 punktus „kas trūksta / kas dviprasmiška / kas nepraktiška“ ir po 3 konkrečius pataisymus.
- Integracijos Vartininkas atnaujina 99_galutinis_vadovas.md ir pažymi 00_challenge_log.md visus įrašus kaip „Sutarta? Taip“ arba palieka „Ne“ su aiškia priežastimi ir sekančiais žingsniais.
- Užbaikite su trumpu (120–200 žodžių) skyriumi 99_galutinis_vadovas.md pabaigoje: „Kaip pradėti rytoj ryte“ (konkretūs 6 veiksmai).
Create your own AI agent team at Build Agents Store. Describe your business problem and get specialized agent teams with ready-to-use prompts for Claude Code.