FrancescoJo

CLAUDE.md

Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.

Tradeoff: These guidelines bias toward caution over speed. For trivial tasks, use judgment.

1. Think Before Coding

Don't assume. Don't hide confusion. Surface tradeoffs.

FrancescoJo

Development Guidelines

Critical Rules (max 10)

These rules must be honoured since breaking them causes serious problems. Rules are ordered by importance.

1. DO NOT add AI attribution to any output(code, commits, PRs, docs, comments, etc.).
2. DO NOT commit directly to main branches(main, master)
3. DO Confirm explicitly before deleting code

FrancescoJo

import kotlin.math.max
import kotlin.math.min

/**
 * @returns hue, saturation%, brightness%
 */
fun rgbToHsb(r: Int, g: Int, b: Int): Triple<Float, Float, Float> {
    val rF = r / 255f
    val gF = g / 255f
    val bF = b / 255f

FrancescoJo

import tensorflow as tf
from tensorflow.keras import layers, Model
import numpy as np

class ExpertLayer(layers.Layer):
    """Individual expert network."""
    def __init__(self, hidden_dim, output_dim, **kwargs):
        super(ExpertLayer, self).__init__(**kwargs)
        self.hidden_layer = layers.Dense(hidden_dim, activation='relu')
        self.output_layer = layers.Dense(output_dim, activation='linear')

FrancescoJo

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel

from vllm import LLM, SamplingParams

app = FastAPI()

model_path = "/home/deploy/workspace/DeepSeek-R1-Distill-Llama-8B"
llm = LLM(model=model_path, gpu_memory_utilization=0.9, tensor_parallel_size=1, enforce_eager=True, max_model_len=16384)

FrancescoJo

// UserEntity.kt
@Entity
@Table(name = "users")
class UserEntity(
    @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")
    val id: Long = 0L,

    @Column(name = "isDeleted")
    var isDeleted: Boolean = false,

FrancescoJo

import org.springframework.beans.factory.config.ConfigurableListableBeanFactory 
import org.springframework.beans.factory.support.BeanDefinitionRegistry 
import org.springframework.beans.factory.support.BeanDefinitionRegistryPostProcessor 
import org.springframework.context.annotation.ClassPathScanningCandidateComponentProvider 
import org.springframework.context.annotation.Configuration 
import org.springframework.core.type.filter.AnnotationTypeFilter 

@Configuration 
class AnnotationConfig : BeanDefinitionRegistryPostProcessor { 
    override fun postProcessBeanFactory(beanFactory: ConfigurableListableBeanFactory) { 

FrancescoJo

//usr/bin/env jshell --show-version "$0" "$@"; exit $?
public class Runner {
  public static void main(final String[] args) {
    System.out.println("Runner#main");
  }
}

System.out.println("Executing class");
Runner.main(new String[0]);

FrancescoJo

console.log("%cGood to go!", "font: 2em roboto; color: yellow; background-color: green;");

FrancescoJo

class Animal { }

class Reptile extends Animal { }
class Bird extends Animal { }

interface MobileLife {
  // Every classes derived from this interface should implement common features on it.
  void move(double displacement);

  double getDistance();