agents-md-gen 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.13.0
+
+- **Multi-project repos**: when the root has no recognizable stack and isn't
+  a JS workspace monorepo, each immediate subdirectory is scanned. Every
+  stack found gets its own section, e.g. `## Go (\`api/\`)` with "Run these
+  commands from `api/`." Previously these repos only got "Couldn't
+  auto-detect a specific language/framework".
+
 ## 0.12.0
 
 - New **Typecheck** and **Format** commands in the generated file — what an

package/README.md

@@ -77,6 +77,9 @@ docker run --rm -v "$PWD":/workdir ghcr.io/peshino2012/agents-md-gen
 - **Julia** — `Project.toml`, Pkg test detection
 - **Monorepos** — Turborepo, Nx, Lerna, Rush, npm/yarn/pnpm workspaces,
   listing each detected sub-package
+- **Multi-project repos** — nothing at the root (e.g. `api/` in Go next to
+  `web/` in Node)? Each immediate subdirectory is scanned and gets its own
+  section saying where to run its commands
 - CI (GitHub Actions), license, and top-level project structure
 
 ## GitHub Action

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-md-gen",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Generate a solid AGENTS.md / CLAUDE.md for any repo by detecting its stack, commands, and structure",
   "license": "MIT",
   "homepage": "https://github.com/Peshino2012/homebrew-tap#readme",

package/src/detect.js

@@ -601,6 +601,19 @@ function detectDotnet(root) {
 // never match a freshly rendered one, breaking `--check`.
 const OWN_OUTPUT_FILES = new Set(['AGENTS.md', 'CLAUDE.md']);
 
+function listSubprojectDirs(root) {
+  let entries;
+  try {
+    entries = fs.readdirSync(root, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  return entries
+    .filter((e) => e.isDirectory() && !e.name.startsWith('.') && !IGNORE_DIRS.has(e.name))
+    .map((e) => e.name)
+    .sort();
+}
+
 function listStructure(root) {
   let entries;
   try {
@@ -713,12 +726,21 @@ function detectMonorepo(root) {
 
 function detectProject(root) {
   const detectors = [detectNode, detectDeno, detectPython, detectRust, detectGo, detectRuby, detectJava, detectPhp, detectDotnet, detectSwift, detectDart, detectElixir, detectCpp, detectHaskell, detectScala, detectZig, detectJulia];
-  const stacks = detectors.map((fn) => fn(root)).filter(Boolean);
+  let stacks = detectors.map((fn) => fn(root)).filter(Boolean);
+  const monorepo = detectMonorepo(root);
+
+  // Multi-project repos that aren't JS workspaces (e.g. api/ in Go next to
+  // web/ in Node) have nothing at the root; look one level down instead.
+  if (!stacks.length && !monorepo) {
+    stacks = listSubprojectDirs(root).flatMap((dir) =>
+      detectors.map((fn) => fn(path.join(root, dir))).filter(Boolean).map((stack) => ({ ...stack, dir })),
+    );
+  }
 
   return {
     root,
     stacks,
-    monorepo: detectMonorepo(root),
+    monorepo,
     structure: listStructure(root),
     ci: detectCI(root),
     license: detectLicense(root),

package/src/render.js

@@ -33,7 +33,8 @@ function renderCommands(stack) {
 }
 
 function renderStack(stack) {
-  const parts = [`## ${stack.ecosystem}`];
+  const parts = [stack.dir ? `## ${stack.ecosystem} (\`${stack.dir}/\`)` : `## ${stack.ecosystem}`];
+  if (stack.dir) parts.push(`Run these commands from \`${stack.dir}/\`.`, '');
   const meta = [];
   if (stack.name) meta.push(`**${stack.name}**`);
   if (stack.frameworks && stack.frameworks.length) meta.push(stack.frameworks.join(', '));