@apogeelabs/the-agency 0.1.1

package/README.md

@@ -0,0 +1,93 @@
+# @apogeelabs/the-agency
+
+Centralized Claude Code agents, commands, and workflows. Install once, sync to any project.
+
+## Install
+
+```bash
+npm install -D @apogeelabs/the-agency
+```
+
+## Usage
+
+```bash
+# Sync all agents, commands, and AI context files to your project
+npx the-agency sync
+
+# Choose which files to sync
+npx the-agency sync --pick
+```
+
+Files are copied to `.claude/agents/`, `.claude/commands/`, and `.ai/` in the target project. If destination files already exist, you'll be prompted before overwriting.
+
+## What's Included
+
+### Agents (`.claude/agents/`)
+
+Autonomous subagents that run in isolated context windows and communicate through files.
+
+| Agent             | Purpose                                                    |
+| ----------------- | ---------------------------------------------------------- |
+| **architect**     | Designs technical approach, produces build plans           |
+| **dev**           | Implements features from build plans, task by task         |
+| **explorer**      | Maps and documents unfamiliar codebases (read-only)        |
+| **pm**            | Produces product briefs from requirements                  |
+| **reviewer**      | Adversarial code review with pass/fail verdict (read-only) |
+| **test-hardener** | Writes edge case tests, tries to break things              |
+
+### Commands (`.claude/commands/`)
+
+Slash commands invoked in Claude Code sessions.
+
+| Command      | Purpose                                            |
+| ------------ | -------------------------------------------------- |
+| `/architect` | Interactive architecture design session            |
+| `/build`     | Orchestrates the full dev → review → test pipeline |
+| `/pm`        | Interactive product requirements discovery         |
+| `/review-pr` | Structured PR review briefing                      |
+
+### AI Context (`.ai/`)
+
+Reference material automatically available to Claude Code.
+
+| File                      | Purpose                                   |
+| ------------------------- | ----------------------------------------- |
+| **UnitTestGeneration.md** | TypeScript/Jest unit testing style guide  |
+| **UnitTestExamples.md**   | Working examples for the test style guide |
+| **workflow.md**           | Multi-agent development workflow guide    |
+
+## The Workflow
+
+```
+/pm → docs/briefs/[feature].md → /architect → docs/build-plans/[feature].md → /build
+```
+
+- **`/pm`** and **`/architect`** are interactive — back-and-forth conversations that produce documents
+- **`/build`** is autonomous — orchestrates dev, review, and test agents with automatic fix loops
+- Agents communicate only through the filesystem. No shared context. This is intentional.
+
+See `.ai/workflow.md` after syncing for the full workflow guide.
+
+## Project-Specific Configuration
+
+The sync does **not** copy `settings.local.json` or `settings.json` — those are project-specific. See the [Claude Code docs](https://docs.anthropic.com/en/docs/claude-code) for configuring permissions per-project.
+
+## Requirements
+
+- Node.js >= 22
+- Claude Code
+- GitHub CLI (`gh`) — required for `/review-pr` and PR-related operations
+
+## Development
+
+```bash
+pnpm install
+pnpm build       # Compile TypeScript → dist/
+pnpm test        # Run test suite
+```
+
+Versioning is managed with [changesets](https://github.com/changesets/changesets). To propose a version bump:
+
+```bash
+pnpm changeset
+```

package/bin/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+await import("../dist/cli.js");

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/cli.js

@@ -0,0 +1,20 @@
+import { sync } from "./sync.js";
+const args = process.argv.slice(2);
+const command = args[0];
+if (!command || command === "help" || command === "--help") {
+  console.log(`
+Usage: the-agency <command> [options]
+
+Commands:
+  sync          Sync all Claude Code files to the current project
+  sync --pick   Interactively select which files to sync
+`);
+  process.exit(0);
+}
+if (command === "sync") {
+  const pick = args.includes("--pick");
+  await sync({ pick });
+} else {
+  console.error(`Unknown command: ${command}`);
+  process.exit(1);
+}

package/dist/manifest.d.ts

@@ -0,0 +1,12 @@
+interface ManifestItem {
+    file: string;
+    description: string;
+}
+interface Manifest {
+    agents: ManifestItem[];
+    commands: ManifestItem[];
+    ai: ManifestItem[];
+}
+declare const manifest: Manifest;
+
+export { type Manifest, type ManifestItem, manifest };

package/dist/manifest.js

@@ -0,0 +1,24 @@
+const manifest = {
+  agents: [
+    { file: "architect.md", description: "Designs technical approach, produces build plans" },
+    { file: "dev.md", description: "Implements features from build plans" },
+    { file: "explorer.md", description: "Explores and maps unfamiliar codebases" },
+    { file: "pm.md", description: "Produces product briefs from requirements" },
+    { file: "reviewer.md", description: "Adversarial code review with pass/fail verdict" },
+    { file: "test-hardener.md", description: "Hardens test coverage, finds edge cases" }
+  ],
+  commands: [
+    { file: "architect.md", description: "Interactive architecture design sessions" },
+    { file: "build.md", description: "Build orchestrator pipeline" },
+    { file: "pm.md", description: "Interactive product requirements discovery" },
+    { file: "review-pr.md", description: "Structured PR review briefing" }
+  ],
+  ai: [
+    { file: "UnitTestGeneration.md", description: "TypeScript/Jest unit testing style guide" },
+    { file: "UnitTestExamples.md", description: "Reference examples for the test style guide" },
+    { file: "workflow.md", description: "Multi-agent development workflow guide" }
+  ]
+};
+export {
+  manifest
+};

package/dist/sync.d.ts

@@ -0,0 +1,14 @@
+import { ManifestItem } from './manifest.js';
+
+interface SyncFile {
+    src: string;
+    dest: string;
+    label: string;
+}
+declare function getFilesToSync(categories: Record<string, ManifestItem[]>): SyncFile[];
+declare function fileExists(path: string): Promise<boolean>;
+declare function sync({ pick }?: {
+    pick?: boolean | undefined;
+}): Promise<void>;
+
+export { fileExists, getFilesToSync, sync };

package/dist/sync.js

@@ -0,0 +1,97 @@
+import { resolve, dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { copyFile, mkdir, access } from "node:fs/promises";
+import prompts from "prompts";
+import { manifest } from "./manifest.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageRoot = resolve(__dirname, "..");
+const categoryConfig = {
+  agents: { src: "src/templates/.claude/agents", dest: ".claude/agents" },
+  commands: { src: "src/templates/.claude/commands", dest: ".claude/commands" },
+  ai: { src: "src/templates/.ai", dest: ".ai" }
+};
+function getFilesToSync(categories) {
+  const files = [];
+  for (const [category, items] of Object.entries(categories)) {
+    const config = categoryConfig[category];
+    for (const item of items) {
+      files.push({
+        src: join(packageRoot, config.src, item.file),
+        dest: join(process.cwd(), config.dest, item.file),
+        label: `${config.dest}/${item.file}`
+      });
+    }
+  }
+  return files;
+}
+async function fileExists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function sync({ pick = false } = {}) {
+  let selectedCategories;
+  if (pick) {
+    const choices = Object.entries(manifest).flatMap(
+      ([category, items]) => items.map((item) => ({
+        title: `${categoryConfig[category].dest}/${item.file}`,
+        description: item.description,
+        value: { category, item },
+        selected: true
+      }))
+    );
+    const { selected } = await prompts({
+      type: "multiselect",
+      name: "selected",
+      message: "Select files to sync",
+      choices,
+      instructions: false,
+      hint: "- Space to toggle, Enter to confirm"
+    });
+    if (!selected || selected.length === 0) {
+      console.log("Nothing selected. Exiting.");
+      return;
+    }
+    selectedCategories = {};
+    for (const { category, item } of selected) {
+      if (!selectedCategories[category]) selectedCategories[category] = [];
+      selectedCategories[category].push(item);
+    }
+  } else {
+    selectedCategories = { ...manifest };
+  }
+  const files = getFilesToSync(selectedCategories);
+  const existing = [];
+  for (const f of files) {
+    if (await fileExists(f.dest)) {
+      existing.push(f.label);
+    }
+  }
+  if (existing.length > 0) {
+    const { proceed } = await prompts({
+      type: "confirm",
+      name: "proceed",
+      message: `${existing.length} destination file(s) will be overwritten. Proceed?`,
+      initial: true
+    });
+    if (!proceed) {
+      console.log("Sync cancelled.");
+      return;
+    }
+  }
+  for (const f of files) {
+    await mkdir(dirname(f.dest), { recursive: true });
+    await copyFile(f.src, f.dest);
+    console.log(`  \u2713 ${f.label}`);
+  }
+  console.log(`
+Synced ${files.length} file(s).`);
+}
+export {
+  fileExists,
+  getFilesToSync,
+  sync
+};

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@apogeelabs/the-agency",
+  "version": "0.1.1",
+  "description": "Centralized Claude Code agents, commands, and workflows",
+  "type": "module",
+  "bin": {
+    "the-agency": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "src/templates/",
+    "!src/templates/.claude/settings*.json"
+  ],
+  "dependencies": {
+    "prompts": "^2.4.2"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "UNLICENSED",
+  "private": false,
+  "devDependencies": {
+    "@changesets/cli": "^2.29.8",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.2.3",
+    "@types/prompts": "^2.4.9",
+    "husky": "^9.1.7",
+    "jest": "^30.2.0",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.1",
+    "ts-jest": "^29.4.6",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "lint-staged": {
+    "*.{js,mjs,ts,css,md}": "prettier --write",
+    "*.{yml,yaml}": "prettier --write",
+    "*.json": "prettier --write"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "NODE_OPTIONS='--experimental-vm-modules' jest"
+  }
+}