strawberry/CLAUDE.md
trvon 09e6b441ae
Some checks failed
Build and Test / build (debug, clang) (push) Has been cancelled
Build and Test / build (debug, gcc) (push) Has been cancelled
Build and Test / build (release, clang) (push) Has been cancelled
Build and Test / build (release, gcc) (push) Has been cancelled
Build and Test / macos (push) Has been cancelled
Build and Test / docker (push) Has been cancelled
Audit flow: add the clang static analyzer as a strict per-change gate
- scripts/analyze_changed.sh + `make analyze`: clang-check --analyze over the
  changed TUs via builddir/compile_commands.json (host build may be gcc; clang
  tolerates those flags), nice -n 19, 2 at a time. Strict by default (any
  analyzer diagnostic fails), ANALYZE_STRICT=0 reports only; ANALYZE_FILES/--all
  override selection. Results in build/audit/out/analyze.log.
- AGENTS.md "Per-change checks": new analyzer row, positioned as path-sensitive
  intra-TU analysis that complements fold's bounded symbolic cross-call pass and
  the syntactic invariants (run all three); YAMS index-at-checkpoint reminder.
- CLAUDE.md: analyzer added to the checks pointer + a Performance & C++ bullet
  (perf-kpi + Tracy/PerfStats).
- docs/prompts/PROMPT-strawberry-audit.md: "Clang static analyzer" subsection
  under Symbolic SAST.

No C++ changed; unit suite 50/50 green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-10-28 09:55:03 -06:00

2 KiB

CLAUDE.md

Read AGENTS.md first: it holds this repository's rules, current reality, guardrails and the per-change check table. This file only points at the shared workflow.

  • Memory and retrieval: YAMS-first loop in docs/prompts/PROMPT-eng-codex.md (claim → checkpoints → handoff; plans, decisions and evidence live in YAMS, hydrated by hash before use).
  • Audits: docs/prompts/PROMPT-strawberry-audit.md: brick (structure), fold (scripts/fold_changed.sh, bounded symbolic SAST), pipe (enum class state flow).
  • Before calling a change done: the "Per-change checks" table in AGENTS.md (meson tests incl. source invariants and fault injection, clang-tidy on changed files, make analyze (clang static analyzer, strict) on changed TUs, make fuzz, fold on changed TUs, live Docker tests, make perf-kpi). Index the change in YAMS at each checkpoint, before and after.
  • Performance & C++: heavy or hot-path changes carry a constrained-lane KPI (make perf-kpi, scripts/perf_kpi_report.py --compare, 3 repeats) and Tracy zones (STRAWBERRY_ZONE, -Denable_profiling=true) recorded in PerfStats and surfaced in status timings. Code reading is not evidence.
  • CLI changes: follow docs/cli-ux.md (yams-style noun verb table in src/cli_commands.cpp, --json contract, exit codes, terminal-safe output, "adding a command" checklist).
  • Never leave a catch empty: handle it, or record it with STRAWBERRY_NOTE_SWALLOWED() (include/strawberry/swallowed.hpp). Enforced by source invariant R7 and clang-tidy bugprone-empty-catch (.clang-tidy).
  • This machine: builds and tools run niced and capped (nice -n 19, -j2, Docker --cpus=2); an uncapped fold build has frozen it before.
  • Plans in flight: YAMS task=strawberry-data-engine (staged data engine + online learning), task=strawberry-settings-ux, task=strawberry-encoder.