system-understanding

# System Understanding Skill ## Mission Produce an implementation plan from real factory/packet/config paths before writing feature code. ## Scope Planning and analysis only. Do not implement production changes in this skill. ## Discovery sequence 1. Identify factory lane: - 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 packet flow: - `api/assistant-api/internal/adapters/internal/dispatch.go` 3. Verify UI config loading: - `ui/src/providers/provider.development.json` - `ui/src/providers/provider.production.json` - `ui/src/providers/config-loader.ts` 4. Produce exact edit boundaries: - provider folder - factory file - optional contract files - tests to update ## Output requirements - inferred integration type and defaults - chosen transport/signal strategy - exact in-scope file list and explicit out-of-scope files - test + validation command plan - risk + rollback path ## Governed lifecycle - This planning skill owns only the `understand` and `plan` phases from `DEVELOPMENT_PROCESS.md`. - The plan must declare acceptance criteria, non-goals, allowed paths, explicit owners, principles, required tests and commands, risks, and rollback. - A separate `plan-challenger` must review the output; this skill may not approve its own plan or perform implementation. - The coordinator attests the approved plan before any implementation worker starts. ## 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` ## References - `references/checklist.md` - `references/system-map.md` - `examples/sample.md`