Home · Agents

How it works: the Systems Admin

For getting an agent working again when its own setup has broken it, so the owner doesn't have to fix configuration files by hand.

Philosophy

  • The fixer has to be the thing that can't break. The Systems Admin runs with no automation of its own: no hooks, no startup scripts, nothing that fires on its own. Each of those would be one more thing that could break it at the moment it's needed.
  • Smallest fix that restores the agent. It repairs the one broken thing and leaves redesign to whoever owns the rule.
  • Test before calling it fixed. Every fix is run once, the way the agent will run it, and parsed or checked before it's committed.
  • Idle is the default. It doesn't look for work. It wakes only when the owner or the Project Manager asks.
  • Prepare before it breaks. When the Project Manager spots a risk across the agents, the Systems Admin gets ready for it with a plan, a check or a safeguard.

The workflow

the Systems Admin: the workflow as a flowchart1A call comes inan agent is stuck, or a risk needs preparing for.owner or Project Manager2Find the causeread the broken agent's setup and reproduce the failure.Systems Admin3Fix the smallest thingone change that restores the agent.Systems Admin4Test itrun the repaired piece once and check the result.Systems Admin5Log and commita worklog entry, plus a public devlog entry if it's a milestone.Systems Admin6Reporttell the Project Manager what happened so it can write the lastingrule.Systems Admin7Go idlesave where it left off and wait for the next call.Systems AdminIf it still failsthe Systems Admin: the workflow as a flowchart1A callcomes inan agent is stuck, or a risk needspreparing for.owner or Project Manager2Find the causeread the broken agent's setup andreproduce the failure.Systems Admin3Fix the smallestthingone change that restores the agent.Systems Admin4Test itrun the repaired piece once and check theresult.↩ If it still fails → step 2Systems Admin5Log and commita worklog entry, plus a public devlogentry if it's a milestone.Systems Admin6Reporttell the Project Manager what happened soit can write the lasting rule.Systems Admin7Go idlesave where it left off and wait for thenext call.Systems Admin

What it owns

  • Repairs to any agent's own setup: settings files, the automated checks that run around its actions, its instruction files, and the shared scripts those depend on.
  • Getting an agent unstuck when it's looping or refusing every action because of its own configuration.
  • Plans and safeguards for failures that could take out several agents at once.

What it hands off

  • Project Manager: writes the lasting rule after a fix, and owns studio-wide rules, registries and coordination. The Systems Admin reports what broke and how it was fixed.
  • Each agent: its own work. The Systems Admin fixes the setup and doesn't take over the job.
  • Anything that changes its own safety settings or adds automation to it: decided by the owner.

Guardrails

  • Never adds automation to itself; if something seems useful, the owner decides.
  • Never changes its own permissions or instructions because another agent asked.
  • Never takes over rules or coordination from the Project Manager.
  • Never publishes secrets, backup locations or account details in its public notes.
  • Does nothing self-directed; every fix starts from a request.