buddy-agent-harness 0.1.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,12 @@
+{
+	"name": "buddy-agent-harness",
+	"version": "0.1.0",
+	"description": "Initialize standards-based agent configuration across coding-agent harnesses",
+	"author": {
+		"name": "repobuddy"
+	},
+	"repository": "https://github.com/repobuddy/buddy-agent-harness",
+	"license": "MIT",
+	"keywords": ["agent", "skills", "harness", "claude-code", "codex"],
+	"skills": "./skills/"
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,16 @@
+{
+	"name": "buddy-agent-harness",
+	"version": "0.1.0",
+	"description": "Initialize standards-based agent configuration across coding-agent harnesses",
+	"author": {
+		"name": "repobuddy"
+	},
+	"repository": "https://github.com/repobuddy/buddy-agent-harness",
+	"license": "MIT",
+	"keywords": ["agent", "skills", "harness", "claude-code", "codex"],
+	"skills": "./skills/",
+	"interface": {
+		"displayName": "Buddy Agent Harness",
+		"category": "productivity"
+	}
+}

package/.cursor-plugin/plugin.json

@@ -0,0 +1,14 @@
+{
+	"name": "buddy-agent-harness",
+	"version": "0.1.0",
+	"description": "Initialize standards-based agent configuration across coding-agent harnesses",
+	"author": {
+		"name": "repobuddy"
+	},
+	"repository": "https://github.com/repobuddy/buddy-agent-harness",
+	"license": "MIT",
+	"keywords": ["agent", "skills", "harness", "claude-code", "codex"],
+	"skills": "./skills/",
+	"category": "productivity",
+	"tags": ["agent", "skills"]
+}

package/.plugin/plugin.json

@@ -0,0 +1,30 @@
+{
+	"$schema": "https://raw.githubusercontent.com/cyberuni/universal-plugin/refs/heads/main/schema/v1.json",
+	"name": "buddy-agent-harness",
+	"version": "0.1.0",
+	"description": "Initialize standards-based agent configuration across coding-agent harnesses",
+	"author": {
+		"name": "repobuddy"
+	},
+	"repository": "https://github.com/repobuddy/buddy-agent-harness",
+	"license": "MIT",
+	"keywords": ["agent", "skills", "harness", "claude-code", "codex"],
+	"skills": "./skills/",
+	"vendorExtensions": {
+		"claude-code": {},
+		"cursor": {
+			"category": "productivity",
+			"tags": ["agent", "skills"]
+		},
+		"codex": {
+			"interface": {
+				"displayName": "Buddy Agent Harness",
+				"category": "productivity"
+			}
+		},
+		"copilot-cli": {
+			"category": "productivity",
+			"tags": ["agent", "skills"]
+		}
+	}
+}

package/README.md

@@ -0,0 +1,37 @@
+# Buddy Agent Harness
+
+[![CI](https://github.com/repobuddy/buddy-agent-harness/actions/workflows/release.yml/badge.svg)](https://github.com/repobuddy/buddy-agent-harness/actions/workflows/release.yml)
+[![Codecov](https://codecov.io/gh/repobuddy/buddy-agent-harness/graph/badge.svg)](https://codecov.io/gh/repobuddy/buddy-agent-harness)
+[![npm](https://img.shields.io/npm/v/buddy-agent-harness)](https://www.npmjs.com/package/buddy-agent-harness)
+[![License](https://img.shields.io/npm/l/buddy-agent-harness)](LICENSE)
+
+An agent plugin and CLI for initializing or updating a consumer repository's standards-based agent configuration across coding-agent harnesses.
+
+## Install the plugin
+
+Install the portable plugin and its `init` skill with `npx skills`:
+
+```sh
+npx skills add repobuddy/buddy-agent-harness --plugin
+```
+
+In Claude Code, add the marketplace and install the plugin:
+
+```text
+/plugin marketplace add repobuddy/buddy-agent-harness
+/plugin install buddy-agent-harness@repobuddy
+```
+
+Other agent clients can install the same repository through their plugin marketplace or use the `npx skills` command above.
+
+## CLI
+
+After the npm package is published, run the CLI without a global installation:
+
+```sh
+npx -y buddy-agent-harness init
+```
+
+The repository root's `AGENTS.md` and `.agents/` tree are canonical: `.agents/AGENTS.md` holds shared behavior, `.agents/skills/**/SKILL.md` holds capabilities, and separately named files hold tool settings. The active harness is enabled by default; explicit user preferences add others. The command preserves user-authored configuration and projects only supported mappings; it records nothing on disk.
+
+Use `buddy-agent-harness init --help` to see `--root`, `--copy`, `--force`, and `--format`.

package/bin/buddy-agent-harness.mjs

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const dir = dirname(fileURLToPath(import.meta.url))
+const { main } = await import(join(dir, '..', 'dist', 'cli.mjs'))
+await main()

package/dist/cli.d.mts

@@ -0,0 +1,5 @@
+//#region src/cli.d.ts
+declare function main(): Promise<void>;
+//#endregion
+export { main };
+//# sourceMappingURL=cli.d.mts.map

package/dist/cli.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":";iBAGsB,QAAQ"}

package/dist/cli.mjs

@@ -0,0 +1,20 @@
+import { r as initCommand } from "./init.command-wxC4cgUc.mjs";
+import { cli } from "clibuilder";
+//#region src/cli.ts
+async function main() {
+	const app = cli({
+		name: "buddy-agent-harness",
+		version: "0.1.0",
+		description: "Initialize agent harness skill compatibility in consumer repositories."
+	});
+	try {
+		await app.command(initCommand).parse(process.argv);
+	} catch (error) {
+		process.stdout.write(`error: ${error instanceof Error ? error.message : "Invalid command."}\n`);
+		process.exitCode = 2;
+	}
+}
+//#endregion
+export { main };
+
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["import { cli } from 'clibuilder'\nimport { initCommand } from './initialize-harnesses/init.command.ts'\n\nexport async function main(): Promise<void> {\n\tconst app = cli({\n\t\tname: 'buddy-agent-harness',\n\t\tversion: '0.1.0',\n\t\tdescription: 'Initialize agent harness skill compatibility in consumer repositories.',\n\t})\n\ttry {\n\t\tawait app.command(initCommand).parse(process.argv)\n\t} catch (error) {\n\t\tprocess.stdout.write(`error: ${error instanceof Error ? error.message : 'Invalid command.'}\\n`)\n\t\tprocess.exitCode = 2\n\t}\n}\n"],"mappings":";;;AAGA,eAAsB,OAAsB;CAC3C,MAAM,MAAM,IAAI;EACf,MAAM;EACN,SAAS;EACT,aAAa;CACd,CAAC;CACD,IAAI;EACH,MAAM,IAAI,QAAQ,WAAW,CAAC,CAAC,MAAM,QAAQ,IAAI;CAClD,SAAS,OAAO;EACf,QAAQ,OAAO,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,mBAAmB,GAAG;EAC9F,QAAQ,WAAW;CACpB;AACD"}

package/dist/index.d.mts

@@ -0,0 +1,57 @@
+import { cli } from "clibuilder";
+//#region src/harness-registry/harness-registry.d.ts
+type HarnessName = "claude-code" | "cursor" | "codex" | "copilot-cli" | "gemini-cli" | "devin-desktop" | "windsurf";
+/**
+ * `skillsDirectory` is the projection target a harness needs to see `.agents/skills`.
+ * A harness that reads `.agents/skills` natively has none, and is never projected into.
+ */
+type Harness = {
+  name: HarnessName;
+  detect: string;
+  skillsDirectory?: string;
+  /** Set when this name has been superseded; the value is the name that replaces it. */
+  deprecated?: HarnessName;
+};
+/**
+ * Codex, Cursor, Copilot CLI, and Devin Desktop read `.agents/skills` directly, so they need no
+ * projection. Only Claude Code and Gemini CLI read solely their own directory.
+ *
+ * `windsurf` is the former name of Devin Desktop, rebranded 2026-06-02. It is retained as a
+ * deprecated alias: Devin still scans the legacy `.windsurf/skills` path, so its projection keeps
+ * working, but new repositories should enable `devin-desktop` and have nothing written for them.
+ *
+ * See `.research/agentic-configuration-standards/` for the per-harness sources.
+ */
+declare const harnessRegistry: readonly Harness[];
+//#endregion
+//#region src/initialize-harnesses/init.command.d.ts
+declare const initCommand: cli.Command;
+declare const harnessCommand: cli.Command;
+declare function activate({ addCommand }: {
+  addCommand(command: typeof harnessCommand): void;
+}): void;
+//#endregion
+//#region src/initialize-harnesses/initialize-harnesses.d.ts
+type InitializeOptions = {
+  root: string;
+  harnesses?: HarnessName[];
+  copy?: boolean;
+  force?: boolean;
+};
+type InitializeResult = {
+  root: string;
+  harnesses: HarnessName[];
+  native: HarnessName[];
+  linked: HarnessName[];
+  /** Enabled harnesses whose name has been superseded, as `{ name, replacedBy }`. */
+  deprecated: {
+    name: HarnessName;
+    replacedBy: HarnessName;
+  }[];
+  skills: number;
+  copied: boolean;
+};
+declare function initializeHarnesses({ root, harnesses: preferred, copy, force }: InitializeOptions): InitializeResult;
+//#endregion
+export { type HarnessName, type InitializeOptions, type InitializeResult, activate, harnessCommand, harnessRegistry, initCommand, initializeHarnesses };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/harness-registry/harness-registry.ts","../src/initialize-harnesses/init.command.ts","../src/initialize-harnesses/initialize-harnesses.ts"],"mappings":";;KAGY;;;;;KAaA;EACX,MAAM;EACN;EACA;;EAEA,aAAa;;;;;;;;;;;;cAaD,0BAA0B;;;cCxB1B,aAAa,IAAI;cAyDjB,gBAAgB,IAAI;iBAMjB,WAAW;EAAgB,WAAW,gBAAgB;;;;KCrE1D;EACX;EACA,YAAY;EACZ;EACA;;KAEW;EACX;EACA,WAAW;EACX,QAAQ;EACR,QAAQ;;EAER;IAAc,MAAM;IAAa,YAAY;;EAC7C;EACA;;iBAGe,sBACf,MACA,WAAW,WACX,MACA,SACE,oBAAoB"}

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { a as harnessRegistry, i as initializeHarnesses, n as harnessCommand, r as initCommand, t as activate } from "./init.command-wxC4cgUc.mjs";
+export { activate, harnessCommand, harnessRegistry, initCommand, initializeHarnesses };

package/dist/init.command-wxC4cgUc.mjs

@@ -0,0 +1,203 @@
+import { command, z } from "clibuilder";
+import { encode } from "@toon-format/toon";
+import { cpSync, lstatSync, mkdirSync, readdirSync, readlinkSync, rmSync, symlinkSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+//#region src/harness-registry/harness-registry.ts
+/**
+* Codex, Cursor, Copilot CLI, and Devin Desktop read `.agents/skills` directly, so they need no
+* projection. Only Claude Code and Gemini CLI read solely their own directory.
+*
+* `windsurf` is the former name of Devin Desktop, rebranded 2026-06-02. It is retained as a
+* deprecated alias: Devin still scans the legacy `.windsurf/skills` path, so its projection keeps
+* working, but new repositories should enable `devin-desktop` and have nothing written for them.
+*
+* See `.research/agentic-configuration-standards/` for the per-harness sources.
+*/
+const harnessRegistry = [
+	{
+		name: "claude-code",
+		detect: ".claude",
+		skillsDirectory: ".claude/skills"
+	},
+	{
+		name: "cursor",
+		detect: ".cursor"
+	},
+	{
+		name: "codex",
+		detect: ".codex"
+	},
+	{
+		name: "copilot-cli",
+		detect: ".github/skills"
+	},
+	{
+		name: "gemini-cli",
+		detect: ".gemini",
+		skillsDirectory: ".gemini/skills"
+	},
+	{
+		name: "devin-desktop",
+		detect: ".devin"
+	},
+	{
+		name: "windsurf",
+		detect: ".windsurf",
+		skillsDirectory: ".windsurf/skills",
+		deprecated: "devin-desktop"
+	}
+];
+/** Enabled whether or not the repository already contains their directories. */
+const defaultHarnesses = ["claude-code", "cursor"];
+function directoryExists(path) {
+	try {
+		return lstatSync(path).isDirectory();
+	} catch {
+		return false;
+	}
+}
+/** The default harnesses, plus the preferred ones, plus every harness whose directory is present. */
+function selectHarnesses(root, preferred) {
+	const enabled = /* @__PURE__ */ new Set([...defaultHarnesses, ...preferred]);
+	return harnessRegistry.filter((harness) => enabled.has(harness.name) || directoryExists(join(root, harness.detect)));
+}
+//#endregion
+//#region src/skill-projection/skill-projection.ts
+function skillNames(skillsDirectory) {
+	return readdirSync(skillsDirectory, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort();
+}
+function pathOccupied(path) {
+	try {
+		lstatSync(path);
+		return true;
+	} catch {
+		return false;
+	}
+}
+function isCorrectLink(target, source) {
+	return lstatSync(target).isSymbolicLink() && readlinkSync(target) === relative(dirname(target), source);
+}
+/** Creates the canonical directory when absent, so a fresh repository reports zero skills. */
+function countSkills(canonicalSkills) {
+	mkdirSync(canonicalSkills, { recursive: true });
+	return skillNames(canonicalSkills).length;
+}
+/**
+* Points every harness that cannot read `.agents/skills` at the canonical directory. Symlinking is
+* preferred; a platform that refuses the link falls back to a copy. Returns the projected harnesses.
+*/
+function projectSkills({ root, canonicalSkills, harnesses, copy, force }) {
+	const projections = harnesses.filter((harness) => harness.skillsDirectory).map((harness) => ({
+		harness,
+		target: join(root, harness.skillsDirectory)
+	}));
+	const conflicts = projections.filter(({ target }) => pathOccupied(target) && !isCorrectLink(target, canonicalSkills)).map(({ target }) => target);
+	if (conflicts.length && !force) throw new Error(`Refusing to replace existing skill targets:\n${conflicts.map((target) => `- ${target}`).join("\n")}`);
+	for (const { target } of projections) {
+		mkdirSync(dirname(target), { recursive: true });
+		if (pathOccupied(target) && isCorrectLink(target, canonicalSkills)) continue;
+		if (pathOccupied(target)) rmSync(target, {
+			recursive: true,
+			force: true
+		});
+		if (copy) {
+			cpSync(canonicalSkills, target, { recursive: true });
+			continue;
+		}
+		try {
+			symlinkSync(relative(dirname(target), canonicalSkills), target, "junction");
+		} catch (error) {
+			if (pathOccupied(target)) throw error;
+			cpSync(canonicalSkills, target, { recursive: true });
+		}
+	}
+	return projections.map(({ harness }) => harness.name);
+}
+//#endregion
+//#region src/initialize-harnesses/initialize-harnesses.ts
+function initializeHarnesses({ root, harnesses: preferred = [], copy = false, force = false }) {
+	const canonicalSkills = join(root, ".agents", "skills");
+	const skills = countSkills(canonicalSkills);
+	const harnesses = selectHarnesses(root, preferred);
+	const linked = projectSkills({
+		root,
+		canonicalSkills,
+		harnesses,
+		copy,
+		force
+	});
+	return {
+		root,
+		harnesses: harnesses.map((harness) => harness.name),
+		native: harnesses.filter((harness) => !harness.skillsDirectory).map((harness) => harness.name),
+		linked,
+		deprecated: harnesses.filter((harness) => harness.deprecated).map((harness) => ({
+			name: harness.name,
+			replacedBy: harness.deprecated
+		})),
+		skills,
+		copied: copy
+	};
+}
+//#endregion
+//#region src/initialize-harnesses/init.command.ts
+function write(value, format) {
+	process.stdout.write(`${format === "json" ? JSON.stringify(value) : encode(value)}\n`);
+}
+const initCommand = command({
+	name: "init",
+	description: "Set up canonical agent skills for the harnesses already enabled in a repository.",
+	options: {
+		root: {
+			description: "Repository or package directory. Defaults to the current directory.",
+			type: z.optional(z.string())
+		},
+		harness: {
+			description: "Comma-separated harnesses to enable in addition to Claude Code and Cursor, e.g. codex,windsurf.",
+			type: z.optional(z.string())
+		},
+		copy: {
+			description: "Copy skills instead of linking them.",
+			type: z.optional(z.boolean())
+		},
+		force: {
+			description: "Replace conflicting target skill directories.",
+			type: z.optional(z.boolean())
+		},
+		format: {
+			description: "Output format: toon (default) or json.",
+			type: z.optional(z.string()),
+			default: "toon"
+		}
+	},
+	run(args) {
+		try {
+			const format = args.format;
+			if (format !== "toon" && format !== "json") throw new Error("--format must be toon or json.");
+			const requested = args.harness?.split(",").map((name) => name.trim()).filter(Boolean);
+			const unsupported = requested?.filter((name) => !harnessRegistry.some((harness) => harness.name === name));
+			if (unsupported?.length) throw new Error(`Unsupported harness: ${unsupported.join(", ")}. Supported: ${harnessRegistry.map((harness) => harness.name).join(", ")}.`);
+			write(initializeHarnesses({
+				root: args.root ?? process.cwd(),
+				...requested?.length ? { harnesses: requested } : {},
+				...args.copy === void 0 ? {} : { copy: args.copy },
+				...args.force === void 0 ? {} : { force: args.force }
+			}), format);
+		} catch (error) {
+			process.stderr.write(`error: ${error instanceof Error ? error.message : "Harness initialization failed."}\n`);
+			process.exitCode = 1;
+		}
+	}
+});
+const harnessCommand = command({
+	name: "harness",
+	description: "Commands for configuring agent harness compatibility.",
+	commands: [initCommand]
+});
+function activate({ addCommand }) {
+	addCommand(harnessCommand);
+}
+//#endregion
+export { harnessRegistry as a, initializeHarnesses as i, harnessCommand as n, initCommand as r, activate as t };
+
+//# sourceMappingURL=init.command-wxC4cgUc.mjs.map

package/dist/init.command-wxC4cgUc.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.command-wxC4cgUc.mjs","names":[],"sources":["../src/harness-registry/harness-registry.ts","../src/skill-projection/skill-projection.ts","../src/initialize-harnesses/initialize-harnesses.ts","../src/initialize-harnesses/init.command.ts"],"sourcesContent":["import { lstatSync } from 'node:fs'\nimport { join } from 'node:path'\n\nexport type HarnessName =\n\t| 'claude-code'\n\t| 'cursor'\n\t| 'codex'\n\t| 'copilot-cli'\n\t| 'gemini-cli'\n\t| 'devin-desktop'\n\t| 'windsurf'\n\n/**\n * `skillsDirectory` is the projection target a harness needs to see `.agents/skills`.\n * A harness that reads `.agents/skills` natively has none, and is never projected into.\n */\nexport type Harness = {\n\tname: HarnessName\n\tdetect: string\n\tskillsDirectory?: string\n\t/** Set when this name has been superseded; the value is the name that replaces it. */\n\tdeprecated?: HarnessName\n}\n\n/**\n * Codex, Cursor, Copilot CLI, and Devin Desktop read `.agents/skills` directly, so they need no\n * projection. Only Claude Code and Gemini CLI read solely their own directory.\n *\n * `windsurf` is the former name of Devin Desktop, rebranded 2026-06-02. It is retained as a\n * deprecated alias: Devin still scans the legacy `.windsurf/skills` path, so its projection keeps\n * working, but new repositories should enable `devin-desktop` and have nothing written for them.\n *\n * See `.research/agentic-configuration-standards/` for the per-harness sources.\n */\nexport const harnessRegistry: readonly Harness[] = [\n\t{ name: 'claude-code', detect: '.claude', skillsDirectory: '.claude/skills' },\n\t{ name: 'cursor', detect: '.cursor' },\n\t{ name: 'codex', detect: '.codex' },\n\t{ name: 'copilot-cli', detect: '.github/skills' },\n\t{ name: 'gemini-cli', detect: '.gemini', skillsDirectory: '.gemini/skills' },\n\t{ name: 'devin-desktop', detect: '.devin' },\n\t{ name: 'windsurf', detect: '.windsurf', skillsDirectory: '.windsurf/skills', deprecated: 'devin-desktop' },\n]\n\n/** Enabled whether or not the repository already contains their directories. */\nconst defaultHarnesses: readonly HarnessName[] = ['claude-code', 'cursor']\n\nfunction directoryExists(path: string): boolean {\n\ttry {\n\t\treturn lstatSync(path).isDirectory()\n\t} catch {\n\t\treturn false\n\t}\n}\n\n/** The default harnesses, plus the preferred ones, plus every harness whose directory is present. */\nexport function selectHarnesses(root: string, preferred: readonly HarnessName[]): Harness[] {\n\tconst enabled = new Set<HarnessName>([...defaultHarnesses, ...preferred])\n\treturn harnessRegistry.filter((harness) => enabled.has(harness.name) || directoryExists(join(root, harness.detect)))\n}\n","import { cpSync, lstatSync, mkdirSync, readdirSync, readlinkSync, rmSync, symlinkSync } from 'node:fs'\nimport { dirname, join, relative } from 'node:path'\nimport type { Harness, HarnessName } from '../harness-registry/harness-registry.ts'\n\nfunction skillNames(skillsDirectory: string): string[] {\n\treturn readdirSync(skillsDirectory, { withFileTypes: true })\n\t\t.filter((entry) => entry.isDirectory())\n\t\t.map((entry) => entry.name)\n\t\t.sort()\n}\n\nfunction pathOccupied(path: string): boolean {\n\ttry {\n\t\tlstatSync(path)\n\t\treturn true\n\t} catch {\n\t\treturn false\n\t}\n}\n\nfunction isCorrectLink(target: string, source: string): boolean {\n\treturn lstatSync(target).isSymbolicLink() && readlinkSync(target) === relative(dirname(target), source)\n}\n\n/** Creates the canonical directory when absent, so a fresh repository reports zero skills. */\nexport function countSkills(canonicalSkills: string): number {\n\tmkdirSync(canonicalSkills, { recursive: true })\n\treturn skillNames(canonicalSkills).length\n}\n\nexport type ProjectSkillsOptions = {\n\troot: string\n\tcanonicalSkills: string\n\tharnesses: readonly Harness[]\n\tcopy: boolean\n\tforce: boolean\n}\n\n/**\n * Points every harness that cannot read `.agents/skills` at the canonical directory. Symlinking is\n * preferred; a platform that refuses the link falls back to a copy. Returns the projected harnesses.\n */\nexport function projectSkills({ root, canonicalSkills, harnesses, copy, force }: ProjectSkillsOptions): HarnessName[] {\n\tconst projections = harnesses\n\t\t.filter((harness) => harness.skillsDirectory)\n\t\t.map((harness) => ({\n\t\t\tharness,\n\t\t\ttarget: join(root, harness.skillsDirectory as string),\n\t\t}))\n\n\tconst conflicts = projections\n\t\t.filter(({ target }) => pathOccupied(target) && !isCorrectLink(target, canonicalSkills))\n\t\t.map(({ target }) => target)\n\n\tif (conflicts.length && !force) {\n\t\tthrow new Error(\n\t\t\t`Refusing to replace existing skill targets:\\n${conflicts.map((target) => `- ${target}`).join('\\n')}`,\n\t\t)\n\t}\n\n\tfor (const { target } of projections) {\n\t\tmkdirSync(dirname(target), { recursive: true })\n\t\tif (pathOccupied(target) && isCorrectLink(target, canonicalSkills)) continue\n\t\tif (pathOccupied(target)) rmSync(target, { recursive: true, force: true })\n\t\tif (copy) {\n\t\t\tcpSync(canonicalSkills, target, { recursive: true })\n\t\t\tcontinue\n\t\t}\n\t\ttry {\n\t\t\tsymlinkSync(relative(dirname(target), canonicalSkills), target, 'junction')\n\t\t} catch (error) {\n\t\t\tif (pathOccupied(target)) throw error\n\t\t\tcpSync(canonicalSkills, target, { recursive: true })\n\t\t}\n\t}\n\n\treturn projections.map(({ harness }) => harness.name)\n}\n","import { join } from 'node:path'\nimport { type HarnessName, selectHarnesses } from '../harness-registry/harness-registry.ts'\nimport { countSkills, projectSkills } from '../skill-projection/skill-projection.ts'\n\nexport type InitializeOptions = {\n\troot: string\n\tharnesses?: HarnessName[]\n\tcopy?: boolean\n\tforce?: boolean\n}\nexport type InitializeResult = {\n\troot: string\n\tharnesses: HarnessName[]\n\tnative: HarnessName[]\n\tlinked: HarnessName[]\n\t/** Enabled harnesses whose name has been superseded, as `{ name, replacedBy }`. */\n\tdeprecated: { name: HarnessName; replacedBy: HarnessName }[]\n\tskills: number\n\tcopied: boolean\n}\n\nexport function initializeHarnesses({\n\troot,\n\tharnesses: preferred = [],\n\tcopy = false,\n\tforce = false,\n}: InitializeOptions): InitializeResult {\n\tconst canonicalSkills = join(root, '.agents', 'skills')\n\tconst skills = countSkills(canonicalSkills)\n\tconst harnesses = selectHarnesses(root, preferred)\n\tconst linked = projectSkills({ root, canonicalSkills, harnesses, copy, force })\n\n\treturn {\n\t\troot,\n\t\tharnesses: harnesses.map((harness) => harness.name),\n\t\tnative: harnesses.filter((harness) => !harness.skillsDirectory).map((harness) => harness.name),\n\t\tlinked,\n\t\tdeprecated: harnesses\n\t\t\t.filter((harness) => harness.deprecated)\n\t\t\t.map((harness) => ({ name: harness.name, replacedBy: harness.deprecated as HarnessName })),\n\t\tskills,\n\t\tcopied: copy,\n\t}\n}\n","import { encode } from '@toon-format/toon'\nimport type { cli } from 'clibuilder'\nimport { command, z } from 'clibuilder'\nimport { type HarnessName, harnessRegistry } from '../harness-registry/harness-registry.ts'\nimport { initializeHarnesses } from './initialize-harnesses.ts'\n\nfunction write(value: object, format: 'json' | 'toon' | undefined): void {\n\tprocess.stdout.write(`${format === 'json' ? JSON.stringify(value) : encode(value)}\\n`)\n}\n\nexport const initCommand: cli.Command = command({\n\tname: 'init',\n\tdescription: 'Set up canonical agent skills for the harnesses already enabled in a repository.',\n\toptions: {\n\t\troot: {\n\t\t\tdescription: 'Repository or package directory. Defaults to the current directory.',\n\t\t\ttype: z.optional(z.string()),\n\t\t},\n\t\tharness: {\n\t\t\tdescription: 'Comma-separated harnesses to enable in addition to Claude Code and Cursor, e.g. codex,windsurf.',\n\t\t\ttype: z.optional(z.string()),\n\t\t},\n\t\tcopy: {\n\t\t\tdescription: 'Copy skills instead of linking them.',\n\t\t\ttype: z.optional(z.boolean()),\n\t\t},\n\t\tforce: {\n\t\t\tdescription: 'Replace conflicting target skill directories.',\n\t\t\ttype: z.optional(z.boolean()),\n\t\t},\n\t\tformat: {\n\t\t\tdescription: 'Output format: toon (default) or json.',\n\t\t\ttype: z.optional(z.string()),\n\t\t\tdefault: 'toon',\n\t\t},\n\t},\n\trun(args) {\n\t\ttry {\n\t\t\tconst format = args.format\n\t\t\tif (format !== 'toon' && format !== 'json') throw new Error('--format must be toon or json.')\n\t\t\tconst requested = args.harness\n\t\t\t\t?.split(',')\n\t\t\t\t.map((name) => name.trim())\n\t\t\t\t.filter(Boolean)\n\t\t\tconst unsupported = requested?.filter((name) => !harnessRegistry.some((harness) => harness.name === name))\n\t\t\tif (unsupported?.length)\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Unsupported harness: ${unsupported.join(', ')}. Supported: ${harnessRegistry\n\t\t\t\t\t\t.map((harness) => harness.name)\n\t\t\t\t\t\t.join(', ')}.`,\n\t\t\t\t)\n\t\t\twrite(\n\t\t\t\tinitializeHarnesses({\n\t\t\t\t\troot: args.root ?? process.cwd(),\n\t\t\t\t\t...(requested?.length ? { harnesses: requested as HarnessName[] } : {}),\n\t\t\t\t\t...(args.copy === undefined ? {} : { copy: args.copy }),\n\t\t\t\t\t...(args.force === undefined ? {} : { force: args.force }),\n\t\t\t\t}),\n\t\t\t\tformat,\n\t\t\t)\n\t\t} catch (error) {\n\t\t\tprocess.stderr.write(`error: ${error instanceof Error ? error.message : 'Harness initialization failed.'}\\n`)\n\t\t\tprocess.exitCode = 1\n\t\t}\n\t},\n})\n\nexport const harnessCommand: cli.Command = command({\n\tname: 'harness',\n\tdescription: 'Commands for configuring agent harness compatibility.',\n\tcommands: [initCommand],\n})\n\nexport function activate({ addCommand }: { addCommand(command: typeof harnessCommand): void }): void {\n\taddCommand(harnessCommand)\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,69 @@
+{
+	"name": "buddy-agent-harness",
+	"version": "0.1.0",
+	"description": "Initialize standards-based agent configuration across coding-agent harnesses",
+	"keywords": [
+		"repobuddy",
+		"agent",
+		"skills",
+		"claude-code",
+		"codex",
+		"cursor"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/repobuddy/buddy-agent-harness.git"
+	},
+	"bugs": "https://github.com/repobuddy/buddy-agent-harness/issues",
+	"homepage": "https://github.com/repobuddy/buddy-agent-harness#readme",
+	"author": {
+		"name": "repobuddy"
+	},
+	"type": "module",
+	"bin": {
+		"buddy-agent-harness": "./bin/buddy-agent-harness.mjs"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.mts",
+			"default": "./dist/index.mjs"
+		}
+	},
+	"files": [
+		"bin",
+		"dist",
+		"src",
+		"!**/*.{test,spec}.ts",
+		"skills",
+		"plugin.json",
+		".plugin",
+		".claude-plugin",
+		".cursor-plugin",
+		".codex-plugin"
+	],
+	"scripts": {
+		"build": "tsdown",
+		"coverage": "vitest run --coverage",
+		"dev": "node bin/buddy-agent-harness.mjs",
+		"prepack": "pnpm build",
+		"test": "vitest run",
+		"test:dist": "tsc --noEmit -p tsconfig.dist.json && vitest run --config vitest.dist.config.ts",
+		"typecheck": "tsc --noEmit"
+	},
+	"engines": {
+		"node": ">=22"
+	},
+	"dependencies": {
+		"@toon-format/toon": "^4.1.1",
+		"clibuilder": "^10.0.0"
+	},
+	"devDependencies": {
+		"@types/node": "^24.12.4",
+		"@vitest/coverage-v8": "^4.1.0",
+		"tsdown": "^0.22.0",
+		"tsx": "^4.22.3",
+		"typescript": "^7.0.0",
+		"vitest": "^4.1.0"
+	}
+}

package/plugin.json

@@ -0,0 +1,14 @@
+{
+	"name": "buddy-agent-harness",
+	"version": "0.1.0",
+	"description": "Initialize standards-based agent configuration across coding-agent harnesses",
+	"author": {
+		"name": "repobuddy"
+	},
+	"repository": "https://github.com/repobuddy/buddy-agent-harness",
+	"license": "MIT",
+	"keywords": ["agent", "skills", "harness", "claude-code", "codex"],
+	"skills": "./skills/",
+	"category": "productivity",
+	"tags": ["agent", "skills"]
+}

package/skills/init/README.md

@@ -0,0 +1,29 @@
+# Harness Init
+
+Give a repository one canonical agent configuration — a root `AGENTS.md` and an `.agents/` tree — and bridge the harnesses that cannot read it directly.
+
+## What it does
+
+The skill runs a five-phase workflow: survey the repository, classify what it finds, confirm the plan with you, apply it, then verify.
+
+It detects agent configuration you already have — instruction files, skills, commands, subagents, rules, MCP servers, hooks — and either consolidates it into the canonical source, links it back out, or reports it as canonical-only where no safe cross-harness mapping exists. It never removes or rewrites a file you authored without asking first.
+
+## Why the projection step is small
+
+Codex, Cursor, GitHub Copilot CLI, and Devin Desktop read `.agents/skills/` natively, so they need nothing. Only Claude Code and Gemini CLI need a link:
+
+```sh
+npx -y buddy-agent-harness init
+```
+
+Claude Code also reads `CLAUDE.md` rather than `AGENTS.md`, so the skill sets up a `CLAUDE.md` that imports `@AGENTS.md`.
+
+`references/standard.md` defines the baseline every repository gets from the open standards. `references/harnesses/<harness>.md` covers what each harness needs on top of that baseline — and how well-sourced each claim is. `SKILL.md` routes to them directly.
+
+## The part that needs care
+
+Linking is easy; frontmatter is not. Each harness recognizes a different set of `SKILL.md` fields and silently drops the rest, so anything that must hold everywhere belongs in the Markdown body rather than in a harness-specific field. See `references/frontmatter.md`.
+
+## Boundaries
+
+Local agent configuration only. The skill does not invent instructions, convert tool settings without a documented mapping, or change CI, GitHub settings, security scanning, or branch rules.