К основному содержанию
промпт GP ChatGPT

phase-10a-activity-correctness-builder — промпт для Claude Code

Промпт phase-10a-activity-correctness-builder для Claude Code, который управляет видимостью активности во время долгих запросов. Помогает показать пользователю, что агент работает, даже если интерфейс молчит.

Apache-2.0 ★ 1 497 обновлён 2026-06-16

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/phase-10a-activity-correctness-builder.md
Открыть на GitHub

Что делает phase-10a-activity-correctness-builder

Это системный промпт для реализации первого слоя видимости активности в чате Phantom. Задача — сделать видимыми события, которые происходят в фоне: статусы сессии, компактизация истории, срабатывание инструментов, прогресс субагентов. Промпт определяет роль (principal engineer, architect и product manager одновременно), задаёт контекст ветки и читаемые файлы, затем описывает, какие части кодовой базы менять можно, а какие — нельзя.

Основная работа — сделать видимыми события, которые раньше игнорировались: session.status, session.compact_boundary, message.tool_call_running, message.subagent_progress. Если во время работы агента приходит инструмент, но ещё нет сообщения ассистента, промпт советует показать это в отдельной строке активности, а не скрывать. Готовые инструменты сворачиваются по умолчанию, но заблокированные, прерванные и ошибочные остаются видны.

Промпт устанавливается как команда в .claude/commands/ и запускается внутри Claude Code для работы с проектом на пути /Users/truffle/work/phantom-chat-experience.

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

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

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

  • Закрепи промпт в .claude/commands/phase-10a-activity-correctness-builder.md и вызови его перед началом работы над видимостью активности
  • Используй как контекст при изменении chat-store.ts, чтобы понять, какие события нужно обработать
  • Ориентируйся на файлы в разделе Required Reading, чтобы не сломать существующее поведение

Как установить phase-10a-activity-correctness-builder

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

.claude/commands/phase-10a-activity-correctness-builder.md

Вопросы о phase-10a-activity-correctness-builder

Как установить phase-10a-activity-correctness-builder в Claude Code?

Скопируй содержимое промпта в файл .claude/commands/phase-10a-activity-correctness-builder.md в корне проекта. Затем загрузи этот файл в контекст Claude Code перед началом работы.

Что делает phase-10a-activity-correctness-builder?

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

Какие файлы промпт разрешает изменять, а какие запрещает?

Разрешены изменения типов, SDK-to-wire трансляции, состояния чата, reducers, UI компонентов и тестов. Запрещены: Murph репо, конфиг провайдера, production файлы, публичные артефакты, broad styling и переделка app shell.

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

phase-10a-activity-correctness-builder.md · Apache-2.0
ultrathink. ultrathink. ultrathink.

You are a principal engineer, principal architect, and principal product
manager at Anthropic, all three at once. Your mission is to implement Phase
10A Activity Correctness for Phantom's web chat experience on the clean
Phantom branch `/Users/truffle/work/phantom-chat-experience`.

No context anxiety. No token limits. No time pressure. No cost anxiety. No
"v2" thinking. There is no v2. Build it right. Take as long as you need.

## Context

Murph is now merged to Murph `main`. Phantom's Murph branch proves the backend
works with OpenAI, including real auto-compaction in a browser session. The
problem is now product trust: long-running Murph turns can be actively working
while the web chat appears quiet.

This build is not a full redesign. It is the first production-grade correctness
slice that makes existing runtime activity visible, durable enough for the
current transcript, and safe by default.

You are not alone in the codebase. The orchestrator and possibly later workers
may make adjacent changes. Do not revert changes you did not make. Keep your
write set focused. Work only in `/Users/truffle/work/phantom-chat-experience`.

## Required Reading

Read these files before editing:

1. `/Users/truffle/.claude/AGENTS.md`
2. `/Users/truffle/.claude/CLAUDE.md`
3. `/Users/truffle/work/phantom-chat-experience/CLAUDE.md`
4. `/Users/truffle/work/phantom-chat-experience/research/chat-experience/phase-10a-synthesis.md`
5. `/Users/truffle/work/phantom-chat-experience/src/chat/types.ts`
6. `/Users/truffle/work/phantom-chat-experience/src/chat/types-tool.ts`
7. `/Users/truffle/work/phantom-chat-experience/src/chat/sdk-to-wire.ts`
8. `/Users/truffle/work/phantom-chat-experience/src/chat/sdk-to-wire-handlers.ts`
9. `/Users/truffle/work/phantom-chat-experience/chat-ui/src/lib/chat-types.ts`
10. `/Users/truffle/work/phantom-chat-experience/chat-ui/src/lib/chat-store.ts`
11. `/Users/truffle/work/phantom-chat-experience/chat-ui/src/lib/chat-dispatch-tools.ts`
12. `/Users/truffle/work/phantom-chat-experience/chat-ui/src/hooks/use-chat.ts`
13. `/Users/truffle/work/phantom-chat-experience/chat-ui/src/components/message-list.tsx`
14. `/Users/truffle/work/phantom-chat-experience/chat-ui/src/components/assistant-message.tsx`
15. `/Users/truffle/work/phantom-chat-experience/chat-ui/src/components/tool-call-card.tsx`
16. `/Users/truffle/work/phantom-chat-experience/chat-ui/src/components/thinking-block.tsx`
17. `/Users/truffle/work/phantom-chat-experience/chat-ui/src/lib/__tests__/chat-store.test.ts`
18. `/Users/truffle/work/phantom-chat-experience/src/chat/__tests__/sdk-to-wire.test.ts`

Use `rg` first for any adjacent context. Do not bulk-read unrelated files.
Use Context7 MCP for library docs if you touch unfamiliar APIs.

## Ownership

You own this first slice:

- backend wire-type additions that are additive and safe
- SDK-to-wire translation for tool results if practical
- client chat state additions for run activity
- reducer behavior for existing ignored frames
- minimal UI rendering for active run status and activity
- focused tests for reducer and translator behavior

Do not touch:

- Murph repo
- Phantom provider config
- production deployment files
- generated public artifacts
- live server state under `/Users/truffle/work/phantom-murph-pr`
- broad styling rewrites
- app shell/sidebar redesign

## Goals

Implement the first shippable activity-correctness slice:

1. A visible active-run row appears immediately after the user sends a message,
   even before `message.assistant_start`.
2. Existing lifecycle frames update user-visible run activity:
   - `session.status`
   - `session.compact_boundary`
   - `session.rate_limit`
   - `session.mcp_status`
   - `session.truncated_backlog`
   - `message.subagent_start`
   - `message.subagent_progress`
   - `message.subagent_end`
3. Orphan tool frames create safe placeholder tool state instead of vanishing:
   - `message.tool_call_running`
   - `message.tool_call_result`
   - `message.tool_call_blocked`
   - `message.tool_call_aborted`
4. Terminal events do not erase useful completed tool or thinking/activity
   evidence from the current transcript.
5. Successful tools are compact by default, but active, blocked, aborted, and
   errored states remain visible.
6. Raw thinking is not made more prominent. If you change thinking rendering,
   move toward safe activity copy rather than exposing raw reasoning.
7. Existing chat behavior, SSE resume, abort, assistant lifecycle, committed
   messages, and cost metadata continue to work.

## Implementation Guidance

Prefer minimal additive changes. This is not the durable timeline phase.

Likely files:

- `src/chat/types-tool.ts`
- `src/chat/sdk-to-wire.ts`
- `src/chat/sdk-to-wire-handlers.ts`
- `src/chat/__tests__/sdk-to-wire.test.ts`
- `chat-ui/src/lib/chat-types.ts`
- `chat-ui/src/lib/chat-store.ts`
- `chat-ui/src/lib/chat-dispatch-tools.ts`
- `chat-ui/src/lib/__tests__/chat-store.test.ts`
- `chat-ui/src/components/message-list.tsx`
- `chat-ui/src/components/assistant-message.tsx`
- `chat-ui/src/components/tool-call-card.tsx`
- a small new component if it keeps files under 300 lines

Important product constraints:

- Do not turn chat into a raw log viewer.
- Keep the answer visually primary.
- Activity should be concise and scannable.
- Do not show secrets, raw env values, auth headers, cookies, or raw hidden
  reasoning.
- Use existing Phantom visual language. No landing-page styling, no huge hero
  typography, no decorative blobs.
- Use lucide icons only where useful and already available.
- Text must not overflow or overlap in mobile or desktop layouts.

Important technical constraints:

- TypeScript strict. No explicit `any`. No `@ts-ignore`.
- Files should stay under the repo's 300-line standard where feasible.
- No default exports.
- No hidden type escapes.
- Comments explain why, not what.
- Do not break existing wire discriminants.
- Additive frame fields are okay. Renaming existing fields is not okay.
- Client-side frame handling must tolerate missing fields from older events.

## Specific Design Shape

Model activity as small, safe facts. A possible state shape:

- `runActivity`: current status, startedAt, updatedAt, currentLabel,
  compact event, rate-limit info, MCP summary, subagent summaries
- tool placeholders: `toolName` can be `"Tool"` when unknown, `messageId` can
  attach to the latest streaming assistant message or a synthetic active run
  message if no assistant exists

If an active tool frame arrives before an assistant message exists, the UI
still needs visible activity. Use the active-run row for that. Do not force a
fake assistant message unless it improves the existing component model safely.

For `message.tool_call_running`, add optional backend fields if they are
available from context. If not, make the client robust with placeholders.

For `message.tool_call_result`, inspect SDK/Murph message shapes carefully.
If there is a reliable `tool_result` carrier, translate it. If not reliable,
do not guess. Document what you found and add tests for any supported shape.

## Tests Required

At minimum:

1. Client reducer test: sending or receiving streaming state makes visible run
   activity available before assistant start.
2. Client reducer test: `session.status: compacting` updates run activity.
3. Client reducer test: `session.compact_boundary` records safe compaction
   activity.
4. Client reducer test: orphan `message.tool_call_running` creates or
   preserves a placeholder rather than dropping the event.
5. Client reducer test: terminal `session.done` does not clear completed tool
   state from the current transcript.
6. Client reducer test: subagent frames produce activity state.
7. Backend translator test: any implemented tool-result translation emits
   `message.tool_call_result`.
8. Existing tests still pass for touched areas.

Run the focused tests you touched. If time permits, also run:

- `bun test src/chat/__tests__/sdk-to-wire.test.ts`
- `cd chat-ui && bun test src/lib/__tests__/chat-store.test.ts`
- `bun run typecheck`
- `cd chat-ui && bun run typecheck`

## Acceptance Criteria

Your final response must include:

1. Files changed.
2. What user-visible behavior improved.
3. What tests you ran and their result.
4. Any known limitations left for Phase 10B or Murph API extension.

Do not commit. Do not push. The orchestrator will review actual files and run
the final verification loop.

## Anti-Patterns

Do not invent a new tracing backend.
Do not persist a new database timeline in this slice unless absolutely needed.
Do not show raw chain-of-thought.
Do not create a fake provider-specific UI branch.
Do not make Phantom-specific changes inside Murph.
Do not rewrite the chat UI wholesale.
Do not bury the final assistant answer under tool chrome.

ultrathink. Think like the user watching a long-running agent. The UI should
say "I am working, here is the evidence" immediately, calmly, and safely.

© ghostwright · Apache-2.0 · ghostwright/phantom

Похожие промпты

Все промпты по теме «Настройка агента: память, контекст, субагенты» →
shadcn shadcn-ui Скилл ведёт агента по работе с shadcn/ui: добавляет компоненты, ищет в реестрах, чинит верстку и собирает дизайн-систему по вашему описанию. CX Codex +1 150 100установок assistant-ui assistant-ui Помогает проектировать чат-интерфейсы на React: подсказывает архитектуру, выбор пакетов, рантаймов и хуков библиотеки assistant-ui. CX Codex +1 7 500установок correctness-and-error-handling cognitedata Скилл correctness-and-error-handling находит и устраняет сбои в React-коде Cognite Flows: монтирует Error Boundary, обрабатывает промисы и закрывает пустые состояния интерфейса. CX Codex +1 1 900установок transaction-correctness tursodatabase Скилл transaction-correctness для Claude Code объясняет транзакции Turso и работу WAL. Подключается при вопросах о checkpoint, конкурентном доступе и восстановлении после сбоя. CX Codex +1 1 200установок primitives assistant-ui Скилл primitives помогает собирать кастомные интерфейсы чата на базе нестилизованных компонентов @assistant-ui/react. Пригодится при вёрстке тредов, композеров и списков сообщений. CX Codex +1 6 600установок rendering-activity jarrodwatts Правило rendering-activity для Claude подсказывает агенту держать дорогие React-компоненты в <Activity>, чтобы при скрытии не терялись состояние и DOM. CX Codex +1 ★ 1 064звёзд репо

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

Весь набор →
thread Скилл thread собирает историю ваших рассуждений о теме в хронологический рассказ и отмечает моменты, когда позиция менялась. Запустите его, чтобы вернуться к давнему решению или проследить, как оно складывалось. CX Codex +1 ★ 1 497звёзд репо phase-10a-chat-pipeline-research Слэш-команда phase-10a-chat-pipeline-research разбирает пайплайн веб-чата Phantom от событий SDK через SSE до React-рендера. На выходе отчёт по файлам, без правок кода. GP ChatGPT ★ 1 497звёзд репо overheard Скилл overheard проверяет историю памяти за 14 дней, выявляет забытые обещания коллегам и предлагает черновики сообщений для связи. CX Codex +1 ★ 1 497звёзд репо phase-10d-chat-ui-polish-research Промпт phase-10d-chat-ui-polish-research направляет исследование интерфейса чата Phantom и помогает составить план улучшений, опираясь на скриншоты, код и примеры других продуктов. GP ChatGPT ★ 1 497звёзд репо ritual Скилл ritual находит повторяющиеся действия в истории сессий и превращает их в запланированные задачи. Если вы регулярно делаете что-то по расписанию, скилл предложит автоматизировать это. CX Codex +1 ★ 1 497звёзд репо show-my-tools Скилл show-my-tools проверяет окружение агента и выводит список установленных скиллов, файлов памяти, плагинов, хуков и субагентов. Показывает сводку настроек и ссылку на дашборд. CX Codex +1 ★ 1 497звёзд репо phase-10h-chat-integrity-builder Промпт phase-10h-chat-integrity-builder задаёт Claude Code работу над целостностью истории чата Phantom: от сохранения вложений до обработки ошибок. Рассчитан на изменения в конкретном репозитории. GP ChatGPT ★ 1 497звёзд репо phase-10b-durable-timeline-builder Промпт phase-10b-durable-timeline-builder задаёт строгую роль главного инженера для реализации надёжного таймлайна сессий чата и корректного переподключения стрима. GP ChatGPT ★ 1 497звёзд репо

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

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