aaronedev

CLAUDE.md - Universal Development Principles

This document contains universal development principles and practices for AI assistants working on any project. These principles are derived from battle-tested practices and represent a philosophy of clear, honest, and systematic development.

Required Tools and Research Methods

1. Mandatory MCP Tool Usage

BEFORE ANY ACTION, you MUST use these tools. Tool names use double underscores between segments.

aaronedev

1. Go to about:config, enable these flags:
   • toolkit.legacyUserProfileCustomizations.stylesheets
   • layout.css.color-mix.enabled
2. Go to about:support, look for profile folder.
3. Add the CSS below to chrome/userChrome.css inside the profile folder.

aaronedev

# if the project has local bins, add them to PATH
if [ -d ./node_modules/.bin ]; then
  PATH_add ./node_modules/.bin
fi

aaronedev

#!/usr/bin/env bash
set -e

declare -i last_called=0
declare -i throttle_by=4

@throttle() {
	local -i now=$(date +%s)
	if (($now - $last_called > $throttle_by)); then
		# delay execution

aaronedev

Using Git Commit Message Templates to Write Better Commit Messages

The always enthusiastic and knowledgeable mr. @jasaltvik shared with our team an article on writing (good) Git commit messages: How to Write a Git Commit Message. This excellent article explains why good Git commit messages are important, and explains what constitutes a good commit message. I wholeheartedly agree with what @cbeams writes in his article. (Have you read it yet? If not, go read it now. I'll wait.) It's sensible stuff. So I decided to start following the

aaronedev

##############################################################################
# fixuserhome.sh
# Script to fix permissions in a user's home folder
# Author: https://github.com/aaronedev
# Version: 1.0
# License: MIT
# Date: 2025-08-11
##############################################################################
# Usage: fixuserhome [OPTIONS] [username] [exclude_dir1] [exclude_dir2] ...
# Example: fixuserhome -t testuser /var/log /tmp

aaronedev

local M = {}

-- Cache for module state
local state = {
  buf = nil,
  win = nil,
  ns = nil,
  width = 34,
  uses_mousemoveevent = vim.o.mousemoveevent,
}

aaronedev

#!/bin/bash
##############################################################################
# Script to convert a JSON file to VCF format
# was originally created for Telegram contacts when using
# export contact feature
##############################################################################
# Author: https://github.com/aaronedev
# Version: 1.0
# License: MIT
# 2025-08-08

aaronedev

{
  "vim.showMarksInGutter": false,
  "vim.foldfix": true,
  "vim.surround": true,
  "vim.easymotion": true,
  "vim.easymotionKeys": "asdghklqwertyuiopzxcvbnmfj",
  "vim.leader": "<space>",
  "vim.normalModeKeyBindingsNonRecursive": [
    {
      "before": [":", "w", "<CR>"],

aaronedev

#!/bin/bash
# Pop!_OS comes in Intel/AMD and NVIDIA variants - using Intel/AMD version
ISO=pop-os_22.04_amd64_intel_20.iso
IMG=popos-22-04.qcow2
if [ ! -f "$ISO" ]; then
	echo "Downloading Pop!_OS 22.04 Intel/AMD version..."
	wget https://iso.pop-os.org/22.04/amd64/intel/20/$ISO
fi
if [ ! -f "$IMG" ]; then
	qemu-img create -f qcow2 $IMG 16G