# Как этим пользоваться

Эта папка — заготовка, после которой ИИ-помощник (Codex или Claude Code) сможет написать
работающее приложение в W3DS. Программировать вам не нужно.

## Что вам понадобится

- компьютер;
- телефон с установленным **eID-кошельком** — тем же, которым вы входите в другие
  приложения W3DS;
- установленный **Codex** или **Claude Code**.

## Что делать — два действия

**1.** Запустите Codex или Claude Code и **дайте ему архив `w3ds-vibecoding.zip`**
(перетащите файл в окно или укажите на него).

**2.** Напишите ему три строчки — они лежат готовыми в файле `START.txt`, можно просто
скопировать:

> Распакуй архив w3ds-vibecoding.zip в текущую папку.
> Внутри найди файл PROMPT.md, прочитай его целиком и дальше работай строго по нему.
> Потом спроси меня, какое приложение мне нужно.

Всё. Дальше помощник разложит файлы сам, прочитает свою инструкцию и спросит вас,
что вам нужно. Отвечайте обычными словами:

> «Мне нужно приложение, где я веду список договоров: название, контрагент, дата,
> сумма. Я хочу входить туда своим eID, а часть договоров показывать бухгалтеру».

## Что будет происходить дальше

Помощник **три раза остановится и попросит вас что-то проверить**. Это не сбой, это
устроено специально: он не имеет права идти дальше, пока вы своими руками не убедились,
что предыдущее работает.

1. **Вы откроете адрес приложения на телефоне** и увидите его страницу.
2. **Вы войдёте двумя способами** — с компьютера по QR-коду и прямо с телефона.
3. **Вы сохраните что-нибудь, перезагрузите страницу и увидите сохранённое.**

И потом ещё раз — когда дойдёте до публикации на GitW3: там помощник будет диктовать,
на какую кнопку нажать.

**Отвечайте ему честно.** Если что-то не открылось, не заработало, выглядит не так —
так и напишите: «не открывается», «пустая страница», «на телефоне крутится и ничего».
Это самая полезная информация, которую вы можете дать. Не пытайтесь угадать причину —
просто опишите, что видите.

## Если помощник говорит «готово», а у вас не работает

Скажите ему об этом прямо и попросите проверить заново. В его инструкции прописано правило:
«сделано» имеет право звучать только после того, как вы это увидели. Напомните.

## Что в этой папке

| Файл | Зачем |
|---|---|
| `START.txt` | три строчки, которые вы отправляете помощнику |
| `PROMPT.md` | инструкция помощника — её читает он, не вы |
| `traps/01-public-address.md` | почему приложению нужен адрес в интернете с самого начала |
| `traps/02-eid-login.md` | почему вход по eID ломается у всех и как его починить |
| `traps/03-gitw3-step-by-step.md` | публикация приложения, по кнопкам |
| `reference/` | подробные правила работы с данными в W3DS |

Всё это читает помощник, а не вы. Открывать самому не нужно — но если захотите
понять, что происходит, написано обычным языком.