agents-md-gen 0.3.0 → 0.4.0

package/README.md

@@ -21,6 +21,8 @@ on immediately.
 - **Go** — go.mod, golangci-lint
 - **Ruby** — Bundler, RSpec
 - **Java/Kotlin** — Maven, Gradle (with wrapper detection)
+- **Monorepos** — Turborepo, Nx, Lerna, npm/yarn/pnpm workspaces, listing
+  each detected sub-package
 - CI (GitHub Actions), license, and top-level project structure
 
 ## GitHub Action

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-md-gen",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Generate a solid AGENTS.md / CLAUDE.md for any repo by detecting its stack, commands, and structure",
   "license": "MIT",
   "bin": {
@@ -29,6 +29,9 @@
     "java",
     "maven",
     "gradle",
+    "monorepo",
+    "turborepo",
+    "nx",
     "cli",
     "codegen",
     "developer-tools"

package/src/detect.js

@@ -272,6 +272,50 @@ function detectLicense(root) {
   return null;
 }
 
+function detectMonorepo(root) {
+  const pkg = readJson(root, 'package.json');
+  const patterns = [];
+
+  if (pkg && Array.isArray(pkg.workspaces)) {
+    patterns.push(...pkg.workspaces);
+  } else if (pkg && pkg.workspaces && Array.isArray(pkg.workspaces.packages)) {
+    patterns.push(...pkg.workspaces.packages);
+  }
+
+  const pnpmWorkspace = readText(root, 'pnpm-workspace.yaml');
+  if (pnpmWorkspace) {
+    for (const m of pnpmWorkspace.matchAll(/^\s*-\s*['"]?([^'"\n]+)['"]?\s*$/gm)) {
+      patterns.push(m[1].trim());
+    }
+  }
+
+  const tool = exists(root, 'turbo.json') ? 'Turborepo'
+    : exists(root, 'nx.json') ? 'Nx'
+    : exists(root, 'lerna.json') ? 'Lerna'
+    : patterns.length ? 'workspaces'
+    : null;
+
+  if (!tool) return null;
+
+  const packages = new Set();
+  for (const pattern of patterns) {
+    const dirPath = path.join(root, pattern.replace(/\/\*+$/, ''));
+    let entries;
+    try {
+      entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const e of entries) {
+      if (!e.isDirectory()) continue;
+      const subPkg = readJson(dirPath, e.name, 'package.json');
+      if (subPkg) packages.add(subPkg.name || e.name);
+    }
+  }
+
+  return { tool, packages: [...packages].sort() };
+}
+
 function detectProject(root) {
   const detectors = [detectNode, detectPython, detectRust, detectGo, detectRuby, detectJava];
   const stacks = detectors.map((fn) => fn(root)).filter(Boolean);
@@ -279,6 +323,7 @@ function detectProject(root) {
   return {
     root,
     stacks,
+    monorepo: detectMonorepo(root),
     structure: listStructure(root),
     ci: detectCI(root),
     license: detectLicense(root),

package/src/render.js

@@ -51,6 +51,16 @@ function renderStack(stack) {
   return parts.join('\n');
 }
 
+function renderMonorepo(monorepo) {
+  if (!monorepo) return null;
+  const lines = [`This is a monorepo (${monorepo.tool}).`];
+  if (monorepo.packages.length) {
+    lines.push('', 'Packages:', '');
+    lines.push(...monorepo.packages.map((p) => `- \`${p}\``));
+  }
+  return ['## Monorepo', '', ...lines].join('\n');
+}
+
 function renderStructure(structure) {
   if (!structure.length) return null;
   const lines = structure.map((entry) => {
@@ -87,6 +97,9 @@ function renderAgentsMd(project) {
     }
   }
 
+  const monorepo = renderMonorepo(project.monorepo);
+  if (monorepo) sections.push('', monorepo);
+
   const structure = renderStructure(project.structure);
   if (structure) sections.push('', structure);