PROGRAMMING_RULES

Project-wide coding standards and design philosophy. These rules apply to all code in the workspace and should be followed by both humans and LLMs.

Exception Handling — core exception handling principles and patterns

Main Function Pattern — separating business logic from CLI handling

Error Messages — CLI vs library error reporting

Philosophy — summary of guiding principles

Temporary Files — naming and cleanup conventions

Project Documentation Structure — how to structure notes for any project: app docs vs dev process

Project Testing Patterns — two-tier testing, standalone vs integration, what to document

Security Interfaces — structured vs delimiter-based interfaces; the meta-rule on documenting decisions

version2
updated2026-02-27
children['PROGRAMMING_RULES/exceptions', 'PROGRAMMING_RULES/main-pattern', 'PROGRAMMING_RULES/error-messages', 'PROGRAMMING_RULES/philosophy', 'PROGRAMMING_RULES/temp-files', 'PROGRAMMING_RULES/project-documentation', 'PROGRAMMING_RULES/project-testing', 'PROGRAMMING_RULES/security-interfaces']