01 Capture
The actual fix, not a summary of it.
ShellYard remembers what your terminal just showed. Highlight the relevant lines, attach them to a runbook draft, and you have a documented troubleshooting step grounded in real output — not a paraphrased recollection two days later. The same is true for HTTP responses, database query results, packet captures, and config diffs.
02 Attach
Hand the context to Magellan.
Attach the terminal session, the relevant tool output, and a one-line description of the problem. Magellan sees everything ShellYard captured during the session — the connection, the credentials path, the diagnostics you ran, the response payloads — and pulls them in as grounding for whatever you ask next.
03 Draft
Let the model do the first pass.
Magellan drafts a runbook with the steps you took, the commands you ran, the output that mattered, and a suggested rollback. You read it, edit it, and save it. The work of writing the runbook drops from 30 minutes of dread to 5 minutes of editing. BYO Anthropic / OpenAI / Gemini / Ollama key; operators always run the actual command.
04 Save
Documentation lives next to the work.
Runbooks, notes, IPAM records, and incident reports live in the same Space as the connections, credentials, and tools they reference. Open the client Space and the runbooks are there — not in a separate documentation portal three browser tabs away. Version history on every save (90 days on Team, unlimited on Enterprise).
05 Handoff
Incident reports, not ticketing.
Incident report scaffolds capture what happened, what was checked, what changed, and how it was resolved. Timeline, evidence sections (terminal output, HTTP response, DB query, log snippets, config diff), root cause, resolution, follow-ups, customer-facing summary. Not a replacement for PagerDuty or Jira — it's the documentation half of post-incident work, where it actually belongs.
06 Share
The senior engineer stops being the documentation.
When the only person who knows how to recover the cluster is on PTO, your team has a problem. Runbooks built from real troubleshooting sessions — not theoretical write-ups — close that gap. Team and Enterprise plans add Shared Spaces, version history, and audit-log export so the institutional memory is something the whole team can see and trust.