Discovered in session 2026-06-03 (PR #274): the .ai symlink was missing in the app worktree — a perf-research agent couldn't write .ai/ops/handoffs/ via relative path (worked around via absolute).
The 3 dev symlinks (.ai → ../ai, .claude → ../ai/.claude, specs → ../ai/ops/specs) are gitignored and must be recreated per checkout/worktree. .claude + specs existed; .ai was missed.
Scope: a setup script (or extend workflow.worktree-cleanup/setup) that creates all 3 symlinks idempotently after a worktree/checkout is created.
Discovered in session 2026-06-03 (PR #274): the
.aisymlink was missing in theappworktree — a perf-research agent couldn't write.ai/ops/handoffs/via relative path (worked around via absolute).The 3 dev symlinks (
.ai → ../ai,.claude → ../ai/.claude,specs → ../ai/ops/specs) are gitignored and must be recreated per checkout/worktree..claude+specsexisted;.aiwas missed.Scope: a setup script (or extend
workflow.worktree-cleanup/setup) that creates all 3 symlinks idempotently after a worktree/checkout is created.