К основному содержанию
скилл CX Codex

flight-deck — скилл для Claude Code: статус долгой работы

Скилл flight-deck для Claude Code, который сохраняет ход долгой работы в файлах и на странице статуса. Запускается по просьбе показать прогресс или восстановить, на чём остановилась сессия.

MIT ★ 741 обновлён 2026-11-14

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add phuryn/product-engineering
/plugin install agent-harness@product-engineering
Открыть на GitHub

Что делает flight-deck

Скилл ведёт STATUS.md с текущим состоянием работы и LOG.md с решениями и их причинами. Он обновляет статус, когда его просят рассказать, что сделано и что дальше. Для владельца проекта создаёт отдельную страницу с короткой сводкой и вопросами, на которые нужен его ответ.

Если доступен Artifact tool, страница создаётся как artifact с базой данных; перед этим скилл использует assets/owner-page.html и references/owner-page.md. Если инструмента нет, вместо страницы используется OWNER.md. Работа разбивается на состояния: выполняется, в очереди, заблокирована, отложена или завершена. Запланированный проход без чата только проверяет указанную страницу и не публикует новую.

Какие задачи решает

  • сохранить текущий статус долгой работы
  • восстановить следующий шаг после перерыва или compaction
  • зафиксировать решения и причины в журнале
  • собрать сводку прогресса и вопросы для владельца проекта

Примеры запросов агенту

  • Покажи, где мы остановились и что сейчас выполняется.
  • Обнови статус проекта и перечисли следующие задачи.
  • Подготовь сводку прогресса и вопросы, на которые нужен ответ владельца.

Как установить flight-deck

1Через маркетплейс плагинов

/plugin marketplace add phuryn/product-engineering
/plugin install agent-harness@product-engineering

Команда ставит плагин agent-harness целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add phuryn/product-engineering --skill flight-deck -a claude-code

3Вручную: положить файлы

~/.claude/skills/flight-deck/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/flight-deck/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о flight-deck

Как установить flight-deck в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add phuryn/product-engineering, затем установите плагин командой /plugin install agent-harness@product-engineering.

Что делает flight-deck?

Скилл поддерживает актуальный статус долгой работы в STATUS.md, записывает решения в LOG.md и готовит страницу с прогрессом и вопросами владельцу проекта.

Какие файлы использует flight-deck для статуса?

Текущий статус хранится в STATUS.md, история решений — в LOG.md. Для страницы владельца используется Artifact tool с шаблоном assets/owner-page.html либо OWNER.md, если Artifact tool недоступен.

Исходный текст

SKILL.md · MIT
---
name: flight-deck
description: "'What's the status', 'where were we', a progress report or status deck; long work that must survive compaction: multi-hour runs, background jobs, waiting on a decision."
---

# Flight Deck — surviving your own context window

**Write state down where it cannot be summarized.** In a long session, tool output scrolls away and context becomes a plausible narrative with operational details sanded off. The work keeps running while your model of it goes stale. Then you re-run a paid job, report a number from memory, or forget that something is blocked.

**The flight deck is `STATUS.md`, `LOG.md` and the owner's page.** When the Artifact tool exists, build the page in the first pass as an artifact with a database (`capabilities: {db: {}}`). Use `assets/owner-page.html`, following `references/owner-page.md`; use `OWNER.md` only when the tool does not exist. A test run, or one with nothing for the owner to decide yet, still builds the page. It carries status too, and a test exercises it. A scheduled pass with no chat never builds or publishes a page; it checks the one its prompt names.

## The two files (per area, not per repo)

**Rewrite `STATUS.md` in place to describe only what is true now.** Never append to it, because a growing status file leaves the reader unsure which line is still true. Use these sections where they earn their place:

- **Put RESUME first, with the work's location and how to resume.** Name the repository or folder and branch, then the last few sessions that touched it. Give each a date and one-line summary, dropping the oldest. Resume by opening the agent in that folder and having it read `STATUS.md` first. Reopening an old session is the fallback, because its memory is stale.
- **List RUNNING NOW with process ids, log paths and each wait.** Say what each thing is waiting on.
- **Keep QUEUED in order so the next task needs no judgement.**
- **Name why each BLOCKED item is blocked and what unblocks it.**
- **List HELD work deliberately not shipped and who owes the decision.** The work is finished.
- **Put questions you cannot answer yourself under AWAITING <person>.**
- **Keep DONE to one line each, enough to prevent redoing it.**
- **Record EVIDENCE as measurements with their actual numbers.** See § Write down evidence, not just tasks.
- **List STANDING RULES a fresh reader would otherwise violate.**

**Use the same sections for work that isn't code.** `references/other-work.md` says how they map.

**Append decisions and their reasoning to `LOG.md`, never rewrite its history.** Include corrections and dead ends. Status answers "where are we"; the log answers "how did we get here, and what did we already rule out". Both are needed, in separate files.

**Optionally commit a how-it-works doc when the machinery is non-obvious.** Status and log are volatile; this durable doc belongs in version control and your routing file.

## The owner's page

**Give the owner a short status and only asks that need them.** `STATUS.md` and `LOG.md` are for you. The page serves someone who isn't watching the session, so they never need the transcript to find the status or what you need. They open it, answer, save, and you read the answers at your next check-in. It makes `STATUS.md`'s AWAITING section answerable. Without the Artifact tool, use `OWNER.md` with the same shape.

**Keep a proposal's or plan's open decisions on the proposal's page.** The owner's page links there and doesn't ask them; apply the `propose` skill, § 7.

**Before building it, open `references/owner-page.md` (the data, publishing, the loop) and `assets/owner-page.html` (the page you copy).**

**A progress report starts here.** Asked for "where we are", a status report, "what's done and what's next" or a progress deck, update `STATUS.md` and the owner's page first. Project the report from them; a deck is a view of the flight deck, never a separate account of the work.

### What is on it

**Project a short status from `STATUS.md`, rather than every detail.** A status block nobody reads to the end is no status.

- **Put the phase and milestones first, marking the current milestone.** For example, "3 of 5". Follow with at most three lines each of what was just built, what's in progress and what's next. Include how many things wait on the owner.
- **Several areas share one page with Overview and an area tab each.** Give each area a board of 5 to 10 key work items, separate from the owner's asks. See `references/owner-page.md` for the data and migration.
- **Ask only for a decision, a go or an owner-only task.** A go is for a one-way door. Never put status, receipts, finished work, or anything you could do yourself among the asks.
- **Each item carries everything needed to answer it.** Say what you need, where (the link, file or setting), why only they can, your preselected recommendation, and what happens after they answer. Never use a pointer to the chat, since it may be gone after a compaction.
- **Check every step against the product before it goes on the page.**
- **Never collect a secret.** Name the file or setting the key goes into.
- **A go typed on the page doesn't clear your harness's permission check for a one-way door.** The page asks; the go is typed in the chat.

### Reading and consuming answers

**Delete the item and answer once you have read the answer.** A gate stays until the go is typed in chat; a note on it deletes only the answer. Leave no reply on the page, no "settled" list, and nothing showing their feedback was processed. Work in this order:

1. **Record the decision before deleting the item and its answer.** Use the product's decision log, `STATUS.md` QUEUED for work it creates, and `LOG.md` for the why, with the answer's id and `at`. An answer whose id and `at` `LOG.md` already holds is not recorded or queued again.
2. **Delete the item and its answer in one write.** For a gate, delete only the answer; the gate stays until the go is typed in chat.
3. **Act only after recording the answer and deleting what should go.** On a gate, act only once the go is in chat.
4. **Confirm in chat, in one line.**

**Consume answers before acting, so answered items don't remain during work.** Acting first leaves them on the page for as long as the work takes.

**On a page with several areas, consume only your own area's answers.** Other areas' answers wait on the page for their own sessions.

**A run with no chat does steps 1 and 2 only.** This scheduled pass does none of the work and never passes a gate. Put its confirmation in `STATUS.md` for the next session to repeat in chat.

**Check at fixed points, because nothing notifies you when they save.** Check at each stage boundary, while a build or review runs, before ending a turn, after a compaction, and whenever they say they answered.

**An idle session with items waiting schedules its own check.** Use a cron or loop where the harness has one, rather than waiting for the next message. For hours when no session runs, a scheduled headless pass checks instead (`references/owner-page.md` § A scheduled check without a session).

**An answer given in chat closes its item too.** A gate closes only when the answer is the go.

**Make Save trustworthy.** The page says Save is what you read and that nothing notifies you. On first use, quote one saved answer back. Put the link in every chat message that mentions the page.

## The rule that makes it work

**Update `STATUS.md` on every state change.** Do it when a job starts, finishes, fails or gets published, a decision lands, or something becomes blocked. Not "at the end", not "when asked": the moment it changes. A status file that is 80% true is worse than none, because it is trusted.

**Keep status short enough to stay true.** If maintaining it is a burden, it is too detailed.

## Write down evidence, not just tasks

**Record measurements with their numbers and verdict, not the conclusion alone.** The highest-value lines are probe results, benchmark numbers, verdicts, costs, and "we tested X and it does not work". Losing task state costs a re-read; losing evidence costs money and credibility. You might re-run a paid experiment or restate a number from a summary and get it wrong.

## Where to put them

**Keep one pair per area of work, not per repository.** A repository with three unrelated efforts wants three pairs; three repositories serving one effort want one. The area is the unit someone would ask a status question about.

**Keep files needed after a restart outside scratchpads and system temp.** Status, logs, scripts, tools and cited evidence belong in the repository or another persistent working folder. Keep sensitive operator files uncommitted and protected there. Cross-link from the log to the status, and from long-lived docs to both, so a fresh reader can resume.

## Reading them after a compaction

**Read `STATUS.md` first, then skim the last few decisions in `LOG.md`.** Verify that a process listed as running is actually running.

**Do not trust the file over reality.** Reconcile, then fix the file. A stale status caught early is a small problem. Trusting it blindly is how you report a job finished when it crashed an hour ago.

## When NOT to use this

**Skip this for short sessions, single-shot tasks and one-context-window work.** The overhead is real and pointless there. Use it when a session will outlive its own memory. You can usually tell at the start from background jobs, queues, or a run measured in hours.

Each rule's origin, the case that taught it, is in `receipts.md` beside this file; read it when a rule's edge is unclear.

## How you can tell it worked

After a compaction, one read of the status board says what is running, what is blocked and on whom. Every line still matches what is on disk and what is running.

© Paweł Huryn · MIT · phuryn/product-engineering

Похожие скиллы

Каталог скиллов SKILL.md →
pricewin-flight-search PriceWin Скилл pricewin-flight-search ищет авиабилеты по базам Agoda, Trip.com и Traveloka в одну сторону или туда-обратно. Помогает сравнивать цены авиакомпаний и получать прямые ссылки на бронирование. CX Codex +1 10 600установок pp-flight-goat Matt Van Horn Скилл pp-flight-goat ищет цены Google Flights, дешёвые даты, маршруты Kayak и FlySoar без ключа API. Дополнительно — статусы рейсов через FlightAware AeroAPI. CX Codex +1 4 700установок flight dvdsgl Скилл flight открывает в терминале панель со списком рейсов и картой мест: рейс и место выбираются клавиатурой, результат уходит агенту. CX Codex +1 2установок flight-map-canvas официальный John Haugabook Плагин flight-map-canvas для GitHub Copilot, который открывает Google Maps с управлением как в авиасимуляторе. Агент отправляет полёт в любую точку и рассказывает, над чем работает. ★ 41 430звёзд репо pre-flight-discipline Rohit Ghumare Правило pre-flight-discipline заставляет агента проговаривать допущения, сужать задачу и проверять результат по шагам. Подходит для кода, где опасны лишние правки. CX Codex +1 ★ 2 966звёзд репо Flight Search arjunprabhulal MCP-сервер Flight Search ищет рейсы между аэропортами по кодам IATA через SerpApi. Поможет сравнить цену, длительность перелёта и пересадки для поездки туда или туда-обратно. CX Codex +1 ★ 44звёзд репо

Из того же набора51

Весь набор →
document-app Скилл document-app для Claude Code, который описывает устройство приложения по его коду или сверяет документацию с реализацией. Запускается по просьбе документировать приложение или проверить точность его документов. CX Codex +1 ★ 741звёзд репо uptime-monitoring Скилл uptime-monitoring для Claude Code настраивает внешние проверки доступности приложения и оповещения. Запускается при публикации приложения, добавлении /health или cron-задачи и запросе о мониторинге. CX Codex +1 ★ 741звёзд репо performance-audit-static Скилл performance-audit-static для Claude Code проверяет производительность кода статически: ищет N+1-запросы, лишнюю загрузку данных, проблемы с индексами и кешированием. Запускается по запросу на аудит производительности. CX Codex +1 ★ 741звёзд репо legal-pages Скилл legal-pages для Claude Code помогает подготовить юридические страницы по фактическому поведению приложения. Запускается при создании продукта и изменениях в обработке данных, cookies или провайдерах. CX Codex +1 ★ 741звёзд репо environments Скилл environments для Claude Code разделяет настройки разработки и production, а также описывает работу с секретами и миграциями. Агент подключает его при настройке окружения, добавлении переменной или разборе утечки ключа. CX Codex +1 ★ 741звёзд репо embedded-agents-agent-sdk Скилл embedded-agents-agent-sdk для Claude Code и Codex встраивает агентов Claude в приложение на Next.js через Claude Agent SDK. Запускается при запросе на интеграцию Agent SDK или когда агенту нужен движок Claude Code. CX Codex +1 ★ 741звёзд репо mcp-server Скилл mcp-server для Claude Code помогает собрать удалённый MCP-сервер, подключить OAuth и подготовить его к публикации в каталоге. Описывает этапы разработки, проверки инструментов и подтверждения работы клиента. CX Codex +1 ★ 741звёзд репо transactional-email Скилл transactional-email для Claude Code помогает добавить транзакционные письма и оповещения в приложение. Разбирает выбор почтового провайдера, повторы отправки и отписку в один клик. CX Codex +1 ★ 741звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой