docs: add commit message guidelines

Author: steviec

test-commit-msg.md

@@ -0,0 +1,35 @@
+# Test Commit Message Generation
+
+## Bad Examples (current):
+
+```
+feat: implement auto-fixing pre-commit hooks
+
+- Add stage_fixed: true to format and lint commands in lefthook.yml
+- Pre-commit hooks now automatically fix formatting and linting issues
+- Fixed files are automatically re-staged for commit
+- Eliminates the need for manual fix-restage-retry cycles
+- Typecheck and test remain as validation-only hooks
+```
+
+## Good Examples:
+
+```
+feat: implement auto-fixing pre-commit hooks
+
+Pre-commit hooks now automatically fix and re-stage formatting and linting issues.
+```
+
+```
+refactor: remove json-schema scorer from eval testing
+
+JSON schema validation doesn't serve a realistic use case for LLM response evaluation.
+```
+
+## Guidelines:
+
+- Single line description preferred
+- If body needed, 1-2 sentences max
+- Focus on business value/reasoning, not implementation
+- Never list file names, method names, or technical details
+- Explain WHY, not WHAT

test-prompts.md

@@ -0,0 +1,26 @@
+# Commit Message Prompt Testing
+
+## Prompt V1 (Current - TOO VERBOSE):
+
+"Generate commit message based on changes: Use conventional commit format with detailed bullet points"
+
+## Prompt V2 (Concise):
+
+"Generate a concise commit message. Format: `<type>: <description>`. Keep description under 50 chars. Add 1-2 sentence body only if needed to explain WHY, never WHAT."
+
+## Prompt V3 (Business-focused):
+
+"Write a commit message focusing on user/business impact, not implementation details. Format: `<type>: <description>`. Avoid mentioning files, methods, or technical specifics."
+
+## Prompt V4 (Minimal):
+
+"Generate commit message: `<type>: <description>`. Description should be concise and focus on the purpose/benefit, not implementation. Single line preferred."
+
+## Test with recent changes:
+
+**Changes:** Added `stage_fixed: true` to lefthook.yml format and lint commands
+
+**V1 Result:** (too verbose - current behavior)
+**V2 Result:** `feat: auto-fix formatting and linting in pre-commit`
+**V3 Result:** `feat: implement auto-fixing pre-commit hooks`  
+**V4 Result:** `feat: auto-fix pre-commit formatting and linting`