derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
23 lines
1.4 KiB
Markdown
23 lines
1.4 KiB
Markdown
# Architecture docs index
|
|
|
|
Reference material for how PerfXpert's agentic runtime (v0.2.0+) is
|
|
put together. Start with [../architecture.md](../architecture.md) for
|
|
the system-level overview; the docs below zoom in on specific
|
|
sub-systems.
|
|
|
|
| Topic | Doc | Audience |
|
|
|-------|-----|----------|
|
|
| Agent tier map — Root / Analysis / Recommendation / Correctness / specialists, plus the fence-slice prompt pattern | [agent-hierarchy.md](agent-hierarchy.md) | Contributors adding or modifying agents; integrators reading the code path |
|
|
| 5-gate correctness cascade (middleware) — Compile, SOL, Bitwise, Regression, Test Anchors | [gate-cascade.md](gate-cascade.md) | Contributors touching correctness logic; reviewers validating anti-reward-hack invariants |
|
|
| Multi-backend launcher contract — shared install/verify/spawn lifecycle for opencode, Claude Code, Gemini CLI, and Codex CLI | [backend-adapter.md](backend-adapter.md) | Contributors extending `perfxpert-code` or validating backend-specific behavior |
|
|
|
|
## See also
|
|
|
|
- [../architecture.md](../architecture.md) — top-level system diagram
|
|
and design rationale.
|
|
- [../integration/mcp-server.md](../integration/mcp-server.md) — how
|
|
the READ_ONLY tools used by the agents are re-exposed to external
|
|
MCP clients.
|
|
- [../guides/agentic-mode.md](../guides/agentic-mode.md) — end-user
|
|
view of the two runtime modes (air-gap vs LLM).
|