Skip to content

CLAUDE.md

Latest commit

 

History

History
30 lines (25 loc) · 1.29 KB

CLAUDE.md

File metadata and controls

30 lines (25 loc) · 1.29 KB
Raw

CLAUDE.md — codechu-config

Bootstrap per codechu-org/ai/AGENTS.md §0 before any work. Prefer the local clone at $org_home/codechu-org/ai/AGENTS.md (if ~/.config/codechu/config.toml has org_home set); otherwise WebFetch the public raw URL https://raw.githubusercontent.com/codechu/codechu-org/main/ai/AGENTS.md. This file lists only product-local overrides.

Product-local notes

  • Pure-Python, stdlib-only at runtime. The single optional dep is tomli_w (TOML write); never make it a hard requirement.
  • TOML read uses stdlib tomllib (Python 3.11+); on 3.10 the TOML read path raises ConfigError with a clear message — do not pull in tomli to paper over this.
  • Public API surface: Field, Schema, Config, ConfigError, ValidationError, MigrationError, Migration (type alias). Keep this surface stable — extra kwargs welcome, renames forbidden until 1.0.
  • Atomic save uses codechu_fs.atomic_write if available, falls back to in-package tempfile+os.replace. Do not make codechu-fs a hard dep — the fallback is part of the contract.
  • Coverage target: ≥85 %.

Discipline reminders (org rules apply)

  • Conventional Commits, no AI signature.
  • No --no-verify, no force push, no unapproved publish.
  • See codechu-org/ai/AGENTS.md for the full list.