Skip to content

README.md

Latest commit

 

History

History
35 lines (26 loc) · 4.21 KB

README.md

File metadata and controls

35 lines (26 loc) · 4.21 KB

Agents

Last touched: 2026-06-14 by @Skords-01. Next review: 2026-09-12. Status: Active

Операційний розділ для AI-агентів у Sergeant — це operating system для AI-агентів, які працюють у репо, а не AI-фічі продукту (HubChat, AI Coach, Mono-classifier тощо живуть під apps/web і apps/server і документуються в окремих модулях). Тут навігація по repo-owned skills, decision trees для типових flow і design specs.

History: до 2026-05-04 цей розділ називався docs/90-work/superpowers/. Перейменовано в межах initiative 0009 PR 2.2 для усунення термінологічної плутанини між «agent-OS surface» (цей розділ) і product-side AI features. 2026-05-05: підпапка specs/ (design specs для нетривіальних product-side фіч) переїхала в docs/05-design/design/specs/ — це product/UI design surface, а не agent-OS.

З чого починати агенту

  1. Відкрий AGENTS.md для hard rules і ownership.
  2. Стартуй з sergeant-start-here.
  3. Звір decisions.md — усталені рішення/вподобання, щоб не перепитувати вже вирішене.
  4. За таблицею в agent-skills-catalog.md вибери рівно один specialist skill.
  5. Для flow-level роботи звіряйся з agent-workflows.md.

Підрозділи

Підрозділ Призначення
onboarding.md Перші 30 хвилин агента в Sergeant: секрети, БД, hard-rule навігація, plop.
decisions.md Курований журнал усталених рішень/вподобань — щоб агент не перепитував вже вирішене (Initiative 0020).
agent-skills-catalog.md Scenario -> skill -> what it enforces.
agent-workflows.md Decision trees для feature, bugfix, review, migration, release.
codex-capabilities.md Що Codex у цьому репо вміє, що запускається автоматично, а що потребує явної команди.
specialists-mapping.md Runtime SpecialistAgent ↔ governance skill ↔ primary playbook ↔ ADR.
skills-evolution-roadmap.md Discovery roadmap: запозичення з agent-skills ecosystem (anthropics, supabase, obra) — 9 PR-послідовність.
skill-authoring-guide.md Конвенція references/ (3-tier disclosure): naming, обов'язковий frontmatter, enforcement у lint:skills.

Політика skill system

  • Repo-owned skills мають бути короткими, project-specific і enforce-ити Sergeant policy.
  • Generic browser, design, planning, or ecosystem encyclopedia skills не підтримуються як частина Sergeant surface.
  • Якщо потрібна загальна capability, агент використовує можливості своєї платформи, а потім застосовує Sergeant specialist skill.