Files

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

3.6 KiB

Raw Blame History

Plan: Restructure Claude Code Components

Summary

Reclassify misplaced skill files as commands, standardize workflow format to YAML, and add cross-references between components.

Decisions Made

Decision	Choice
Handle misclassified skills	Move to commands as thin wrappers
Workflow format	Keep YAML, convert Markdown to YAML
Cross-references	Add inline links in command files

Task 1: Move Misclassified Skills to Commands

These files use /command syntax and should be commands, not skills.

1.1 Create `/cluster-status` command

Delete: ~/.claude/skills/cluster-status.md Create: ~/.claude/commands/k8s/cluster-status.md

---
name: cluster-status
description: Get quick cluster health overview
aliases: [status, cs]
---

Content: Thin wrapper referencing cluster-health-check workflow.

1.2 Create `/deploy` command

Delete: ~/.claude/skills/deploy.md Create: ~/.claude/commands/k8s/deploy.md

---
name: deploy
description: Deploy application to K8s cluster
aliases: [d]
---

Content: Thin wrapper referencing deploy-app workflow.

1.3 Create `/diagnose` command

Delete: ~/.claude/skills/diagnose.md Create: ~/.claude/commands/k8s/diagnose.md

---
name: diagnose
description: Investigate cluster issues
aliases: [diag]
---

Content: Thin wrapper referencing incident workflows.

Task 2: Convert Workflow to YAML

File: ~/.claude/workflows/deploy/deploy-app.md Convert to: ~/.claude/workflows/deploy/deploy-app.yaml

Restructure as proper YAML workflow matching other workflow files.

Task 3: Add Cross-References to Existing Commands

Update existing commands to explicitly reference what they invoke:

3.1 Update `/health` command

File: ~/.claude/commands/sysadmin/health.md

Add: invokes: skill:sysadmin-health

3.2 Update `/update` command

File: ~/.claude/commands/sysadmin/update.md

Add: invokes: workflow:sysadmin/system-update

3.3 Update `/autonomy` command

File: ~/.claude/commands/sysadmin/autonomy.md

Add: modifies: state:sysadmin/session-autonomy

Task 4: Update CLAUDE.md with Component Conventions

File: ~/.claude/CLAUDE.md

Add section documenting:

Format conventions (when to use JSON vs YAML vs Markdown)
Component relationships (commands → skills → workflows)
Naming patterns

Files to Create

File	Purpose
`~/.claude/commands/k8s/cluster-status.md`	Cluster status command
`~/.claude/commands/k8s/deploy.md`	Deploy command
`~/.claude/commands/k8s/diagnose.md`	Diagnose command
`~/.claude/workflows/deploy/deploy-app.yaml`	Converted workflow

Files to Delete

File	Reason
`~/.claude/skills/cluster-status.md`	Moved to commands
`~/.claude/skills/deploy.md`	Moved to commands
`~/.claude/skills/diagnose.md`	Moved to commands
`~/.claude/workflows/deploy/deploy-app.md`	Converted to YAML

Files to Modify

File	Change
`~/.claude/commands/sysadmin/health.md`	Add invokes reference
`~/.claude/commands/sysadmin/update.md`	Add invokes reference
`~/.claude/commands/sysadmin/autonomy.md`	Add modifies reference
`~/.claude/CLAUDE.md`	Add component conventions

Execution Order

Create ~/.claude/commands/k8s/ directory
Create 3 new command files
Delete 3 misclassified skill files
Convert deploy-app.md to deploy-app.yaml
Update existing command files with cross-references
Update CLAUDE.md with conventions

3.6 KiB Raw Blame History