docs: macOS/BSD find — template+понимание вместо ветвления

- Зачем:
  - `-newermt "@<epoch>"` и `-printf` в secondary session-id capture — GNU-специфичные; на macOS BSD find они не работают, а тестировать на маке негде.
- Что:
  - SKILL.md: добавлена one-paragraph platform note рядом с `find` — формулирует цель шага ("найти свежие rollout-файлы, выбрать последний, извлечь UUID") и приглашает Opus/пользователя подставить BSD-эквивалент.
  - docs/DESIGN.md §9.5: новое known-limitation с обоснованием template+understanding подхода вместо platform-detection.
  - README.md Known limitations: user-facing note, что end-to-end на macOS не тестировался.
- Проверка:
  - Ничего не ломается на Linux (команды без изменений).
  - На macOS оператор читает note и адаптирует.
This commit is contained in:
2026-04-17 17:21:27 +03:00
parent b213678ff0
commit af0ad8ab11
3 changed files with 29 additions and 1 deletions
+6
View File
@@ -262,6 +262,12 @@ review correctness.
scoped to the submodule — `git rev-parse --show-toplevel` does not walk
up to the parent. A warning is printed; invoke from the parent repo if
you want parent scope.
- **GNU find on macOS.** The secondary session-id capture uses
`find -newermt "@<epoch>"` and `-printf`, both GNU extensions. On
macOS (BSD find) the skill's default command does not work; the skill
states the *goal* of the step in SKILL.md and invites the model (or
user) to substitute an equivalent BSD-compatible command. The skill
has not been end-to-end tested on macOS.
## Roadmap