Add plugin manifest and documentation for agents/workflows

- Add .claude-plugin/plugin.json for potential plugin distribution
- Add agents/README.md explaining agent file purpose and usage
- Add workflows/README.md clarifying that workflows are design docs,
  not executable automation (Claude Code doesn't natively execute YAML)

This improves documentation and enables potential future portability
as a plugin.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

workflows/README.md

@@ -0,0 +1,97 @@
+# Workflow Definitions
+
+This directory contains workflow definitions for automated tasks.
+
+## Status
+
+**These are design documents, not executable automation.**
+
+Claude Code does not natively execute YAML workflow files. These definitions serve as:
+
+1. **Design documentation** - Specify what steps a workflow should perform
+2. **Reference for skills** - Skills can reference workflow steps
+3. **Future automation** - Can be executed via external tools (cron + headless claude)
+
+## Workflow Categories
+
+### Health Checks (`health/`)
+
+| Workflow | Purpose |
+|----------|---------|
+| `cluster-health-check.yaml` | Kubernetes cluster health |
+| `cluster-daily-summary.yaml` | Daily cluster summary |
+
+### Deployments (`deploy/`)
+
+| Workflow | Purpose |
+|----------|---------|
+| `deploy-app.yaml` | Deploy application to Kubernetes |
+
+### Incident Response (`incidents/`)
+
+| Workflow | Purpose |
+|----------|---------|
+| `pod-crashloop.yaml` | Handle pod crash loops |
+| `node-issue-response.yaml` | Respond to node issues |
+| `resource-pressure-response.yaml` | Handle resource pressure |
+| `argocd-sync-failure.yaml` | Handle ArgoCD sync failures |
+
+### System Admin (`sysadmin/`)
+
+| Workflow | Purpose |
+|----------|---------|
+| `health-check.yaml` | Workstation health check |
+| `system-update.yaml` | System package updates |
+
+## Executing Workflows
+
+### Option 1: Manual via Claude
+
+Ask Claude to perform the workflow steps:
+
+```
+Run the sysadmin health check workflow
+```
+
+Claude reads the workflow file and executes steps manually.
+
+### Option 2: Headless Execution
+
+```bash
+claude --print "Execute ~/.claude/workflows/sysadmin/health-check.yaml" | claude
+```
+
+### Option 3: External Automation (Future)
+
+Could integrate with:
+- Cron jobs calling headless Claude
+- n8n workflows
+- GitHub Actions
+
+## Workflow Format
+
+```yaml
+name: workflow-name
+description: What this workflow does
+version: "1.0.0"
+
+trigger:
+  schedule:
+    cron: "0 9 * * *"
+  manual: true
+
+agent: agent-name
+model: sonnet|haiku
+
+steps:
+  - name: step-name
+    description: What this step does
+    commands:
+      - command1
+      - command2
+
+output:
+  file: path/to/output
+  notify:
+    on_warning: true
+```