codeflash-ai/codeflash
1
0
Fork 0
Code Issues 18 Pull requests 33 Projects Releases Packages Wiki Activity Actions 4.9k
codeflash/tiles/codeflash-rules/rules/code-style.md
Kevin Turcios 6718e66582 feat: add private tessl tiles for codeflash rules, docs, and skills 
Three private tiles in the codeflash workspace:
- codeflash-rules: 6 steering rules (code-style, architecture, optimization-patterns, git-conventions, testing-rules, language-rules)
- codeflash-docs: 7 doc pages (domain-types, optimization-pipeline, context-extraction, verification, ai-service, configuration)
- codeflash-skills: 2 skills (debug-optimization-failure, add-codeflash-feature)
2026-02-14 20:55:06 -05:00

802 B
Raw Blame History

Code Style

  • Line length: 120 characters
  • Python: 3.9+ syntax (use from __future__ import annotations for type hints)
  • Package management: Always use uv, never pip — run commands via uv run
  • Tooling: Ruff for linting/formatting, mypy strict mode, prek for pre-commit checks (uv run prek run)
  • Comments: Minimal — only explain "why", not "what"
  • Docstrings: Do not add unless explicitly requested
  • Naming: NEVER use leading underscores (_function_name) — Python has no true private functions, use public names
  • Paths: Always use absolute Path objects, handle encoding explicitly (UTF-8)
  • Source transforms: Use libcst for code modification/transformation to preserve formatting; ast is acceptable for read-only analysis and parsing