feat: add README and CLAUDE

Author: gate-guardian

CLAUDE.md

@@ -0,0 +1,63 @@
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## What This Project Is
+
+A Gradle **settings plugin** (`com.morphismmc.mod-dev-catalog`) that provides curated version catalogs for Minecraft mod development. Modders apply it in `settings.gradle.kts` to get pre-defined, versioned dependencies for a given Minecraft version/mod loader combination.
+
+## Build & Test Commands
+
+```bash
+./gradlew build --no-daemon          # Full build: compile, test, lint, detekt
+./gradlew test --no-daemon           # Unit tests only
+./gradlew functionalTest --no-daemon # Gradle TestKit integration tests
+./gradlew ktlint --no-daemon         # Kotlin code style check
+./gradlew detekt --no-daemon         # Static analysis
+./gradlew publish --no-daemon        # Publish (requires MAVEN_ADMIN_USERNAME / MAVEN_ADMIN_PASSWORD)
+```
+
+To run a single test class:
+```bash
+./gradlew test --tests "com.morphismmc.moddevcatalog.MyTest" --no-daemon
+./gradlew functionalTest --tests "com.morphismmc.moddevcatalog.CatalogPluginFunctionalTest" --no-daemon
+```
+
+## Architecture
+
+### Plugin Entry Points
+
+- [ModDevCatalogPlugin.kt](src/main/kotlin/com/morphismmc/moddevcatalog/ModDevCatalogPlugin.kt) — Implements `Plugin<Settings>`. Creates the `modDevCatalog` extension and is the only class registered in the plugin descriptor.
+- [ModDevCatalogExtension.kt](src/main/kotlin/com/morphismmc/moddevcatalog/ModDevCatalogExtension.kt) — All catalog loading and Gradle integration logic lives here (~116 lines).
+
+### Code Flow
+
+1. Consumer project applies `id("com.morphismmc.mod-dev-catalog")` in `settings.gradle.kts`.
+2. `ModDevCatalogPlugin.apply(settings)` creates the `modDevCatalog` extension.
+3. Consumer calls `modDevCatalog { catalog("1.20.1-forge") }`.
+4. `catalog(catalogId)` loads `/catalogs/{catalogId}.toml` from the plugin JAR's classpath, parses it with `tomlj`, and calls `settings.dependencyResolutionManagement.versionCatalogs.create(...)` to register versions, libraries, and bundles.
+5. A `settingsEvaluated` callback wires exclusive content repository rules — each group is restricted to its designated Maven repo to prevent dependency confusion.
+
+### Catalog TOML Format
+
+Catalogs live in [src/main/resources/catalogs/](src/main/resources/catalogs/). Custom sections map to Maven repositories:
+
+```toml
+[repositories]
+BlameJared = "https://maven.blamejared.com/"
+
+[versions]
+jei = "15.20.0.121"
+
+[BlameJared]
+jei-api = { group = "mezz.jei", name = "jei-1.20.1-common-api", version-ref = "jei" }
+
+[bundles]
+jei = ["jei-api", "jei-impl"]
+```
+
+### Key Build Details
+
+- **JDK 21** (`kotlin { jvmToolchain(21) }`)
+- `tomlj` (TOML parser) and its ANTLR runtime are **shaded** into the plugin JAR via the `shadow` plugin to avoid classpath conflicts.
+- Functional tests use a separate `functionalTest` source set with Gradle TestKit.
+- Configuration cache, build cache, and parallel builds are all enabled in `gradle.properties`.

README.md

@@ -0,0 +1,98 @@
+# Mod Dev Catalog
+
+A Gradle **settings plugin** that provides curated version catalogs for Minecraft mod development. Apply it once in `settings.gradle.kts` to get pre-configured, versioned library definitions for popular mods — no more copy-pasting Maven coordinates.
+
+## Supported Catalogs
+
+| Catalog ID        | Minecraft | Mod Loader          |
+|-------------------|-----------|---------------------|
+| `1.20.1-forge`    | 1.20.1    | Forge 47.4.3        |
+| `1.21.1-neoforge` | 1.21.1    | NeoForge            |
+
+## Setup
+
+### 1. Apply the plugin in `settings.gradle.kts`
+
+```kotlin
+plugins {
+    id("com.morphismmc.mod-dev-catalog") version "26.3.25"
+}
+
+modDevCatalog {
+    catalog("1.21.1-neoforge") // registers as catalog named "mods"
+}
+```
+
+The plugin is available from the [Gradle Plugin Portal](https://plugins.gradle.org/plugin/com.morphismmc.mod-dev-catalog) and the MorphismMC Maven repository (`https://maven.morphismmc.com/releases`).
+
+### 2. Use dependencies in `build.gradle.kts`
+
+The catalog is registered under the name `mods` by default. Alias kebab-case names (`jei-api`) become dot-accessor chains (`mods.jei.api`).
+
+```kotlin
+dependencies {
+    // Single library
+    compileOnly(mods.jei.api)
+
+    // Bundle (group of related libraries)
+    compileOnly(mods.bundles.jei)
+    runtimeOnly(mods.bundles.rei)
+}
+```
+
+To use a different catalog name, pass a second argument:
+
+```kotlin
+modDevCatalog {
+    catalog("1.21.1-neoforge", "modlibs")
+}
+// then: modlibs.jei.api, modlibs.bundles.jei, etc.
+```
+
+The plugin also automatically configures exclusive-content repository rules for each Maven repository, so Gradle resolves each group from the correct source.
+
+## Available Libraries
+
+### `1.21.1-neoforge`
+
+| Alias | Library |
+|---|---|
+| `jei.api` | JEI NeoForge API |
+| `jei.impl` | JEI NeoForge |
+| `rei.api` | REI NeoForge API |
+| `rei.impl` | REI NeoForge |
+| `rei.plugin` | REI Default Plugin NeoForge |
+| `patchouli` | Patchouli |
+| `emi` | EMI |
+| `jade` | Jade |
+| `ae2` | Applied Energistics 2 |
+| `kjs` | KubeJS NeoForge |
+| **`bundles.jei`** | jei.api + jei.impl |
+| **`bundles.rei`** | rei.api + rei.impl + rei.plugin |
+
+### `1.20.1-forge`
+
+| Alias | Library |
+|---|---|
+| `jei.api.common` | JEI Common API |
+| `jei.api.forge` | JEI Forge API |
+| `jei.impl` | JEI Forge |
+| `rei.api` | REI Forge API |
+| `rei.impl` | REI Forge |
+| `rei.plugin` | REI Default Plugin Forge |
+| `architectury` | Architectury Forge |
+| `jade` | Jade |
+| `modernui` | Modern UI |
+| `jecharacters` | Just Enough Characters |
+| `placebo` | Placebo |
+| `hostile.neural.networks` | Hostile Neural Networks |
+| `emi` | EMI |
+| `ftb.library` | FTB Library |
+| `appeng` | Applied Energistics 2 |
+| `mekanism` | Mekanism |
+| **`bundles.jei`** | jei.api.common + jei.api.forge + jei.impl |
+| **`bundles.rei`** | rei.api + rei.impl + rei.plugin |
+
+## License
+
+[MIT](LICENSE)