# System Understanding

> System Understanding is an Agent Skill for development published in the rapidaai/voice-ai repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Build a code-grounded implementation plan before coding. Use to trace packet flow, factory boundaries, provider config loading, and exact file-level change scope for a requested integration.

- Skill name: `system-understanding`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/rapidaai/voice-ai/blob/HEAD/.claude/skills/system-understanding/SKILL.md
- Repository: rapidaai/voice-ai (695 GitHub stars when collected)

## SKILL.md

# System Understanding Skill

## Mission

Produce an executable, minimal-risk implementation plan from real code paths before changing feature logic.

## Scope

Planning and analysis only.
Do not implement production changes in this skill run.

## Mandatory discovery sequence

1. Identify feature lane and factory switch:
- telephony: `api/assistant-api/internal/channel/telephony/telephony.go`
- stt/tts: `api/assistant-api/internal/transformer/transformer.go`
- vad: `api/assistant-api/internal/vad/vad.go`
- eos: `api/assistant-api/internal/end_of_speech/end_of_speech.go`
- llm: `api/integration-api/internal/caller/caller.go`

2. Trace runtime packet flow in dispatcher:
- `api/assistant-api/internal/adapters/internal/dispatch.go`

3. Verify UI/provider config load behavior:
- `ui/src/providers/provider.development.json`
- `ui/src/providers/provider.production.json`
- `ui/src/providers/config-loader.ts`

4. Produce exact edit scope:
- provider folder
- factory file
- optional shared contract files
- tests to update

## Output requirements

- Requested integration type and inferred defaults.
- Transport/signal mode chosen and why.
- Exact file list to edit (and explicit out-of-scope file list).
- Test and validation command plan.
- Risks and rollback path.

## Validation commands

- `rg -n "GetTelephony|GetSpeechToTextTransformer|GetTextToSpeechTransformer|GetEndOfSpeech|GetVAD" api`
- `rg -n "GetLargeLanguageCaller|GetEmbeddingCaller|GetRerankingCaller|GetVerifier" api/integration-api`
- `rg -n "OnPacket\(|dispatch\(" api/assistant-api/internal/adapters/internal/dispatch.go`

---

Source: https://www.openparable.com/skill/development/system-understanding (OpenParable). Cite the canonical URL above.
