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

53 lines
1.8 KiB
Markdown

# 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