@metaharness/devops 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rUv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,86 @@
+# MetaHarness: devops vertical
+
+A ready-made multi-agent scaffold for incident response on top of Claude Code. It provisions four specialized agents — `responder`, `runbook-runner`, `escalator`, and `postmortem` — wired together with tiered model routing, project-scoped settings, and a `harness doctor` health check. Use it to bootstrap an on-call assistant that triages alerts, executes runbooks, escalates when stuck, and writes the postmortem afterward.
+
+This scaffold is for SREs, platform engineers, and on-call developers who want a working incident-response harness in one command instead of assembling agents, prompts, and config by hand. It is NOT a hosted service, an alerting system, or a replacement for PagerDuty / Opsgenie / Grafana OnCall — it is the Claude Code layer that sits next to those tools.
+
+## Quickstart
+
+```bash
+npx @metaharness/devops@latest my-bot
+cd my-bot && npm install && npx harness doctor
+```
+
+Then launch Claude Code against the scaffold:
+
+```bash
+claude -p --plugin-dir my-bot "page: api-gateway 5xx spike, last 10m"
+```
+
+## What you get
+
+- `agents/responder.md` — first-touch triage agent (tier: **sonnet**). Reads the alert, pulls recent logs/metrics, proposes hypotheses.
+- `agents/runbook-runner.md` — executes documented runbooks step-by-step (tier: **haiku**). Cheap, deterministic, fast.
+- `agents/escalator.md` — decides when human escalation is warranted and drafts the page (tier: **sonnet**).
+- `agents/postmortem.md` — writes a blameless postmortem from the incident transcript (tier: **opus**).
+- `.claude/settings.json` — project-scoped Claude Code config with allow-listed tools (Read, Grep, Glob, Bash for read-only commands).
+- `mcp.json` — pre-wired MCP server stubs for log search and metrics queries; edit to point at your stack.
+- `runbooks/` — example runbook templates the `runbook-runner` agent consumes.
+- `package.json` with a `harness` bin shim so `npx harness doctor` and `npx harness validate` work out of the box.
+
+## Advanced
+
+Run the bundled doctor to verify the scaffold is healthy:
+
+```bash
+$ npx harness doctor
+[harness] node: v20.11.1  ok
+[harness] claude code: detected
+[harness] agents: 4 found (responder, runbook-runner, escalator, postmortem)
+[harness] mcp.json: 2 servers configured
+[harness] settings.json: valid
+ok
+```
+
+Validate the agent frontmatter and tier assignments:
+
+```bash
+$ npx harness validate
+[harness] agents/responder.md      tier=sonnet  tools=Read,Grep,Bash  ok
+[harness] agents/runbook-runner.md tier=haiku   tools=Read,Bash       ok
+[harness] agents/escalator.md      tier=sonnet  tools=Read,WebFetch   ok
+[harness] agents/postmortem.md     tier=opus    tools=Read,Write      ok
+ok
+```
+
+Drive the harness headlessly for CI or webhook integrations:
+
+```bash
+claude -p --plugin-dir my-bot --output-format json \
+  "incident: redis OOMKilled in prod-us-east-1, alert id INC-4421"
+```
+
+Pipe a recent alert payload from your incident tool straight into the responder:
+
+```bash
+cat alert.json | claude -p --plugin-dir my-bot --append-system-prompt "You are the on-call responder. Start with the responder agent."
+```
+
+## FAQ
+
+**Q: Does this replace PagerDuty / Opsgenie?**
+A: No. It plugs into them. The `escalator` agent drafts the page; your existing tool delivers it. Wire the MCP server in `mcp.json` to your incident platform's API.
+
+**Q: Can I change which model each agent uses?**
+A: Yes. Edit the `model:` field in the YAML frontmatter of each `agents/*.md` file. The defaults (haiku for runbook execution, sonnet for triage, opus for postmortems) follow the 3-tier cost/latency pattern but every choice is a one-line override.
+
+**Q: How do I add my own runbook?**
+A: Drop a markdown file into `runbooks/`. The `runbook-runner` agent discovers them by glob and matches against the incident description. No registration step.
+
+## License
+
+MIT. Built on metaharness (https://www.npmjs.com/package/metaharness).
+
+## Deep-dive
+
+Full explainer gist: https://gist.github.com/ruvnet/7c2975652c9be393536a71cdafc358f3

package/bin/scaffold.mjs

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { execSync } from 'node:child_process';
+import process from 'node:process';
+
+const name = process.argv[2] || 'my-bot';
+const extra = process.argv.slice(3);
+
+const cmd = [
+  'npx',
+  '--yes',
+  'metaharness@latest',
+  JSON.stringify(name),
+  '--template',
+  'vertical:devops',
+  '--host',
+  'claude-code',
+  '--force',
+  ...extra.map((a) => JSON.stringify(a)),
+].join(' ');
+
+try {
+  execSync(cmd, { stdio: 'inherit' });
+  console.log('');
+  console.log(`Next: cd ${name} && npm install`);
+  console.log(`Then: npx harness doctor`);
+  console.log(`Run:  claude -p --plugin-dir ${name} "page: <your incident here>"`);
+} catch (err) {
+  console.error('[@metaharness/devops] scaffold failed:', err?.message || err);
+  process.exit(typeof err?.status === 'number' ? err.status : 1);
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@metaharness/devops",
+  "version": "0.1.0",
+  "description": "MetaHarness example — Claude Code incident-response vertical with responder, runbook-runner, escalator, postmortem agents (npx @metaharness/devops my-bot)",
+  "homepage": "https://github.com/ruvnet/agent-harness-generator/tree/main/examples-packages/devops",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ruvnet/agent-harness-generator.git",
+    "directory": "examples-packages/devops"
+  },
+  "license": "MIT",
+  "author": "rUv <ruv@ruv.net>",
+  "type": "module",
+  "bin": "./bin/scaffold.mjs",
+  "files": [
+    "bin/**",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "smoke": "node --check bin/scaffold.mjs"
+  },
+  "keywords": [
+    "metaharness",
+    "agent-harness",
+    "agent-harness-generator",
+    "devops",
+    "vertical",
+    "claude-code",
+    "ai-agent",
+    "mcp",
+    "npx",
+    "scaffold"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}