{
  "markdown": "# jhipster-forge\n\n> The first dedicated Claude Code plugin for JHipster 8.x\n\nGenerate JHipster entities, DTOs, JDL models, services and more — directly from Claude Code, with production-grade architectural patterns built-in.\n\n## Features\n\n- **Entity generation** with guided field/relationship collection\n- **JDL modeling** from natural language descriptions\n- **Architectural patterns** auto-applied: Sealed Interface + Records, Strategy+Registry, Collect-Then-Fail validation, MapStruct polymorphic mapping\n- **Microservices/Gateway** support with Keycloak/OAuth2 guidance\n- **Auto-detection** of JHipster projects at session start\n\n## Prerequisites\n\n- [JHipster 8.x](https://www.jhipster.tech/) (`npm install -g generator-jhipster`)\n- Java 17+\n- Node.js 18+\n- Maven or Gradle\n\n## Installation\n\n```bash\nclaude plugin install https://github.com/bngesp/jhipster-forge\n```\n\n## Commands\n\n| Command | Description |\n|---|---|\n| `/jhipster-forge:forge-new [monolith\\|microservice\\|gateway]` | Scaffold a new JHipster project |\n| `/jhipster-forge:forge-entity [EntityName]` | Generate an entity with fields and relationships |\n| `/jhipster-forge:forge-jdl [description\\|file.jdl]` | Create/import a JDL domain model |\n| `/jhipster-forge:forge-service [EntityName]` | Generate a Spring service layer |\n| `/jhipster-forge:forge-controller [EntityName]` | Generate a Spring REST controller |\n| `/jhipster-forge:forge-dto [EntityName]` | Generate a sealed interface + records DTO hierarchy with MapStruct mapper |\n| `/jhipster-forge:forge-validator [EntityName]` | Generate a Strategy+Registry validation layer with error accumulation |\n| `/jhipster-forge:forge-test [EntityName]` | Generate unit + integration tests for an entity's layers |\n| `/jhipster-forge:forge-liquibase` | Generate a Liquibase diff changelog |\n\n## Agents\n\n### `jdl-architect`\nDesigns complete JDL models from natural language. Describe your domain, get a production-ready `.jdl` file.\n\n**Example:**\n> \"I need a JDL for an e-commerce app with products, categories, orders and customers\"\n\n### `forge-reviewer`\nReviews JHipster-generated code for architectural pattern compliance. Triggered automatically after entity generation.\n\n## Skills (Auto-activated)\n\n| Skill | Triggers on |\n|---|---|\n| `entity-generation` | Entity creation, domain modeling |\n| `jdl-modeling` | JDL files, domain language questions |\n| `architecture-patterns` | Sealed Interface, Strategy, validation, MapStruct |\n| `microservices-gateway` | Microservice, gateway, Keycloak, Eureka |\n| `testing-patterns` | Unit/integration tests, Testcontainers, JUnit, Mockito |\n\n## Hooks\n\n**Session start** — if a `.yo-rc.json` is detected in the project root, Claude displays:\n```\n⚡ JHipster project detected: myApp (monolith, oauth2, postgresql) — use /jhipster-forge:forge-entity, /jhipster-forge:forge-jdl and more.\n```\n\n**Guard-rails (PreToolUse)**:\n- 🔒 **Blocks** edits to committed Liquibase changelogs — schema changes must go in a new changelog (checksums break on migrated databases); freshly generated, uncommitted changelogs stay editable\n- ⚠️ **Warns** on Java anti-patterns: `@Slf4j` (use `LoggerFactory`), field `@Autowired` (use constructor injection), `Double`/`Float` for monetary fields (use `BigDecimal`), `@Enumerated` without `EnumType.STRING`\n\n## Architectural Patterns\n\nThis plugin is opinionated and applies these patterns from the Spring Boot 3.x + JHipster 8.x stack:\n\n- **Sealed Interface + Records** — type-safe polymorphic DTOs (Java 17+)\n- **Strategy + Registry** — polymorphic validation via Spring-injected `Map<String, Validator>`\n- **Collect-Then-Fail** — `ValidationMonad` / `MessageList` for accumulating all errors\n- **Single Table Inheritance** — JPA entity hierarchy with `@DiscriminatorColumn`\n- **MapStruct Pattern Matching** — exhaustive mapping with Java 17 switch expressions\n- **RFC7807** — standardized HTTP error responses via Zalando Problem\n\n## Compatibility\n\n- JHipster 8.x\n- Spring Boot 3.x\n- Java 17+\n- Angular (frontend)\n- PostgreSQL (production), H2 (dev)\n- Monolith + Microservices/Gateway\n\n## Author\n\nBassirou Ngom — bassiroungom26@gmail.com\n\n## License\n\nMIT\n",
  "bytes": 4140,
  "sha": "336da2adf0af5a6711f3e494ede1947f513a006f47d4de73ce146752ade834be",
  "repo_slug": "bngesp/jhipster-forge",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_bngesp_jhipster_forge_jhipster_forge_27c9c26b/readme"
}