craft-project-dream

craft-project-dream

Like sleep, dream processes what accumulated. Forgets what does not matter. Strengthens what does. Leaves the project rested so the next session starts sharp, not sluggish.

Every dream is auditable. Before any change is applied, every file dream will touch is snapshotted to .craft/dreams/<timestamp>/before/. After the run, the new state lands in after/ alongside a human-readable diff.md and a quantified report.md. If a dream makes things worse, rollback is one cp away.

Run after active sprints, at the end of a productive week, or when Claude keeps re-asking questions that should already be settled.

Step 0: Assess readiness

CWD=$(pwd)
NOW=$(date +%s)
STAMP=$(date +%Y-%m-%d-%H-%M)
DREAM_DIR="$CWD/.craft/dreams/$STAMP"

# Portable mtime (macOS: stat -f, Linux/WSL: stat -c)
file_mtime() { stat -f "%m" "$1" 2>/dev/null || stat -c "%Y" "$1" 2>/dev/null || echo 0; }

echo "=== FILES ==="
for f in CLAUDE.md .craft/PROJECT_STATE.md .craft/BACKLOG.md .craft/HANDOVER.md .craft/DECISIONS.md .craft/DREAM_LOG.md; do
  if [[ -f "$CWD/$f" ]]; then
    lines=$(wc -l < "$CWD/$f" | tr -d ' ')
    age_days=$(( (NOW - $(file_mtime "$CWD/$f")) / 86400 ))
    echo "  FOUND  $f  ${lines} lines  ${age_days}d ago"
  else
    echo "  MISSING  $f"
  fi
done

echo "=== MEMORY ==="
mem_count=$(find "$CWD/.craft/memory/" -maxdepth 1 -type f 2>/dev/null | wc -l | tr -d ' ')
echo "  $mem_count files"
ls -t "$CWD/.craft/memory/" 2>/dev/null | head -5

echo "=== GIT ==="
commits_since_last_dream=$(git log --since="$(file_mtime "$CWD/.craft/DREAM_LOG.md" 2>/dev/null | xargs -I{} date -r {} '+%Y-%m-%d' 2>/dev/null || echo '90 days ago')" --oneline 2>/dev/null | wc -l | tr -d ' ')
echo "  $commits_since_last_dream commits since last dream"

echo "=== SNAPSHOT TARGET ==="
echo "  $DREAM_DIR"

If CLAUDE.md is missing and .craft/ does not exist: stop with "This project is not set up yet. Run /craft-project-setup first."

If the project looks dormant (0 commits since last dream): note it but continue — dormant projects still benefit from consolidation.