mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-06-11 02:33:10 +08:00
4ad5756899
* feat: expand Kiro adapter to full language coverage - Add 17 new agents (typescript, rust, kotlin, java, cpp, django, swift, fsharp, pytorch, mle, performance-optimizer) in both .md and .json formats - Add 25 new skills (rust, kotlin, java/spring, django, fastapi, nestjs, react, nextjs, cpp, swift, mle/pytorch, deep-research, strategic-compact, autonomous-loops, content-hash-cache-pattern) - Add 6 new language-specific steering files (rust, kotlin, java, cpp, php, ruby) - Add 3 new hooks (rust-check-on-edit, python-lint-on-edit, security-check-on-create) - Update README with expanded component inventory and documentation - Fix install.sh line endings for macOS compatibility Total Kiro components: 33 agents, 43 skills, 22 steering files, 13 hooks * fix: resolve P1/P2 violations in Kiro agents, skills, and steering - java-patterns.md: remove reference to non-existent quarkus-patterns skill - kotlin-patterns.md: fix insecure BuildConfig recommendation for secrets - swift-actor-persistence: fix Swift version claim (5.9+) and Dictionary crash - java-reviewer.md: add recursive framework detection + robust diff chain - kotlin-reviewer.md: replace unreliable diff detection with fallback chain - rust-reviewer.md: add diff fallback + make CI gating mandatory - jpa-patterns: add DISTINCT to fetch-join query to prevent duplicates - django-reviewer.md: add migration safety check, narrow save() rule, fix pytest-django behavior description * fix: resolve remaining violations in Kiro agents, skills, and docs Agents: - java-build-resolver.md: remove quarkus-patterns ref, fix 'Initialise' spelling - java-reviewer.json: remove quarkus-patterns ref from prompt - mle-reviewer.md, cpp-build-resolver.md, java-build-resolver.md, performance-optimizer.md: fix allowedTools 'read' -> 'fs_read' Hooks: - rust-check-on-edit: fix description to match askAgent behavior Skills: - content-hash-cache-pattern: hyphenate 'Content-Hash-Based' - cpp-testing: hyphenate 'real-time' - django-security: use placeholder secrets, fix CSRF_COOKIE_HTTPONLY=False - nestjs-patterns: add Logger to HttpExceptionFilter for non-Http errors - react-patterns: add React 19 compatibility note for useActionState - rust-patterns: remove edition-specific 'Rust 2024+' reference - springboot-patterns: cap exponential backoff, recommend Resilience4j - springboot-security: fix invalid @Query SQL injection example - swift-protocol-di-testing: add thread-safety doc comment to mock Docs: - README.md: fix Project Structure counts (33/43/22/13) * fix: sync README tree with counts, restore local diff in kotlin-reviewer, correct django FK index guidance - README.md: Project Structure tree now lists all 33 agents, 43 skills, 22 steering files, and 13 hooks (was showing old subset) - kotlin-reviewer.md: restore git diff --staged / git diff for local pre-commit review before falling back to HEAD~1 - django-reviewer.md: clarify that ForeignKey fields are indexed by default; only flag missing db_index on non-FK filter columns
111 lines
3.1 KiB
Markdown
111 lines
3.1 KiB
Markdown
---
|
|
inclusion: fileMatch
|
|
fileMatchPattern: "*.java"
|
|
description: Java-specific patterns, Spring Boot, and enterprise best practices.
|
|
---
|
|
|
|
# Java Patterns
|
|
|
|
> This file extends the common patterns with Java specific content.
|
|
|
|
## Immutability
|
|
|
|
- Prefer `record` for value types (Java 16+)
|
|
- Mark fields `final` by default — use mutable state only when required
|
|
- Return defensive copies: `List.copyOf()`, `Map.copyOf()`
|
|
|
|
```java
|
|
public record OrderSummary(Long id, String customerName, BigDecimal total) {}
|
|
```
|
|
|
|
## Modern Java Features
|
|
|
|
- **Records** for DTOs and value types (Java 16+)
|
|
- **Sealed classes** for closed type hierarchies (Java 17+)
|
|
- **Pattern matching** with `instanceof` (Java 16+)
|
|
- **Switch expressions** with arrow syntax (Java 14+)
|
|
|
|
```java
|
|
public sealed interface PaymentResult permits PaymentSuccess, PaymentFailure {}
|
|
record PaymentSuccess(String transactionId, BigDecimal amount) implements PaymentResult {}
|
|
record PaymentFailure(String errorCode, String message) implements PaymentResult {}
|
|
```
|
|
|
|
## Constructor Injection
|
|
|
|
Always use constructor injection — never field injection:
|
|
|
|
```java
|
|
// GOOD
|
|
public class NotificationService {
|
|
private final EmailSender emailSender;
|
|
public NotificationService(EmailSender emailSender) {
|
|
this.emailSender = emailSender;
|
|
}
|
|
}
|
|
|
|
// BAD — field injection
|
|
@Inject private EmailSender emailSender;
|
|
```
|
|
|
|
## Repository Pattern
|
|
|
|
```java
|
|
public interface OrderRepository {
|
|
Optional<Order> findById(Long id);
|
|
List<Order> findAll();
|
|
Order save(Order order);
|
|
void deleteById(Long id);
|
|
}
|
|
```
|
|
|
|
## Optional Usage
|
|
|
|
- Return `Optional<T>` from finder methods that may have no result
|
|
- Use `map()`, `flatMap()`, `orElseThrow()` — never call `get()` without `isPresent()`
|
|
- Never use `Optional` as a field type or method parameter
|
|
|
|
## Error Handling
|
|
|
|
- Prefer unchecked exceptions for domain errors
|
|
- Create domain-specific exceptions extending `RuntimeException`
|
|
- Never expose stack traces in API responses
|
|
|
|
```java
|
|
public class OrderNotFoundException extends RuntimeException {
|
|
public OrderNotFoundException(Long id) {
|
|
super("Order not found: id=" + id);
|
|
}
|
|
}
|
|
```
|
|
|
|
## Security
|
|
|
|
- Never hardcode secrets — use `System.getenv("API_KEY")`
|
|
- Always use parameterized queries (`PreparedStatement`, JPA, JDBC template)
|
|
- Use Bean Validation (`@NotNull`, `@NotBlank`, `@Size`) on DTOs
|
|
- Store passwords with bcrypt or Argon2
|
|
|
|
## Testing
|
|
|
|
- JUnit 5 with AssertJ for fluent assertions
|
|
- Mockito for mocking dependencies
|
|
- Testcontainers for integration tests
|
|
- Target 80%+ coverage with JaCoCo
|
|
|
|
```java
|
|
@Test
|
|
@DisplayName("findById returns order when exists")
|
|
void findById_existingOrder_returnsOrder() {
|
|
var order = new Order(1L, "Alice", BigDecimal.TEN);
|
|
when(orderRepository.findById(1L)).thenReturn(Optional.of(order));
|
|
var result = orderService.findById(1L);
|
|
assertThat(result.customerName()).isEqualTo("Alice");
|
|
}
|
|
```
|
|
|
|
## Reference
|
|
|
|
See agents: `java-reviewer`, `java-build-resolver` for Java-specific review and build error resolution.
|
|
See skills: `springboot-patterns`, `jpa-patterns` for framework-specific guidance.
|