# Инструкции проекта py_faster_whisper

## Область действия и источники

- Эти инструкции действуют для всего репозитория. Более близкий `AGENTS.md`, если он появится в компоненте, уточняет их только для своего поддерева.
- Сначала используй этот файл и ближайшие `.knowledge/*`, затем проверенные документы и конфигурацию репозитория.
- Project overlay `monitorsoft:py-faster-whisper` дополняет локальные источники знаниями о связанных checkout и runtime, но не заменяет их.
- Корпоративные правила применяй только к затронутому контуру и только после проектных источников.

## Карта знаний

- Компоненты, entrypoints и deployment ownership: `.knowledge/project-inventory.md`.
- Development, test, debug и delivery: `.knowledge/workflows.md`.
- Основной runtime contract: `README.md`, `src/README.md` и `CODEMAP.md`.
- File ASR/diarization topology: `DOCS/FILE_DIARIZATION_STACK.md`.
- Cross-project voice-chat architecture: `../webrtc-komaroff/DOCS/ARCHITECTURE.md`.

## Применимые skills и роль

- Проектные знания: `$monitorsoft-project-knowledge`.
- Корпоративные требования: `$monitorsoft-corporate-development-context`.
- Поставка, DRS и runtime evidence: `$monitorsoft-service-deployment`, `$monitorsoft-dry-stack-dsl`, `$monitorsoft-insight-stack-debug`, `$monitorsoft-drs-insight-diff`, `$monitorsoft-gitlab-deploy-correlator`.
- Browser и NATS evidence: `$monitorsoft-gis-browser-access`, `$monitorsoft-nats-flow-trace`.
- Для самостоятельной read-only диагностики используй зарегистрированную роль `monitorsoft_voice_chat_runtime_debugger`.

## Инварианты и безопасность

- Сохраняй пользовательские dirty/untracked изменения; не выполняй reset, checkout или cleanup чужой работы.
- Основной application entrypoint — `python -m src.stt_whisper_to_nats`; отдельного `src.main` нет.
- NATS subjects, HTTP payload и diarization sidecar contract изменяй как межсервисные интерфейсы с producer/consumer tests и документацией.
- `stack/stack.drs` владеет legacy CPU stack `py_faster_whisper`; WebRTC ingress и H100 model services по-прежнему принадлежат соседнему WebRTC repository и внешнему `rag-stack`.
- Credentials используй только через logical IDs `monitorsoft/dev/gitlab`, `monitorsoft/dev/insight` и `monitorsoft/dev/nats`; значения не записывай в Git, вывод или документацию.
- Push, pipeline, deployment, restart и изменение общего runtime выполняй только когда они прямо входят в задачу. Разделяй source, pipeline/image, stack/ingress и named live behavior как разные уровни доказательств.

<!-- OPENWIKI:START -->

## OpenWiki

This repository has a generated `openwiki/` evidence index. It is optional just-in-time context, not required startup reading.

- Treat source code and tests as authoritative. A brief's unknowns and review items are verification gaps, not automatic requirements.
- Prefer the narrowest quiet validation that proves the changed behavior. Preserve complete failure output.

The scheduled OpenWiki GitHub Actions workflow refreshes the repository wiki. Do not hand-edit generated OpenWiki pages unless explicitly asked; prefer updating source code/docs and letting OpenWiki regenerate.

<!-- OPENWIKI:END -->