Skip to content

Instantly share code, notes, and snippets.

View philipz's full-sized avatar

philipz philipz

View GitHub Profile
@philipz
philipz / NodeJSProductionChecklist.md
Created January 10, 2026 03:03
Node.js Production Checklist (2025 Edition)

Node.js Production Checklist (2025 Edition)

A Developer's Guide to Bulletproof Deployments

Introduction

Most Node.js production failures don't happen because of bad code—they happen because of missed configurations. An unvalidated environment variable, an unhandled promise rejection, or a missing graceful shutdown can bring down your entire service at 3 AM. This checklist distills years of production incidents into actionable items you can verify before every deployment. It's the difference between a smooth launch and a weekend outage.

1. Project Structure & Architecture

@philipz
philipz / CLAUDE.md
Created January 10, 2026 03:01 — forked from minimaxir/CLAUDE.md
Rust CLAUDE.md (20260101)

Agent Guidelines for Rust Code Quality

This document provides guidelines for maintaining high-quality Rust code. These rules MUST be followed by all AI coding agents and contributors.

Your Core Principles

All code you write MUST be fully optimized.

"Fully optimized" includes:

@philipz
philipz / CLAUDE.md
Created January 10, 2026 02:56 — forked from minimaxir/CLAUDE.md
Python CLAUDE.md (20260101)

Agent Guidelines for Python Code Quality

This document provides guidelines for maintaining high-quality Python code. These rules MUST be followed by all AI coding agents and contributors.

Your Core Principles

All code you write MUST be fully optimized.

"Fully optimized" includes:

@philipz
philipz / Hazelcast_data_structure.md
Created September 12, 2025 02:45
Hazelcast分散式資料結構技術深度分析

Hazelcast分散式資料結構技術深度分析

Hazelcast作為統一的即時資料平台,透過其多樣化的分散式資料結構支撐著全球75%的金融交易處理。本分析揭示了Hazelcast七種核心資料結構的技術實作原理、CAP定理權衡策略、以及企業級架構設計考量,基於其獨特的對等式叢集架構和雙重一致性模型(AP/CP),為技術架構師提供關鍵的技術選型洞察。

Hazelcast的分散式架構採用無主從模式的對等式設計,消除單點故障風險,同時透過271個預設分區的一致性雜湊演算法實現資料的均勻分布。其多執行緒處理模型在高併發場景下較Redis等單執行緒解決方案展現出顯著優勢,在128併發執行緒測試中達到119萬操作/秒的吞吐量。CP子系統基於Raft共識演算法為需要強一致性的應用提供線性化保證,而預設的AP模式則透過懶惰複製機制確保高可用性。

Maps (IMap) - 分散式分區鍵值儲存的核心引擎

技術實作原理和架構設計

@philipz
philipz / hazelcast_v5.md
Created September 2, 2025 01:33
Hazelcast Platform Architecture Guide

Hazelcast Platform Architecture Guide

Hazelcast Platform 5.x has emerged as the definitive solution for distributed computing architectures, combining in-memory data grid capabilities with stream processing, microservices support, and enterprise-grade security in a unified platform. This comprehensive analysis reveals how organizations across industries are leveraging Hazelcast's capabilities to build resilient, high-performance systems that scale from startup applications to mission-critical enterprise deployments processing billions of events per second.

The platform's evolution to a unified architecture in version 5.x eliminates the complexity of managing separate systems for caching, stream processing, and messaging, while introducing breakthrough capabilities like Thread-Per-Core (TPC) architecture that delivers linear scaling and vector search for AI workloads. Real-world implementations demonstrate performance improvements of up to 200x over traditional approaches, with organizations like BNP Parib

@philipz
philipz / RAG_FW.md
Created August 18, 2025 09:39
Enterprise RAG Framework Evaluation: Strategic Technical Analysis 2024-2025

Enterprise RAG Framework Evaluation: Strategic Technical Analysis 2024-2025

The RAG development landscape has matured significantly, with enterprise-grade platforms emerging alongside innovative specialized frameworks. This comprehensive evaluation reveals LangChain and Microsoft's dual strategy (Semantic Kernel + AutoGen) as enterprise leaders, while Dify and CrewAI represent the strongest emerging competitors in visual workflow and multi-agent categories respectively.

Enterprise Readiness & Architecture

Tier 1: Production-Ready Enterprise Platforms

LangChain dominates enterprise readiness with the most comprehensive offering. The platform supports millions of users through modular, microservices-based architecture with LangGraph Platform enabling sophisticated orchestration. Enterprise features include SOC2-compliant LangSmith observability, native workspace multi-tenancy, and hybrid deployment models supporting both SaaS control planes with self-hosted data planes. Prod

@philipz
philipz / SWE-bench_LLM_Evaluation.md
Created July 24, 2025 02:05
SWE-bench LLM Evaluation

SWE-bench LLM Evaluation: Comprehensive Technical Analysis

The evaluation landscape for Large Language Models in software development has undergone dramatic transformation since SWE-bench's introduction in 2023. Performance metrics have exploded from 1.96% initial resolution rates to over 70% on certain variants, representing one of the most rapid capability progressions in AI benchmarking history. However, recent critical analysis reveals fundamental methodological flaws that significantly inflate these performance claims, while new evaluation paradigms emerge to address these limitations.

This technical analysis examines the current state of LLM coding evaluation through six critical dimensions: core methodologies, extended standards, alternative frameworks, performance benchmarks, technical limitations, and emerging trends. The findings illuminate both remarkable progress and substantial evaluation challenges that impact enterprise deployment strategies.

SWE-bench core methodology and technical

@philipz
philipz / git_worktree.md
Created July 21, 2025 13:42
Git Worktree 企業級深度實戰指南

Git Worktree 企業級深度實戰指南

Git worktree 已從簡單的特性發展為現代軟體開發中的關鍵工具,特別適用於管理大型代碼庫、遺留系統維護,以及複雜的開發工作流程。本指南基於企業級實戰案例和效能分析,為技術架構師提供全面的實施策略。

完整命令語法與核心架構

詳細命令語法參考

核心命令集合

@philipz
philipz / Debezium_WAL.md
Created July 15, 2025 10:07
Debezium WAL 容量問題完整解決方案

Debezium WAL 容量問題完整解決方案

1. WAL 檔案增長的根本原因分析

1.1 Debezium CDC 抄寫過程中 WAL 檔案累積的機制

核心機制分析: PostgreSQL 的 Write-Ahead Log (WAL) 在 Debezium CDC 場景中扮演關鍵角色。當資料變更時,變更首先寫入 WAL,然後才更新資料檔案。Debezium 使用 PostgreSQL 的邏輯複製功能,透過 pgoutput 或 wal2json 外掛程式從 WAL 中讀取變更事件。

WAL 累積的具體流程:

@philipz
philipz / SuperClaude_Manual.md
Last active July 23, 2025 17:19
SuperClaude 企業級使用手冊

SuperClaude 企業級使用手冊

SuperClaude v3.0.0.1 是一個革命性的 Claude Code 配置框架,將通用 AI 助手轉變為專業的企業級開發夥伴。該框架通過 16 個專業化命令、9 個認知角色和 70% 的 Token 優化,已為 6,500+ 開發者提供了結構化、高效的 AI 輔助開發解決方案。

從技術架構師的角度分析,SuperClaude 解決了企業級開發中的三大核心挑戰:AI 助手缺乏專業化、開發工作流程標準化困難,以及 Token 成本過高。通過證據驅動的方法論和模塊化設計,它為現代軟體開發提供了可擴展、可維護的 AI 輔助框架。

⚠️ 從 v2 升級?重要提示!

如果您是從 SuperClaude v2 升級,請注意以下關鍵變化:

  1. 徹底清理舊檔案:請手動刪除以下可能存在的文件和目錄,以避免衝突:
  • SuperClaude/ (舊的專案根目錄)