Does it support Kafka configurations?

Yes, it specifically addresses Kafka producer and consumer namespace separation to avoid configuration ambiguity.

What is the primary purpose of this skill?

It ensures consistent and unambiguous naming for configuration keys in Java projects using Domain-Driven Design (DDD) and messaging patterns.

Which files does this skill typically modify?

It targets YAML configuration files such as application.yml and application-local.yml within the project's start module.

How does it handle breaking changes during renaming?

If requested, the skill can explicitly remove old configuration keys to ensure no fallback compatibility issues remain, maintaining a clean codebase.

Is this skill specific to the Persimmon scaffold?

While designed for the Persimmon Java DDD scaffold, its principles for separating producer/consumer concerns apply to most Kafka-based Java applications.

Java DDD Configuration Guardrails

Name: Java DDD Configuration Guardrails
Author: ryan-alexander-zhang

byryan-alexander-zhang

0•

API Development

Standardizes configuration naming conventions and YAML schema rules for messaging and workflow components in Java DDD projects.

This skill provides strict guidance for managing application configuration within the Persimmon Java DDD scaffold, focusing on messaging patterns like Outbox, Inbox, and Kafka integration. It ensures that configuration keys for producers, consumers, and workflow runners remain unambiguous, consistent, and well-documented across environment-specific YAML files. By enforcing clear namespace separation, it prevents configuration drift and facilitates clean migrations when renaming or removing legacy keys in complex distributed systems.

Key Features

01Automates updates to application.yaml and application-local.yaml files

020 GitHub stars

03Supports explicit breaking changes by removing legacy configuration keys

04Standardizes YAML key naming for Kafka, Outbox, and Inbox patterns

05Validates configuration wiring for workflow runners and schedulers

06Enforces clear namespace separation between producers and consumers

Use Cases

01Setting up new Kafka producer/consumer pairs with consistent naming conventions

02Refactoring ambiguous configuration keys in a Java DDD microservice

03Maintaining environment-specific YAML files within the Persimmon scaffold

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ryan-alexander-zhang/persimmon start-config-schema-guardrails

For use in Claude.ai and ChatGPT

Download Skill