Develop

.agents/rules/memory-bank/brief.md

@@ -1,21 +1,81 @@
-# Zercle Bun Template - Project Brief
+# Project Brief
 
-**Project Name:** zercle-bun-template
+**Last Updated:** 2026-02-10
 
-**Purpose:** Production-ready RESTful API template built with Bun runtime and Hono framework, featuring clean architecture, JWT authentication, and PostgreSQL database.
+## Project Identity
 
-**Target Audience:** Developers looking for a solid foundation to build Bun microservices or REST APIs with best practices already implemented.
+- **Name:** zercle-hono-template
+- **Type:** Production-ready Hono.js web application template with Bun runtime
+- **Runtime:** Bun 1.x
+- **Language:** TypeScript 5.x
 
-**Key Value Proposition:**
+## Purpose
 
-- Clean architecture with domain-driven design principles
-- Type-safe database operations using Drizzle ORM
-- Comprehensive testing infrastructure (unit, integration, mocks)
-- Production-ready features (JWT auth, rate limiting, CORS, logging)
-- Docker support for easy deployment
-- OpenAPI documentation out of the box
-- Fast runtime with Bun's performance
+This project provides a comprehensive, production-ready Hono.js web application template following Clean Architecture and Hexagonal principles. It serves as a foundation for building scalable, maintainable web services with JWT authentication, user management, and a well-structured codebase, leveraging Bun's high-performance runtime.
 
-**Current Status:** Active development template with User and Task domains as working examples.
+## Core Requirements
 
-**Repository:** github.com/zercle/zercle-bun-template
+1. **Clean Architecture Implementation**
+   - Feature-based organization
+   - Clear separation of concerns (Presentation → Business Logic → Infrastructure)
+   - Dependency injection for loose coupling
+
+2. **Authentication & Security**
+   - JWT-based authentication with access/refresh tokens
+   - Bcrypt/Argon2 password hashing
+   - Secure configuration management
+
+3. **Data Persistence**
+   - Better-SQLite3 database with Drizzle ORM for type-safe queries
+   - In-memory repository for testing/development
+   - Repository pattern for data access abstraction
+
+4. **API Design**
+   - RESTful API with Hono.js framework
+   - OpenAPI/Swagger documentation via Scalar
+   - Standardized response format
+
+5. **Developer Experience**
+   - Comprehensive testing (unit, integration)
+   - Type-safe development with TypeScript
+   - Structured logging with Bun's built-in logger or Pino
+   - Environment-based configuration
+
+## Target Audience
+
+- Backend developers building Hono.js web services
+- Teams requiring a production-ready starting point
+- Projects needing Clean Architecture implementation
+- Applications requiring JWT authentication
+- Services requiring SQLite integration with Drizzle ORM
+
+## Key Features
+
+- User CRUD operations with validation
+- Email/password authentication
+- JWT token generation and validation
+- Password hashing with Bcrypt/Argon2
+- Configurable repository implementations
+- Graceful shutdown handling
+- Request/response logging middleware
+- Health check endpoints
+- OpenAPI documentation with Scalar
+
+## Project State
+
+The template is production-ready with:
+- Complete implementation of user and auth features
+- Dual repository implementations (memory + SQLite/Drizzle)
+- Comprehensive test coverage
+- Docker support for containerization
+- CI/CD configuration (pre-commit hooks, ESLint, Prettier)
+- Migration scripts for database schema
+
+## Bun Runtime Benefits
+
+- **Fast Startup:** Near-instant cold starts
+- **Native TypeScript:** No transpilation step required
+- **Hot Reloading:** Instant reload during development
+- **High Performance:** 3-4x faster than Node.js for many workloads
+- **Native Testing:** Built-in test runner with Jest-compatible API
+- **Bundle Management:** Fast npm/yarn/pnpm alternative with Bun install