system-understanding

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

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