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

89%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Risky

Do not use without reviewing

ADR Examples

Name: giuseppe-trisciuoglio/developer-kit
Rating: 89.68656716417911 (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