Skip to content

Instantly share code, notes, and snippets.

@micahstubbs

micahstubbs/CLAUDE.md

Created August 7, 2025 20:56
Show Gist options
  • Save micahstubbs/569e39d275093b72401f4b068431606c to your computer and use it in GitHub Desktop.
Save micahstubbs/569e39d275093b72401f4b068431606c to your computer and use it in GitHub Desktop.
Download ZIP
Agent Rules from @TheAhmadOsman
Raw
CLAUDE.md

CLAUDE.md

Rules For Claude Code

This section defines the core rules and project conventions that all Claude Code executions must follow. It outlines safe command practices, required configuration targets, coding and logging standards, and the strict use of centralized configuration. All contributors and automated agents must adhere to these guidelines to ensure safety, consistency, and maintainability across the entire codebase.

Tool / Bash commands

  • Always avoid: git reset, git rm, rm, rm -rf
  • When deletion is required: move files into ../to-delete/ (git-ignored)
  • To replace existing files: rename the old file to .old then move the new file into place

Configuration targets

  • JVM target = 24
  • Android SDK: min = 26, max/target = 36

Coding & logging rules

  • Use Timber for all logging; never use println or alternatives
  • Don’t use kotlinx.datetime.Clock or .Instant; prefer kotlin.time.Clock and kotlin.time.Instant inline

Centralized configuration

  • Everything defined explicitly in a single source of truth
  • All development/build configs (Gradle, etc.) must live centrally
  • All run-time and in-app settings must be centralized in config modules
  • Feature flags must be globally declared and enforced via that system
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment