e94417b896
Includes: spec-driven and test-driven development best practices, reproduce-before-fixing debugging workflow, require-plan-file hook, find-project-root script, session logs, memory files for decisions/ gotchas/process-lessons, and updates to existing best practice topics. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
763 B
763 B
Skills Gotchas
Broken symlinks cause silent failures under set -e
Symptom: install.sh fails with exit 1 on a broken symlink.
Cause: readlink -f on a broken symlink returns an empty string, causing comparison failure under set -e.
Fix: Remove stale symlinks before re-running install. When skills move directories (e.g., from ~/dev/claude/custom-claude-skills/ to ~/dev/claude/projects/custom-claude-skills/), old symlinks break.
Skills created mid-session are not available as slash commands
Symptom: A newly created skill doesn't appear when you type /skillname.
Cause: Skills are discovered at session start, not dynamically during the session.
Fix: Start a new Claude Code session to pick up newly created skills.