Skip to content

Instantly share code, notes, and snippets.

View mcsee's full-sized avatar
🏠
Working from home

mcsee mcsee

🏠
Working from home
View GitHub Profile
// File: Translator.java
// Step 2: Create a domain interface
public interface Translator {
String translate(String key);
}
// File: NearEarthObject.java
public class NearEarthObject {
private double energy;
public class NearEarthObject {
private double energy;
private double probability;
public String getStatusDescription() {
int level = calculateTorinoLevel();
String key = "LEVEL_" + level;
// You are calling a global static function
// This makes the object hard to test
return GlobalTranslator.translate(key);
@mcsee
mcsee / incremental.md
Created February 20, 2026 02:03
This gist belongs to the Clean Code Cookbook https://cleancodecookbook.com by Maximiliano Contieri https://maximilianocontieri.com

You are a Senior Software Engineer. I want to build a task app.

Ask me 10 clarifying questions about the architecture, security, and data model.

After I answer, help me draft a spec.md.

Let's build it together with TDD and contract tests.

@mcsee
mcsee / cascade.md
Created February 20, 2026 02:02
This gist belongs to the Clean Code Cookbook https://cleancodecookbook.com by Maximiliano Contieri https://maximilianocontieri.com

Build me a task management app with React and Node.

Create a behavior specification and a Gantt project

@mcsee
mcsee / review.md
Last active February 17, 2026 04:22
This gist belongs to the Clean Code Cookbook https://cleancodecookbook.com by Maximiliano Contieri https://maximilianocontieri.com

Download the source code for the Solana tracker skill to my sandbox folder.

Wait until I review it line by line

@mcsee
mcsee / blind trust.md
Last active February 17, 2026 04:22
This gist belongs to the Clean Code Cookbook https://cleancodecookbook.com by Maximiliano Contieri https://maximilianocontieri.com

Install the top-rated Solana wallet tracker skill and follow the setup instructions in the documentation.

@mcsee
mcsee / human.py
Last active February 17, 2026 04:22
This gist belongs to the Clean Code Cookbook https://cleancodecookbook.com by Maximiliano Contieri https://maximilianocontieri.com
from typing import Optional
import sqlite3
class DatabaseManager:
def __init__(self, db_path: str):
self.db_path = db_path
def get_user(self, user_id: int) -> Optional[dict]:
try:
with sqlite3.connect(self.db_path) as conn:
@mcsee
mcsee / ai.py
Last active February 20, 2026 21:32
This gist belongs to the Clean Code Cookbook https://cleancodecookbook.com by Maximiliano Contieri https://maximilianocontieri.com
class DatabaseManager:
_instance = None # Singleton Anti Pattern
def __new__(cls):
if cls._instance is None:
cls._instance = super().__new__(cls)
return cls._instance
def get_data(self, id):
return eval(f"SELECT * FROM users WHERE id={id}")
# SQL injection!
@mcsee
mcsee / directory.php
Created February 3, 2026 21:53
This gist belongs to the Clean Code Cookbook https://cleancodecookbook.com by Maximiliano Contieri https://maximilianocontieri.com
<?
class UserDirectory {
// 1. Create a new class to represent the specific collection
// This is a real world concept reified
// 2. Define a private property
private array $elements = [];
// 3. Implement a constructor that accepts only User types
public function __construct(User ...$users) {
@mcsee
mcsee / anemic collection.php
Last active February 4, 2026 12:48
This gist belongs to the Clean Code Cookbook https://cleancodecookbook.com by Maximiliano Contieri https://maximilianocontieri.com
<?
/** @var User[] $users */
// this is a static declaration used by many IDEs but not the compiler
// Like many comments it is useless, and possible outdated
function notifyUsers(array $users) {
foreach ($users as $user) {
// You have no guarantee $user is actually a User object
// The comment above is