@startuml docs-rag-architecture
skinparam componentStyle rectangle
skinparam defaultFontName Arial
skinparam backgroundColor #FAFAFA

package "docs-rag Skill" {
  component "SKILL.md\n(instructions)" as SKILL
  component "data/index.json\n(spec, title, keywords,\nsummary, file path)" as INDEX
  component "evals/evals.json" as EVALS
}

package "Source Documents" {
  database "docs/\n*.docx / *.doc\n(3GPP specs)" as DOCS
  component "scripts/build_index.py\n(index builder)" as BUILDER
}

actor Developer

Developer --> SKILL : 3GPP question
SKILL --> INDEX : keyword + semantic match
INDEX --> DOCS : read file (deep detail)
BUILDER --> INDEX : builds / updates
DOCS --> BUILDER : scans
@enduml