dsh-department 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +11 -0
- package/LICENSE +21 -0
- package/README.en.md +50 -0
- package/README.md +255 -2
- package/assets/bgtiles.png +0 -0
- package/assets/carpet.png +0 -0
- package/assets/chair.png +0 -0
- package/assets/char-analyst-1.png +0 -0
- package/assets/char-analyst-2.png +0 -0
- package/assets/char-artist-1.png +0 -0
- package/assets/char-artist-2.png +0 -0
- package/assets/char-coder-1.png +0 -0
- package/assets/char-coder-2.png +0 -0
- package/assets/char-coder-3.png +0 -0
- package/assets/char-manager-1.png +0 -0
- package/assets/char-manager-2.png +0 -0
- package/assets/char-manager-3.png +0 -0
- package/assets/char-reviewer-1.png +0 -0
- package/assets/char-reviewer-2.png +0 -0
- package/assets/char-reviewer-3.png +0 -0
- package/assets/char-tester-1.png +0 -0
- package/assets/char-tester-2.png +0 -0
- package/assets/char-tester-3.png +0 -0
- package/assets/cubicles.png +0 -0
- package/assets/office-atlas.json +257 -0
- package/assets/office-atlas.png +0 -0
- package/assets/office-tilemap.png +0 -0
- package/client.js +2016 -0
- package/cordis.patch.yml +5 -0
- package/index.js +55 -0
- package/package.json +62 -3
- package/src/activity.js +170 -0
- package/src/attempts.js +95 -0
- package/src/blueprint.js +168 -0
- package/src/browse.js +74 -0
- package/src/commands.js +48 -0
- package/src/compose.js +45 -0
- package/src/documents.js +108 -0
- package/src/gates.js +52 -0
- package/src/git.js +183 -0
- package/src/gui.js +68 -0
- package/src/panel-api.js +278 -0
- package/src/pixelize.js +134 -0
- package/src/png.js +62 -0
- package/src/roles.js +169 -0
- package/src/routes.js +403 -0
- package/src/store.js +931 -0
- package/src/tools.js +1729 -0
- package/src/verify.js +121 -0
- package/src/watchdog.js +164 -0
- package/templates/release.md +44 -0
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 0.1.0
|
|
4
|
+
|
|
5
|
+
- Первый публичный релиз: доска задач, карточка задачи, офис, гейты, git, бюджет, роли.
|
|
6
|
+
- Корректировки, вопросы, служебные записки, аудит.
|
|
7
|
+
- Сторож входящих данных и антизалипание.
|
|
8
|
+
- Пауза (снимает только человек), мягкая остановка.
|
|
9
|
+
- Пиксельный офис с чиби-спрайтами (16 вариантов).
|
|
10
|
+
- Релиз как штатная фаза (`dept_start release=true`, `templates/release.md`).
|
|
11
|
+
- Мультиязычный интерфейс (ru/en) — начальный набор строк.
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 dsh-department contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.en.md
ADDED
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# dsh-department — AI development department for DeepSeek Harness
|
|
2
|
+
|
|
3
|
+
A department of AI agents with a manager and specialists that takes a task from idea to release:
|
|
4
|
+
analysis → concept (human approval) → specification (human approval) → plan → per-stage
|
|
5
|
+
implementation with tests and independent review → commit, tag and push per stage.
|
|
6
|
+
|
|
7
|
+
## Features
|
|
8
|
+
|
|
9
|
+
- Task board, task card (documents, questions, audit, events, corrections, roles, budget, git).
|
|
10
|
+
- Human gates: only a human approves concept and spec; memos and corrections come back to the manager.
|
|
11
|
+
- Gates per stage: tests + independent review; retries; backlog for out-of-scope work.
|
|
12
|
+
- Git discipline: one branch per task, commit + tag + push per stage.
|
|
13
|
+
- Budget tracking, roles and limits, pause/resume (only a human can resume).
|
|
14
|
+
- Watchdog: wakes the manager on new human input or when a task stalls.
|
|
15
|
+
- Pixel office: employees walk, work, rest; sprites reflect real agent activity.
|
|
16
|
+
- Release phase: `dept_start release=true` seeds the release checklist (package, docs, QA, tag).
|
|
17
|
+
|
|
18
|
+
## Install
|
|
19
|
+
|
|
20
|
+
Requires DeepSeek Harness >= 0.2.0 and Node >= 24.9.
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
dsh plugin --profile web add dsh-department
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
or from a local package:
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
dsh plugin --profile web add /path/dsh-department-0.1.0.tgz
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Restart DSH, open the department panel.
|
|
33
|
+
|
|
34
|
+
## Quick start
|
|
35
|
+
|
|
36
|
+
1. In a project chat: `dept_start` with `root`, `taskId`, `title`, `brief`.
|
|
37
|
+
2. Manager runs analysis and writes concept/spec; approve them in the task card.
|
|
38
|
+
3. Team executes the plan stage by stage; each stage ends with tests, review, `dept_verify`, `dept_commit`.
|
|
39
|
+
4. Release: `dept_start release=true` (or a separate release task).
|
|
40
|
+
|
|
41
|
+
## Docs
|
|
42
|
+
|
|
43
|
+
- `README.md` — full docs (Russian).
|
|
44
|
+
- `docs/I18N.md` — localization.
|
|
45
|
+
- `docs/RELEASE.md` — release checklist.
|
|
46
|
+
- `templates/release.md` — release task template.
|
|
47
|
+
|
|
48
|
+
## License
|
|
49
|
+
|
|
50
|
+
MIT.
|
package/README.md
CHANGED
|
@@ -1,3 +1,256 @@
|
|
|
1
|
-
#
|
|
1
|
+
# dsh-department — ИИ-отдел разработки для DeepSeek Harness
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Плагин превращает DeepSeek Harness в **отдел разработки**: задача проходит анализ →
|
|
4
|
+
концепцию → ТЗ → план → этапы, а внутри этапа — реализацию, тесты, независимое ревью и
|
|
5
|
+
коммит с тегом. Человек утверждает только концепцию и ТЗ, остальное отдел решает сам
|
|
6
|
+
по политике автономии.
|
|
7
|
+
|
|
8
|
+
## Возможности
|
|
9
|
+
|
|
10
|
+
- **Доска задач** по всем проектам: стадия, прогресс, гейты, последнее событие.
|
|
11
|
+
- **Карточка задачи** на вкладках: обзор, документы, вопросы, аудит, события, git;
|
|
12
|
+
кнопки утверждения, ответы на вопросы, поправки к ТЗ.
|
|
13
|
+
- **Офис отдела**: кто работает, за каким столом, что делает; клик — проект, задача,
|
|
14
|
+
файлы и история действий.
|
|
15
|
+
- **Схема проекта**: файлы и связи импортов по группам (папкам), drill-down до файла.
|
|
16
|
+
- **Бюджет**: расход токенов по сессиям, стоимость по ценам за 1M, лимит задачи.
|
|
17
|
+
- **Отчётность**: `dept_report` — этап, гейты, кто чем занят, открытые вопросы.
|
|
18
|
+
- **Вопросы к человеку** (`dept_ask` / `dept_answer`) — отдел не останавливается.
|
|
19
|
+
- **Поправки ТЗ** (`dept_amend`): с подписью человека или автономно (с лимитом).
|
|
20
|
+
- **Повторы по циклу** «данные → анализ → план → изменения → тесты»; повтор без анализа
|
|
21
|
+
блокируется, повторяющийся провал переводит этап в `blocked`.
|
|
22
|
+
- **Git**: коммит этапа, тег, push ветки и тегов; коммит заблокирован без свежих гейтов.
|
|
23
|
+
|
|
24
|
+
## Установка
|
|
25
|
+
|
|
26
|
+
Плагин ставится в профиль DSH как локальный (`link:`) или из репозитория:
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
dsh plugin add link:/path/to/dsh-department
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Затем включите bundle `dsh-department` в менеджере плагинов и перезагрузите вкладку.
|
|
33
|
+
В сайдбаре появится «ИИ-отдел», в основном окне — доска, офис и схема.
|
|
34
|
+
|
|
35
|
+
## Инструменты модели
|
|
36
|
+
|
|
37
|
+
| Инструмент | Назначение |
|
|
38
|
+
|---|---|
|
|
39
|
+
| `dept_start` | создать задачу: состояние, ветка, task.md |
|
|
40
|
+
| `dept_status` | состояние задачи и сводка |
|
|
41
|
+
| `dept_stage` | переход стадии (кроме утверждений) |
|
|
42
|
+
| `dept_approve` | утверждение концепции/ТЗ человеком |
|
|
43
|
+
| `dept_gate` | гейт тестов (exit code) или ревью (PASS/FAIL) |
|
|
44
|
+
| `dept_verify` | аудит: состояние ↔ артефакты ↔ git |
|
|
45
|
+
| `dept_commit` | коммит этапа, тег, push |
|
|
46
|
+
| `dept_amend` | поправка к документу (подпись человека или `autonomous`) |
|
|
47
|
+
| `dept_ask` | вопрос человеку без остановки работы |
|
|
48
|
+
| `dept_answer` | ответ человека на вопрос |
|
|
49
|
+
| `dept_report` | отчёт о состоянии отдела |
|
|
50
|
+
| `dept_health` | «жив ли отдел»: работает / стоит / ждёт человека / готов к коммиту |
|
|
51
|
+
| `dept_modules` | план модулей и владение файлами для параллельной работы |
|
|
52
|
+
| `dept_art` | нарисовать пиксельный спрайт и сохранить PNG |
|
|
53
|
+
| `dept_pixelize` | PNG/JPEG → пиксельная сетка + палитра + спрайт (для перерисовки по референсу) |
|
|
54
|
+
| `dept_compose` | собрать большое PNG из маленьких спрайтов (холст, фон, слои) |
|
|
55
|
+
| `dept_roles` | роли и модели (researcher, designer, artist, senior-coder, supervisor, beta-tester, ...) |
|
|
56
|
+
| `dept_bug` | баг-репорт бета-тестера (шаги, ожидаемое/фактическое, критичность) |
|
|
57
|
+
| `dept_browse` | браузер: открыть localhost/file, клики, ввод, скриншот в evidence |
|
|
58
|
+
| `dept_gui` | нативная программа: команда, env, таймаут, вывод, скриншот через хук/команду |
|
|
59
|
+
|
|
60
|
+
## HTTP API
|
|
61
|
+
|
|
62
|
+
| Маршрут | Метод | Назначение |
|
|
63
|
+
|---|---|---|
|
|
64
|
+
| `/api/department/tasks` | GET | задачи по проектам |
|
|
65
|
+
| `/api/department/task?root=&taskId=` | GET | карточка задачи |
|
|
66
|
+
| `/api/department/activity` | GET | живая активность агентов |
|
|
67
|
+
| `/api/department/approve` | POST | утвердить документ |
|
|
68
|
+
| `/api/department/answer` | POST | ответить на вопрос |
|
|
69
|
+
| `/api/department/amend` | POST | подписать поправку |
|
|
70
|
+
| `/api/department/budget?root=&taskId=` | GET/POST | бюджет и цены |
|
|
71
|
+
| `/api/department/blueprint?root=` | GET | схема проекта |
|
|
72
|
+
| `/api/department/asset?name=` | GET | ассеты офиса |
|
|
73
|
+
|
|
74
|
+
## Правила процесса
|
|
75
|
+
|
|
76
|
+
1. Этапы: `analysis → concept → concept_review → spec → spec_review → executing → done`.
|
|
77
|
+
2. Утверждения — только человеком (`dept_approve`), стадия двигается только через них.
|
|
78
|
+
3. Каждый этап закрывается коммитом с тегом `stage-N`; тег пушится вместе с веткой.
|
|
79
|
+
4. Гейты сбрасываются после коммита: pass предыдущего этапа не переезжает.
|
|
80
|
+
5. Провал тестов пишет `stages/NN/failure.md`; повтор запрещён, пока не заполнены
|
|
81
|
+
«Анализ» и «План».
|
|
82
|
+
6. Автономные поправки — не более 5 на задачу, дальше эскалация человеку.
|
|
83
|
+
|
|
84
|
+
## Совместная работа над концепцией и ТЗ
|
|
85
|
+
|
|
86
|
+
- Каждый специалист пишет свой раздел через `dept_section` (дизайнер — стиль,
|
|
87
|
+
художник — что рисуем, исследователь — данные и статистика, тестер — стратегия
|
|
88
|
+
проверки, архитектор — решения, аналитик — требования).
|
|
89
|
+
- Спорные решения архитектор оформляет как идеи (`dept_ideas`): 2–3 варианта.
|
|
90
|
+
- Специалисты рецензируют идеи (`dept_critique`): `approve`/`reject` и severity.
|
|
91
|
+
Жёсткое отклонение (`high`) убивает идею; два одобрения без жёсткой критики
|
|
92
|
+
принимают её. Отклонённую идею в работу не берут — архитектор предлагает новую.
|
|
93
|
+
- Исследователь может собирать статистику и факты в интернете.
|
|
94
|
+
|
|
95
|
+
## Автономность (цель вместо таймера)
|
|
96
|
+
|
|
97
|
+
- Руководитель создаёт цель: «довести задачу до done по plan.md» и не закрывает её
|
|
98
|
+
до конца. DSH сам гоняет раунды — таймер не нужен.
|
|
99
|
+
- Каждый раунд: `dept_health` → если `stalled`, найти причину и позвать специалиста:
|
|
100
|
+
данные — researcher, визуал — designer, картинки — artist, конфликт — supervisor,
|
|
101
|
+
архитектура — architect, сборочные правки — senior-coder.
|
|
102
|
+
- `waiting_human` не останавливает: решение принимает команда, записка ждёт человека.
|
|
103
|
+
- Защита от пустых раундов: если 2–3 раунда нет новых событий — зафиксировать
|
|
104
|
+
`blocked` и служебную записку, а не крутиться.
|
|
105
|
+
- Когда задача done — перейти к следующей; когда закрыты все — вечеринка (баннер в офисе).
|
|
106
|
+
|
|
107
|
+
## Автономность
|
|
108
|
+
|
|
109
|
+
- Руководитель вызывает `dept_health` после каждого шага и не останавливается:
|
|
110
|
+
`stalled` → следующий шаг плана, `waiting_human` → решает тактически сам,
|
|
111
|
+
`ready_to_commit` → проверка и коммит.
|
|
112
|
+
- Для длинных задач создаётся цель (goal), чтобы раунды шли без участия человека.
|
|
113
|
+
- `supervisor` анализирует застой и решает так, как решил бы заказчик.
|
|
114
|
+
- `researcher` ищет в интернете, `designer` подбирает визуал, `artist` рисует через `dept_art`.
|
|
115
|
+
- Параллельная работа: `dept_modules` раздаёт файлы модулям, кодеры не пересекаются,
|
|
116
|
+
`senior-coder` собирает и назначает доработки.
|
|
117
|
+
|
|
118
|
+
## Тестирование
|
|
119
|
+
|
|
120
|
+
- **Тестер** — автоматические проверки: тесты, инварианты, exit code. Это гейт этапа.
|
|
121
|
+
- **Бета-тестер** — играет/работает как пользователь: проходит сценарии, ловит
|
|
122
|
+
непонятные места, сломанные потоки, визуальные баги; пишет баг-репорт через
|
|
123
|
+
`dept_bug` (шаги, ожидаемое/фактическое, критичность, доказательство).
|
|
124
|
+
Для игры/интерфейса использует `dept_browse`: открывает страницу, кликает,
|
|
125
|
+
вводит и прикладывает скриншот к багрепорту.
|
|
126
|
+
- Перед релизом руководитель запускает бета-тест и разбирает баги: критичные —
|
|
127
|
+
в работу, остальные — в backlog.
|
|
128
|
+
|
|
129
|
+
### Нативные приложения (C++/Qt)
|
|
130
|
+
|
|
131
|
+
- `dept_gui` запускает программу с аргументами/env и таймаутом, перехватывает вывод.
|
|
132
|
+
- Скриншот: либо приложение само сохраняет кадр по флагу (`--screenshot file.png`,
|
|
133
|
+
`QWidget::grab()` / `QQuickWindow::grabWindow()`), либо внешняя команда
|
|
134
|
+
(`import -window root shot.png` под Xvfb).
|
|
135
|
+
- Рекомендуемый путь для Qt: тестовый хук `--scenario`/`--selftest`, который проходит
|
|
136
|
+
сценарий и сохраняет скриншоты; тогда бета-тест детерминирован и работает в CI.
|
|
137
|
+
- Интерактивная GUI-автоматизация (клики мышью) требует Xvfb/xdotool; в текущем
|
|
138
|
+
окружении их нет, поэтому ставка на хуки приложения и Qt Test.
|
|
139
|
+
|
|
140
|
+
## Подготовка к релизу (штатная фаза)
|
|
141
|
+
|
|
142
|
+
Офис делает не только продукт, но и его выпуск. Релиз — не разовая просьба, а фаза после `done`:
|
|
143
|
+
|
|
144
|
+
- `dept_start release=true` — бриф задачи получает шаблон `templates/release.md`
|
|
145
|
+
(пакет, документация пользователя, QA-чек-лист, changelog, версия, тег, передача);
|
|
146
|
+
- артефакт: `release/<продукт>-<версия>/` + архив `.zip`;
|
|
147
|
+
- документация: `README.md` (запуск, управление), `MANUAL-QA.md` (ручное тестирование),
|
|
148
|
+
`CHANGELOG.md`, известные ограничения;
|
|
149
|
+
- проверка: тесты проекта, `dept_verify`, бета-тест по чек-листу (`dept_bug`);
|
|
150
|
+
- фиксация: `dept_commit` с тегом `v<версия>`, тег в remote;
|
|
151
|
+
- отчёт: где забрать, как запустить, что проверять руками.
|
|
152
|
+
|
|
153
|
+
Критерий приёмки релиза: человек забирает артефакт и запускает без подсказок;
|
|
154
|
+
документация отвечает на «как запустить», «что умеет», «что ограничено».
|
|
155
|
+
|
|
156
|
+
## Библиотека документов и журнал событий
|
|
157
|
+
|
|
158
|
+
- Вкладка «Документы» — как почта: слева список документов (поиск по названию,
|
|
159
|
+
фильтр по типу, сортировка по дате), справа содержимое.
|
|
160
|
+
- Типы: служебная записка, отчёт этапа, ревью, баг-репорт, раздел специалиста,
|
|
161
|
+
план переработки, ТЗ, концепция, план, бэклог.
|
|
162
|
+
- Вкладка «События» — список слева, подробности выбранного события справа.
|
|
163
|
+
- Markdown в документах отображается как разметка: заголовки, списки, таблицы,
|
|
164
|
+
inline-код и блоки кода с подсветкой (JS/TS/C++/Python-ключевые слова).
|
|
165
|
+
- Служебные записки, ждущие решения, помечены «ТРЕБУЕТ РЕШЕНИЯ» и подняты наверх
|
|
166
|
+
списка; на доске у задачи бейдж «✍ N», в офисе — жёлтый маркер над руководителем,
|
|
167
|
+
в шапке карточки — счётчик записок.
|
|
168
|
+
|
|
169
|
+
## Цели (goal)
|
|
170
|
+
|
|
171
|
+
- Перед `update_goal` всегда вызывай `get_goal` и используй актуальную ревизию.
|
|
172
|
+
- Ошибка `stale goal ref` значит, что ревизия уже сменилась: перечитай `get_goal`
|
|
173
|
+
и повтори один раз с новой ревизией — не угадывай.
|
|
174
|
+
- Пауза отдела не ставит цель на паузу: цель живёт отдельно (это DSH).
|
|
175
|
+
|
|
176
|
+
## Пауза и возобновление
|
|
177
|
+
|
|
178
|
+
- `dept_pause` (или кнопка в карточке) — задача встаёт на паузу: гейты, коммит,
|
|
179
|
+
правки блокируются, токены не тратятся, состояние остаётся на диске.
|
|
180
|
+
- Сторож не будит задачу на паузе.
|
|
181
|
+
- `paused=false` (подпись человека) — работа продолжается с того же места,
|
|
182
|
+
в том числе после выключения/включения сервера.
|
|
183
|
+
- В офисе пауза видна: баннер «отдел на паузе» и руководитель сидит в комнате отдыха.
|
|
184
|
+
|
|
185
|
+
## Сторож входящих данных
|
|
186
|
+
|
|
187
|
+
- Каждые 5 минут плагин проверяет задачи отделов: новые корректировки (`new`),
|
|
188
|
+
ответы на вопросы (`answered`), замечания к запискам (`changes_requested`).
|
|
189
|
+
- Если появились новые данные — собирает пакет и будит руководителя (`followup`),
|
|
190
|
+
один раз на каждый новый элемент; повторно то же самое не присылает.
|
|
191
|
+
- Руководитель занят — сторож подождёт следующей проверки.
|
|
192
|
+
- **Антизалипание**: если задача активна (не paused/done/blocked), агент простаивает,
|
|
193
|
+
а последнее событие старше 15 минут — сторож будит руководителя подсказкой
|
|
194
|
+
(dept_verify/commit или следующий шаг). Не чаще одного раза в 30 минут на задачу.
|
|
195
|
+
|
|
196
|
+
## Корректировки
|
|
197
|
+
|
|
198
|
+
- Вкладка «Корректировка» — письмо руководителю: к чему относится (концепция/ТЗ/план/
|
|
199
|
+
код/данные/интерфейс), тема и текст. Сохраняется в истории корректировок.
|
|
200
|
+
- `dept_correction` — руководитель видит список, берёт в работу (`in_progress`),
|
|
201
|
+
собирает специалистов на анализ и закрывает (`done`) с итогом.
|
|
202
|
+
- По корректировкам дорабатываются концепция, ТЗ и план (`dept_amend`, `dept_section`).
|
|
203
|
+
|
|
204
|
+
## Вопросы и служебные записки
|
|
205
|
+
|
|
206
|
+
Вопрос к человеку не останавливает работу:
|
|
207
|
+
|
|
208
|
+
1. `dept_ask` — вопрос записан, отдел продолжает.
|
|
209
|
+
2. `dept_propose` — супервайзер предлагает варианты решения.
|
|
210
|
+
3. `dept_critique` — специалисты критикуют; принятое решение фиксируется.
|
|
211
|
+
4. `dept_memo` — служебная записка: вопрос, варианты, критика, решение команды
|
|
212
|
+
(файл `docs/department/<task>/memos/<question>.md`).
|
|
213
|
+
5. `dept_review` — человек утверждает (`approve`) или пишет замечания (`changes`).
|
|
214
|
+
6. `dept_rework` — архитектор готовит план переработки по замечаниям
|
|
215
|
+
(`docs/department/<task>/rework/<question>.md`).
|
|
216
|
+
|
|
217
|
+
## Мультипроект
|
|
218
|
+
|
|
219
|
+
- Вкладка «Проекты» — агрегаты по корням: задачи, стадии, бюджет, последнее событие.
|
|
220
|
+
- Каждый корень — отдельный отдел: задачи создаются через `dept_start root=...`,
|
|
221
|
+
доска показывает все проекты, фильтр — по проекту.
|
|
222
|
+
- Для параллельной работы внутри проекта: `dept_modules` (владение файлами) +
|
|
223
|
+
`dept_worktree` (изолированные каталоги на модуль), слияние — сеньор-кодер.
|
|
224
|
+
- Лимит одновременных кодеров — `maxInstances` у роли.
|
|
225
|
+
|
|
226
|
+
## Художник и референсы
|
|
227
|
+
|
|
228
|
+
- `dept_art` рисует по сетке символов: вход — `rows` (символ = пиксель) и `palette`
|
|
229
|
+
(символ → #rrggbb), выход — PNG (RGBA), масштаб 1–16.
|
|
230
|
+
- `dept_pixelize` берёт PNG/JPEG/WebP, уменьшает до сетки (4–96), квантует в палитру
|
|
231
|
+
(2–64 цвета или заданную), сохраняет PNG и возвращает `rows` + `palette` —
|
|
232
|
+
художник правит пиксели вручную, чтобы получить похожий, но свой спрайт.
|
|
233
|
+
- Референс — для стиля (палитра, пропорции), не для копирования чужой графики.
|
|
234
|
+
|
|
235
|
+
### Художник работает не спеша
|
|
236
|
+
|
|
237
|
+
- Скорость не критерий: качество важнее. Художник рисует по частям:
|
|
238
|
+
референс/палитра → базовые формы → детали → проверка → композиция.
|
|
239
|
+
- Каждый шаг — отдельный файл-чекпоинт (`assets/...png`), его можно пересмотреть.
|
|
240
|
+
- Большая картинка не рисуется одним куском: маленькие спрайты + `dept_compose`.
|
|
241
|
+
- Роль: `reasoning: high`, до 6 попыток; руководитель дробит задачу на элементы,
|
|
242
|
+
а не даёт художнику «нарисуй всё».
|
|
243
|
+
|
|
244
|
+
## Ограничения
|
|
245
|
+
|
|
246
|
+
- Офис и схема — визуализация по данным сессий; арт простой.
|
|
247
|
+
- Blueprint строит только статические импорты (JS/TS/C/C++/Python).
|
|
248
|
+
- У каждой роли лимит одновременных экземпляров (`maxInstances`), у кодера по умолчанию 2:
|
|
249
|
+
руководитель не может запускать больше кодеров, чем указано.
|
|
250
|
+
- Роли можно включать/выключать (кроме manager/coder/tester); `beta-tester`
|
|
251
|
+
по умолчанию выключен — запуск приложений и поток скриншотов дороги по ресурсам.
|
|
252
|
+
- Бюджет считает usage, который отдают адаптеры модели; цены задаются вручную.
|
|
253
|
+
|
|
254
|
+
## Лицензия
|
|
255
|
+
|
|
256
|
+
MIT. Ассеты офиса (папка `assets/`) — собственные и/или CC0; сторонние паки не входят.
|
|
Binary file
|
|
Binary file
|
package/assets/chair.png
ADDED
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
@@ -0,0 +1,257 @@
|
|
|
1
|
+
{
|
|
2
|
+
"tile": 16,
|
|
3
|
+
"sprites": {
|
|
4
|
+
"floor": {
|
|
5
|
+
"x": 2,
|
|
6
|
+
"y": 2,
|
|
7
|
+
"w": 16,
|
|
8
|
+
"h": 16
|
|
9
|
+
},
|
|
10
|
+
"wall": {
|
|
11
|
+
"x": 20,
|
|
12
|
+
"y": 2,
|
|
13
|
+
"w": 16,
|
|
14
|
+
"h": 16
|
|
15
|
+
},
|
|
16
|
+
"desk": {
|
|
17
|
+
"x": 38,
|
|
18
|
+
"y": 2,
|
|
19
|
+
"w": 32,
|
|
20
|
+
"h": 12
|
|
21
|
+
},
|
|
22
|
+
"chair": {
|
|
23
|
+
"x": 72,
|
|
24
|
+
"y": 2,
|
|
25
|
+
"w": 12,
|
|
26
|
+
"h": 11
|
|
27
|
+
},
|
|
28
|
+
"monitor": {
|
|
29
|
+
"x": 86,
|
|
30
|
+
"y": 2,
|
|
31
|
+
"w": 14,
|
|
32
|
+
"h": 12
|
|
33
|
+
},
|
|
34
|
+
"plant": {
|
|
35
|
+
"x": 102,
|
|
36
|
+
"y": 2,
|
|
37
|
+
"w": 16,
|
|
38
|
+
"h": 15
|
|
39
|
+
},
|
|
40
|
+
"plant2": {
|
|
41
|
+
"x": 120,
|
|
42
|
+
"y": 2,
|
|
43
|
+
"w": 16,
|
|
44
|
+
"h": 14
|
|
45
|
+
},
|
|
46
|
+
"cactus": {
|
|
47
|
+
"x": 138,
|
|
48
|
+
"y": 2,
|
|
49
|
+
"w": 16,
|
|
50
|
+
"h": 12
|
|
51
|
+
},
|
|
52
|
+
"flower": {
|
|
53
|
+
"x": 156,
|
|
54
|
+
"y": 2,
|
|
55
|
+
"w": 16,
|
|
56
|
+
"h": 13
|
|
57
|
+
},
|
|
58
|
+
"cooler": {
|
|
59
|
+
"x": 174,
|
|
60
|
+
"y": 2,
|
|
61
|
+
"w": 12,
|
|
62
|
+
"h": 14
|
|
63
|
+
},
|
|
64
|
+
"coffee": {
|
|
65
|
+
"x": 188,
|
|
66
|
+
"y": 2,
|
|
67
|
+
"w": 12,
|
|
68
|
+
"h": 11
|
|
69
|
+
},
|
|
70
|
+
"sofa": {
|
|
71
|
+
"x": 202,
|
|
72
|
+
"y": 2,
|
|
73
|
+
"w": 32,
|
|
74
|
+
"h": 9
|
|
75
|
+
},
|
|
76
|
+
"table": {
|
|
77
|
+
"x": 2,
|
|
78
|
+
"y": 20,
|
|
79
|
+
"w": 24,
|
|
80
|
+
"h": 7
|
|
81
|
+
},
|
|
82
|
+
"books": {
|
|
83
|
+
"x": 28,
|
|
84
|
+
"y": 20,
|
|
85
|
+
"w": 8,
|
|
86
|
+
"h": 6
|
|
87
|
+
},
|
|
88
|
+
"papers": {
|
|
89
|
+
"x": 38,
|
|
90
|
+
"y": 20,
|
|
91
|
+
"w": 9,
|
|
92
|
+
"h": 7
|
|
93
|
+
},
|
|
94
|
+
"mug": {
|
|
95
|
+
"x": 49,
|
|
96
|
+
"y": 20,
|
|
97
|
+
"w": 6,
|
|
98
|
+
"h": 5
|
|
99
|
+
},
|
|
100
|
+
"lamp": {
|
|
101
|
+
"x": 57,
|
|
102
|
+
"y": 20,
|
|
103
|
+
"w": 8,
|
|
104
|
+
"h": 8
|
|
105
|
+
},
|
|
106
|
+
"bin": {
|
|
107
|
+
"x": 67,
|
|
108
|
+
"y": 20,
|
|
109
|
+
"w": 8,
|
|
110
|
+
"h": 5
|
|
111
|
+
},
|
|
112
|
+
"board": {
|
|
113
|
+
"x": 77,
|
|
114
|
+
"y": 20,
|
|
115
|
+
"w": 21,
|
|
116
|
+
"h": 7
|
|
117
|
+
},
|
|
118
|
+
"window": {
|
|
119
|
+
"x": 100,
|
|
120
|
+
"y": 20,
|
|
121
|
+
"w": 16,
|
|
122
|
+
"h": 7
|
|
123
|
+
},
|
|
124
|
+
"door": {
|
|
125
|
+
"x": 118,
|
|
126
|
+
"y": 20,
|
|
127
|
+
"w": 8,
|
|
128
|
+
"h": 9
|
|
129
|
+
},
|
|
130
|
+
"rug": {
|
|
131
|
+
"x": 128,
|
|
132
|
+
"y": 20,
|
|
133
|
+
"w": 16,
|
|
134
|
+
"h": 5
|
|
135
|
+
},
|
|
136
|
+
"server": {
|
|
137
|
+
"x": 146,
|
|
138
|
+
"y": 20,
|
|
139
|
+
"w": 16,
|
|
140
|
+
"h": 7
|
|
141
|
+
},
|
|
142
|
+
"printer": {
|
|
143
|
+
"x": 164,
|
|
144
|
+
"y": 20,
|
|
145
|
+
"w": 16,
|
|
146
|
+
"h": 7
|
|
147
|
+
},
|
|
148
|
+
"clock": {
|
|
149
|
+
"x": 182,
|
|
150
|
+
"y": 20,
|
|
151
|
+
"w": 7,
|
|
152
|
+
"h": 6
|
|
153
|
+
},
|
|
154
|
+
"laptop": {
|
|
155
|
+
"x": 191,
|
|
156
|
+
"y": 20,
|
|
157
|
+
"w": 12,
|
|
158
|
+
"h": 6
|
|
159
|
+
},
|
|
160
|
+
"shelf": {
|
|
161
|
+
"x": 205,
|
|
162
|
+
"y": 20,
|
|
163
|
+
"w": 8,
|
|
164
|
+
"h": 8
|
|
165
|
+
},
|
|
166
|
+
"kettle": {
|
|
167
|
+
"x": 215,
|
|
168
|
+
"y": 20,
|
|
169
|
+
"w": 8,
|
|
170
|
+
"h": 7
|
|
171
|
+
},
|
|
172
|
+
"manager_stand": {
|
|
173
|
+
"x": 225,
|
|
174
|
+
"y": 20,
|
|
175
|
+
"w": 12,
|
|
176
|
+
"h": 18
|
|
177
|
+
},
|
|
178
|
+
"manager_sit": {
|
|
179
|
+
"x": 239,
|
|
180
|
+
"y": 20,
|
|
181
|
+
"w": 12,
|
|
182
|
+
"h": 14
|
|
183
|
+
},
|
|
184
|
+
"coder_stand": {
|
|
185
|
+
"x": 2,
|
|
186
|
+
"y": 40,
|
|
187
|
+
"w": 12,
|
|
188
|
+
"h": 18
|
|
189
|
+
},
|
|
190
|
+
"coder_sit": {
|
|
191
|
+
"x": 16,
|
|
192
|
+
"y": 40,
|
|
193
|
+
"w": 12,
|
|
194
|
+
"h": 14
|
|
195
|
+
},
|
|
196
|
+
"reviewer_stand": {
|
|
197
|
+
"x": 30,
|
|
198
|
+
"y": 40,
|
|
199
|
+
"w": 12,
|
|
200
|
+
"h": 18
|
|
201
|
+
},
|
|
202
|
+
"reviewer_sit": {
|
|
203
|
+
"x": 44,
|
|
204
|
+
"y": 40,
|
|
205
|
+
"w": 12,
|
|
206
|
+
"h": 14
|
|
207
|
+
},
|
|
208
|
+
"tester_stand": {
|
|
209
|
+
"x": 58,
|
|
210
|
+
"y": 40,
|
|
211
|
+
"w": 12,
|
|
212
|
+
"h": 18
|
|
213
|
+
},
|
|
214
|
+
"tester_sit": {
|
|
215
|
+
"x": 72,
|
|
216
|
+
"y": 40,
|
|
217
|
+
"w": 12,
|
|
218
|
+
"h": 14
|
|
219
|
+
},
|
|
220
|
+
"analyst_stand": {
|
|
221
|
+
"x": 86,
|
|
222
|
+
"y": 40,
|
|
223
|
+
"w": 12,
|
|
224
|
+
"h": 18
|
|
225
|
+
},
|
|
226
|
+
"analyst_sit": {
|
|
227
|
+
"x": 100,
|
|
228
|
+
"y": 40,
|
|
229
|
+
"w": 12,
|
|
230
|
+
"h": 14
|
|
231
|
+
},
|
|
232
|
+
"archivist_stand": {
|
|
233
|
+
"x": 114,
|
|
234
|
+
"y": 40,
|
|
235
|
+
"w": 12,
|
|
236
|
+
"h": 18
|
|
237
|
+
},
|
|
238
|
+
"archivist_sit": {
|
|
239
|
+
"x": 128,
|
|
240
|
+
"y": 40,
|
|
241
|
+
"w": 12,
|
|
242
|
+
"h": 14
|
|
243
|
+
},
|
|
244
|
+
"instrumenter_stand": {
|
|
245
|
+
"x": 142,
|
|
246
|
+
"y": 40,
|
|
247
|
+
"w": 12,
|
|
248
|
+
"h": 18
|
|
249
|
+
},
|
|
250
|
+
"instrumenter_sit": {
|
|
251
|
+
"x": 156,
|
|
252
|
+
"y": 40,
|
|
253
|
+
"w": 12,
|
|
254
|
+
"h": 14
|
|
255
|
+
}
|
|
256
|
+
}
|
|
257
|
+
}
|
|
Binary file
|
|
Binary file
|