This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Workflow для агентов и задач

Главный принцип

Агент не должен просто менять файлы. Каждая задача по игровому объекту должна завершаться обновлением Wiki.

Перед началом задачи

1. Открыть GitWork issue.
2. Найти связанную Wiki-страницу.
3. Если страницы нет, создать ее по шаблону.
4. Проверить source files из issue и Wiki.
5. Уточнить current status объекта.
6. Зафиксировать, что входит и что не входит в scope.

Во время работы

Агент должен записывать в Wiki:

• найденные paths;
• scripts/components;
• prefabs;
• catalog ids;
• server classes;
• packet names;
• missing pieces;
• blockers;
• verification steps.

После работы

Issue можно закрывать только если:

• scope выполнен или явно переведен в blocker/later/disabled;
• Wiki обновлена;
• статус объекта изменен;
• evidence приложен;
• новые blockers заведены отдельными linked issues;
• соседние системы не сломаны или проверены regression steps.

Формат GitWork issue

# OBJECT-ID: короткое название

## Wiki

Ссылка на Wiki-страницу.

## Scope

Конкретный объект, batch, region, packet, UI block или category.

## Current state

Что уже есть.

## Missing / blockers

Что нужно сделать или выяснить.

## Implementation checklist

- [ ] Конкретный шаг

## Acceptance criteria

- Конкретный критерий

## Проверка

- Как проверить

## Wiki update

- [ ] Wiki page updated
- [ ] Status updated
- [ ] Evidence linked

Когда создавать child issue

Child issue нужна только если:

• найден самостоятельный bug/blocker;
• нужен другой владелец;
• scope стал слишком большим;
• один объект блокирует несколько задач;
• требуется server-side работа отдельного человека.

Child issue не нужна просто потому, что в catalog есть еще одна строка.

Labels

Рекомендуемые labels:

• source:planned
• area:characters
• area:maps
• area:npc
• area:items
• area:skills
• area:ui
• area:network
• area:qa
• type:implementation
• type:triage
• type:bug
• blocked:server
• blocked:asset
• blocked:design

Milestones

Milestones назначаются позже. Сначала формируется объектная структура. Потом задачи можно разложить по этапам:

• Wiki foundation;
• MVP vertical slice;
• content expansion;
• server integration;
• QA hardening;
• release candidate.