Files

Mike Swanson 6e4ebc2db9 refactor: Consolidate directives into CLAUDE.md, delete redundant files

Deleted:
- directives.md (9-line redirect, obsolete)
- DIRECTIVES_ENFORCEMENT.md (408 lines of enforcement theater)
- AGENT_COORDINATION_RULES.md (merged into CLAUDE.md)
- refresh-directives command (no longer needed)

Updated:
- CLAUDE.md: Added coordination flow, GuruRMM project, removed hardcoded
  DB password, trimmed Ollama section, updated project description
- CODING_GUIDELINES.md: Cut from 428 to ~90 lines, project-specific only

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-02 19:19:06 -07:00

1.8 KiB

Raw Blame History

ClaudeTools - Coding Guidelines

Project-specific standards. Generic language conventions (PEP 8, etc.) are assumed knowledge.

Character Encoding

NO EMOJIS - EVER

Never use emojis in code, scripts, config files, log messages, or output strings.

Rationale: Causes PowerShell parsing errors, encoding issues, terminal rendering problems.

Use instead:

[OK] [SUCCESS] [INFO] [WARNING] [ERROR] [CRITICAL]

Exception: User-facing web UI with proper UTF-8 handling.

Naming Conventions

Python: snake_case functions, PascalCase classes, UPPER_SNAKE constants
PowerShell: PascalCase variables ($TaskName), approved verbs (Get-/Set-/New-)
Bash: lowercase_underscore functions, quote all variables
DB tables: lowercase plural (users, user_sessions), FK as {table}_id
DB columns: created_at/updated_at timestamps, is_/has_ boolean prefixes

Security

Never hardcode credentials -- use SOPS vault or environment variables
JWT tokens for API auth, Argon2 for password hashing
Log all authentication attempts and sensitive operations
.env files are gitignored, never committed

API Standards

RESTful with plural nouns: /api/users
Consistent error format: {"detail": "...", "error_code": "...", "status_code": N}
Paginate large result sets
Document with OpenAPI (automatic with FastAPI)

Output Markers

All scripts and tools use ASCII status markers:

[INFO] Starting process
[SUCCESS] Task completed
[WARNING] Configuration missing
[ERROR] Failed to connect
[CRITICAL] Database unavailable

Git

Commit types: feat, fix, refactor, docs, test, config
Always include Co-Authored-By line for Claude commits
Never commit .env, credentials, venv, pycache, *.log

Last Updated: 2026-04-02

1.8 KiB Raw Blame History