giuseppe-trisciuoglio/developer-kit

Comprehensive developer toolkit providing reusable skills for Java/Spring Boot, TypeScript/NestJS/React/Next.js, Python, PHP, AWS CloudFormation, AI/RAG, DevOps, and more.

Quality

90%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Risky

Do not use without reviewing

This version of the tile failed moderation

Moderation pipeline encountered an internal error

ADR Examples

Name: giuseppe-trisciuoglio/developer-kit
Rating: 90.85333333333334 (1 reviews)
Author: giuseppe-trisciuoglio

Example 1

Path: docs/architecture/adr/0003-adopt-postgresql-for-primary-database.md

# ADR-0003: Adopt PostgreSQL for the Primary Database

## Status
Accepted

## Context
The application has outgrown SQLite for concurrent writes and operational visibility. We need stronger transactional guarantees, better backup tooling, and a database that can support production traffic growth.

## Decision
Adopt PostgreSQL as the primary relational database for all new production deployments.

## Consequences
PostgreSQL improves concurrency, operational tooling, and long-term scalability. It also introduces additional infrastructure and migration complexity compared with SQLite.

Example 2

Path: docs/architecture/adr/0004-introduce-event-driven-order-processing.md

# ADR-0004: Introduce Event-Driven Order Processing

## Status
Proposed

## Context
Synchronous order processing is increasing latency in the checkout flow and makes retries difficult when downstream services are degraded.

## Decision
Introduce an event-driven workflow for order fulfillment so checkout can publish an order event and downstream processors can handle fulfillment asynchronously.

## Consequences
This change should reduce user-facing latency and improve resilience. It also adds messaging infrastructure, operational monitoring needs, and eventual-consistency trade-offs.

Naming Tips

Prefer action-oriented titles such as "Adopt", "Introduce", "Standardize", or "Migrate"
Keep filenames short but descriptive
Reuse the repository's numbering pattern if ADRs already exist