Files
claude-code/plans/shimmering-discovering-bonbon-handoff.md
OpenCode Test 431e10b449 Implement programmer agent system and consolidate agent infrastructure
Programmer Agent System:
- Add programmer-orchestrator (Opus) for workflow coordination
- Add code-planner (Sonnet) for design and planning
- Add code-implementer (Sonnet) for writing code
- Add code-reviewer (Sonnet) for quality review
- Add /programmer command and project registration skill
- Add state files for preferences and project context

Agent Infrastructure:
- Add master-orchestrator and linux-sysadmin agents
- Restructure skills to use SKILL.md subdirectory format
- Convert workflows from markdown to YAML format
- Add commands for k8s and sysadmin domains
- Add shared state files (model-policy, autonomy-levels, system-instructions)
- Add PA memory system (decisions, preferences, projects, facts)

Cleanup:
- Remove deprecated markdown skills and workflows
- Remove crontab example (moved to workflows)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-29 13:23:42 -08:00

1.8 KiB

Handoff: Linux Sysadmin Agent Implementation

Context

Brainstorming session completed for building a Linux sysadmin AI agent.

Plan Location

/home/will/.claude/plans/shimmering-discovering-bonbon.md

What Was Decided

Architecture

  • Multi-agent system with master-orchestrator (Opus) overseeing all agents
  • New linux-sysadmin agent (Sonnet) for Arch Linux workstation
  • Existing K8s agents become managed by master-orchestrator
  • Shared state files in ~/.claude/state/ for cross-agent awareness

Linux Sysadmin Agent

  • Target: Arch Linux with pacman/yay/homebrew
  • Scope: Full sysadmin (maintenance, troubleshooting, config, security)
  • Autonomy: Conservative by default (confirm all changes), session-configurable
  • Interaction: CLI + scheduled, alerting deferred

Key Design Decisions

  • Claude Code compatible (Markdown + YAML frontmatter for agents)
  • JSON files for state/data (not agent definitions)
  • Model selection policy for cost efficiency (haiku → sonnet → opus)
  • Agents can delegate to multiple subagents (parallel/sequential)
  • system-instructions.json captures all processes
  • future-considerations.json tracks deferred items (all agents aware)

Settings.json Cleanup Required

  • Remove non-standard agents field with promptFile entries
  • Keep only standard Claude Code settings

Implementation Order (20 steps, 7 phases)

  1. Foundation (state files, CLAUDE.md)
  2. Master orchestrator agent
  3. Linux sysadmin agent
  4. Update existing K8s agents
  5. Clean settings.json
  6. Skills & slash commands
  7. Workflows

Future Considerations to Track

  • Prometheus/Alertmanager for workstation alerting
  • Network admin agent
  • Personal assistant agent
  • External LLM integration
  • Slash commands redesign

Next Action

Read the full plan and begin Phase 1: Foundation