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>
53 lines
1.8 KiB
Markdown
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
|