agents-md-gen 0.1.0 → 0.2.0

package/README.md

@@ -20,8 +20,22 @@ on immediately.
 - **Rust** — Cargo, workspaces, clippy
 - **Go** — go.mod, golangci-lint
 - **Ruby** — Bundler, RSpec
+- **Java/Kotlin** — Maven, Gradle (with wrapper detection)
 - CI (GitHub Actions), license, and top-level project structure
 
+## GitHub Action
+
+Use it directly in CI without installing anything:
+
+```yaml
+- uses: Peshino2012/PD1@claude/busy-newton-5h97oh
+  with:
+    directory: .
+    also-claude-md: 'true'
+```
+
+(pin to a tagged release instead of a branch once one exists)
+
 A repo can match more than one of these (e.g. a Python backend next to a
 Node frontend) — each detected stack gets its own section.
 
@@ -39,6 +53,40 @@ It won't overwrite an existing `AGENTS.md`/`CLAUDE.md` unless you pass
 `--force` — this is meant to bootstrap a file you then edit by hand, not to
 clobber one you already wrote.
 
+## Example
+
+Real output — this is what `npx agents-md-gen` produces when run against
+this package's own repo:
+
+````markdown
+# AGENTS.md
+
+> Generated by [agents-md-gen](https://www.npmjs.com/package/agents-md-gen) — a starting point, edit freely.
+
+## Node.js
+**agents-md-gen** — package manager: npm
+
+### Commands
+
+- Install: `npm install`
+- Test: `npm run test`
+
+## Structure
+
+- `.github/` — GitHub config (CI, templates)
+- `LICENSE`
+- `README.md`
+- `bin/` — CLI entry points
+- `package.json`
+- `src/` — source code
+- `test/` — tests
+
+## Notes
+
+- CI: GitHub Actions (test.yml)
+- License: MIT
+````
+
 ## Why
 
 Most `AGENTS.md`/`CLAUDE.md` files either don't exist yet, or are a stale

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "agents-md-gen",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Generate a solid AGENTS.md / CLAUDE.md for any repo by detecting its stack, commands, and structure",
   "license": "MIT",
   "bin": {
-    "agents-md-gen": "./bin/cli.js"
+    "agents-md-gen": "bin/cli.js"
   },
   "main": "src/index.js",
   "files": [
@@ -18,6 +18,17 @@
     "agents.md",
     "claude.md",
     "ai-agents",
+    "ai-coding-agent",
+    "coding-agent",
+    "claude-code",
+    "cursor",
+    "windsurf",
+    "github-copilot",
+    "openai-codex",
+    "readme-generator",
+    "java",
+    "maven",
+    "gradle",
     "cli",
     "codegen",
     "developer-tools"

package/src/detect.js

@@ -165,6 +165,50 @@ function detectGo(root) {
   };
 }
 
+function detectJava(root) {
+  const hasGradle = exists(root, 'build.gradle') || exists(root, 'build.gradle.kts');
+  const hasMaven = exists(root, 'pom.xml');
+  if (!hasGradle && !hasMaven) return null;
+
+  if (hasGradle) {
+    const gradleCmd = exists(root, 'gradlew') ? './gradlew' : 'gradle';
+    return {
+      ecosystem: 'Java/Kotlin (Gradle)',
+      name: null,
+      description: null,
+      packageManager: 'gradle',
+      frameworks: [],
+      testFramework: null,
+      commands: {
+        install: `${gradleCmd} build`,
+        build: `${gradleCmd} build`,
+        test: `${gradleCmd} test`,
+        lint: null,
+        dev: null,
+      },
+    };
+  }
+
+  const pom = readText(root, 'pom.xml') || '';
+  const nameMatch = pom.match(/<artifactId>([^<]+)<\/artifactId>/);
+  const mvnCmd = exists(root, 'mvnw') ? './mvnw' : 'mvn';
+  return {
+    ecosystem: 'Java (Maven)',
+    name: nameMatch ? nameMatch[1] : null,
+    description: null,
+    packageManager: 'maven',
+    frameworks: [],
+    testFramework: null,
+    commands: {
+      install: `${mvnCmd} install`,
+      build: `${mvnCmd} package`,
+      test: `${mvnCmd} test`,
+      lint: null,
+      dev: null,
+    },
+  };
+}
+
 function detectRuby(root) {
   if (!exists(root, 'Gemfile')) return null;
   const hasRspec = exists(root, '.rspec') || exists(root, 'spec');
@@ -223,7 +267,7 @@ function detectLicense(root) {
 }
 
 function detectProject(root) {
-  const detectors = [detectNode, detectPython, detectRust, detectGo, detectRuby];
+  const detectors = [detectNode, detectPython, detectRust, detectGo, detectRuby, detectJava];
   const stacks = detectors.map((fn) => fn(root)).filter(Boolean);
 
   return {