skynet/claude-foundations
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add best practices, hooks, memory files, and scripts from recent sessions

Browse Source 
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>
This commit is contained in:
Paul O'Reilly
2026-03-17 09:47:47 +13:00
parent c3a151a87b
commit e94417b896
28 changed files with 1357 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
memory/gotchas-skills.md Normal file
View File

@@ -0,0 +1,13 @@
# 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.