minhuw Docmancer
Use the project-local Docmancer index before relying on memory for Intel uncore details.
Setup
If .resources/docmancer/venv/bin/docmancer or .resources/docmancer/docmancer.yaml is missing, rebuild the local corpus and index:
scripts/setup-uncore-rag.sh
To also install/update the user-level agent skill copy:
scripts/setup-uncore-rag.sh --install-codex-skill
The generated resources are intentionally untracked under .resources/.
Query
Run queries from the repo root with the project-local config:
.resources/docmancer/venv/bin/docmancer \
--config .resources/docmancer/docmancer.yaml \
query 'CAPID6 CAPID7 CHA count Skylake Xeon' \
--limit 8 \
--budget 3000 \
--explain
Useful checks:
.resources/docmancer/venv/bin/docmancer --config .resources/docmancer/docmancer.yaml inspect
.resources/docmancer/venv/bin/docmancer --config .resources/docmancer/docmancer.yaml list
Source Trust
Prefer sources in this order:
- Intel uncore programming/reference manuals and SDM material.
- Linux kernel uncore PMU driver code and sysfs ABI documentation.
- Intel perfmon public JSON event files.
- Intel perfmon experimental JSON event files.
- Local machine validation with
perf, MSR reads, or Ocellus exporter output.
Treat *_uncore_experimental.json entries as hints. Do not enable exporter metrics or dashboards from experimental JSON alone; verify against a manual, Linux support, or hardware.
Corpus Shape
The script builds a focused corpus at .resources/docmancer/corpus from:
- Intel perfmon uncore JSON and
mapfile.csv. - Intel uncore manuals/packages for Ocellus-supported generations.
- Linux
arch/x86/events/intel/uncore*, perf PMU event tables, and event_source sysfs ABI docs. - Normalized per-event Markdown records under
normalized-events/that repeat platform, source, and trust metadata beside each event.
Text-shadow files under .resources/docmancer/corpus/text-shadows/ are copies with .txt suffixes so Docmancer can index CSV, C, header, and extensionless ABI content. Event JSON tables are not indexed raw; use the generated normalized-events/ Markdown records for event lookup.