human-code-style

name	human-code-style
description	Strict guidelines for refactoring AI-generated code to appear hand-crafted, maintainable, and free of typical "AI smells" required for marketplace acceptance.

Human Code Style Standards

Goal: Eradicate robotic patterns. Make the codebase look like a Senior Staff Engineer wrote it by hand.

1. Commenting Guidelines

AI tools over-comment because they narrate what they just generated. Human engineers assume the reader understands the language syntax.

Rule: Delete the "What", Explain the "Why"

❌ AI Smell:

// Fetch the user data from the database
const user = await db.collection('users').findOne({ id: userId });
// Return the user
return user;

✅ Human Standard:

// (No comments needed here. The code is obvious.)
const user = await db.collection('users').findOne({ id: userId });
return user;

Rule: Commenting Business Logic If there's a weird calculation or regex, explain why it exists.

✅ Human Standard:

 maxRetries = ;