Skip to content

Instantly share code, notes, and snippets.

@Darkflib

Darkflib/CLAUDE.md

Created August 30, 2025 05:02
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save Darkflib/36d9c956cdd67a0ced9e0d484d361dcd to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save Darkflib/36d9c956cdd67a0ced9e0d484d361dcd to your computer and use it in GitHub Desktop.
Download ZIP

Revisions

  1. Darkflib created this gist Aug 30, 2025.
    19 changes: 19 additions & 0 deletions CLAUDE.md
    View file
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,19 @@
    ## User shared preferences.

    Python preferred over node.
    Include class and function doc blocks.
    Default license is MIT.
    Use SemVar.
    Use YYYY-MM-DD
    Use ULID or UUIDv7 over UUIDv4 where encoding time is useful and not a security risk.
    Define JSON formats using JSON Schema.
    Diagrams in mermaid or PlantUML format - bias toward mermaid.
    For HTML templates, default to bootstrap 5.3 or higher.

    ## Python prefs:
    - fastAPI/flask, fastMCP, rich, sqlalchemy(sqlite/postgres), follow best practice(pre-commit, type-checking, linting, testing etc.), `uv` and `pyproject.toml` over `pip`.

    ## Stack prefs:
    - Debian/Ubuntu, RabbitMQ, Redis, Nginx, GCP preferred over AWS. Containerize servers for ease of deployment and testing.
    ## Workflow:
    - 'main' branch with feature branches. Use Conventional commits. Commits should block on linting issues (pre-commit). Keep a changelog (keepachangelog style). Use GitHub Actions by default. Aim for 70% code coverage, but prioritise critical paths and high risk functionality.