58 lines
4.8 KiB
Markdown
58 lines
4.8 KiB
Markdown
# Luma Web — основа агентной разработки
|
|
|
|
Переносимый каталог планирования и workflow для создания Web-клиента Luma. **Готового мессенджера здесь пока нет.** Будущие задачи отмечены todo, исходные clear-спецификации сохранены без изменения байтов. Framework и XMPP/OMEMO библиотеки выбираются через начальные ADR и проверку совместимости.
|
|
|
|
## Быстрый старт
|
|
|
|
Для инструмента нужен Python 3.10+; сторонние Python-пакеты не нужны.
|
|
|
|
```sh
|
|
python3 scripts/tasks.py validate
|
|
python3 -m unittest discover -s tests/tooling -v
|
|
python3 scripts/tasks.py status
|
|
python3 scripts/tasks.py next --role orchestrator
|
|
```
|
|
|
|
Передать агенту `master_prompt.md`; role/id можно добавить в пользовательское поручение. После blocker прежний agent id не используется: следующий процесс назначает runner.
|
|
|
|
```sh
|
|
python3 scripts/tasks.py claim S00-001 --agent local-architect-1 --role orchestrator
|
|
python3 scripts/tasks.py packet S00-001 --agent local-architect-1 --output state/context-S00-001.md
|
|
```
|
|
|
|
Оператор выбирается из 12 файлов ролей; маленькой модели не нужно читать весь tasks.json. Ограниченный context packet содержит максимум 48 000 символов.
|
|
|
|
Один рабочий цикл — одна задача, её focused checks, evidence, handoff и независимое review. Все команды запускаются из корня этой основы; script сам разрешает пути относительно своего расположения.
|
|
|
|
## Навигация
|
|
|
|
- `master_prompt.md`, `AGENTS.md` — старт/продолжение работы.
|
|
- `specs/tz_clear.md`, `specs/uikit_clear.md` — оригиналы целевых требований.
|
|
- `planning/ROADMAP.md` — этапы и gates.
|
|
- `planning/TASK_MATRIX.md`, `planning/task_matrix.csv` — задачи, операторы, зависимости, статусы.
|
|
- `planning/TRACEABILITY.md` — применимость требований Web и связь с задачами.
|
|
- `planning/tasks/<ID>.md` — подробная атомарная карточка.
|
|
- `roles/` — полномочия и инструкции операторов.
|
|
- `docs/` — architecture/profile/contracts/workflow/testing/security и `BOOTSTRAP_PROMPTS.md` с готовыми поручениями.
|
|
- `state/` — статусы, evidence, handoffs; не secrets.
|
|
- `scripts/tasks.py` — dependency-free task CLI.
|
|
- `tests/tooling/` — тесты инструмента и целостности.
|
|
- `src/`, `services/`, `infra/` — будущая реализация; пояснения внутри директорий.
|
|
|
|
## Перенос
|
|
|
|
Можно скопировать весь каталог в отдельный репозиторий, включая `.github`, `.gitignore`, `.editorconfig` и текущий state. Git metadata родительского репозитория не требуется. Внутри исходного Apple-репозитория корневая `.github` этой основы не запускается автоматически; workflow начнёт работать после переноса `.github` в корень отдельного Web-репозитория.
|
|
|
|
`make check` проверяет только подготовленную основу. App build/test pipeline будет подключён после принятия стека. Нельзя считать готовые документацию/матрицу выполненными продуктовыми задачами.
|
|
|
|
## Автоматический режим
|
|
|
|
Один раз заполнить `runner.local.json` по `runner.example.json` командой своего tool-capable agent CLI, затем:
|
|
|
|
```sh
|
|
python3 scripts/runner.py --dry-run
|
|
python3 scripts/runner.py --config runner.local.json
|
|
```
|
|
|
|
Каждый запуск модели получает ровно одну задачу и fresh session. При blocker инструмент создаёт remediation и блокирует original; reporter заканчивает работу. Новый агент исправляет причину, другой проверяет, новый продолжает original. При необходимости внешнего input runner останавливается с конкретным запросом. Подробности — `docs/AUTOMATION.md`.
|