william-dawson/hpc-octopus

Use when the user wants to set up, configure, or troubleshoot Octopus (RIKEN R-CCS) — SSH access, the embedding endpoint for docs search (RAG), or the ~/.hpc-agent/octopus.json file. Also use when octopus tools fail with connection or embedding errors.

Interactive demo of Octopus (RIKEN R-CCS) — walks through configuration, facility info, live cluster status, docs search, filesystem access, and a real job end to end.

Use when the user asks about the status, progress, output, history, or failure of jobs on Octopus (RIKEN R-CCS), or about queue and node availability. Also use this any time you (the agent) need to check on or wait for a job you submitted, even without a fresh user request.

Use to answer questions about Octopus (RIKEN R-CCS) itself — hardware, partitions, storage, software, policies, or where to get help. Ground answers in the bundled guide and live tool output rather than prior knowledge.

Use when the user wants to run one or more shell commands on Octopus (RIKEN R-CCS)'s login node, or when another workflow needs run_command_on_cluster for a live check not covered by a safer typed tool. Requires an exact command preview and explicit user permission before execution.

Use when the user asks to make a result on Octopus (RIKEN R-CCS) reproducible, shareable, or turned into a notebook/script — or proactively suggest it after a chunk of exploratory job/file work that produced something worth preserving. Builds a Jupyter notebook that replays the real workflow via hpc_agent_core.client, not a hand-copied SSH script.

Use when the user wants to run, submit, or launch a job on Octopus (RIKEN R-CCS). Covers partition/queue selection, JobSpec construction, submission, and known gotchas specific to this facility.