Summary

Updated bead creation documentation to use HEREDOC syntax (<<'EOF') for the --description parameter. This prevents shell interpretation of special characters (backticks, $variables, parentheses) that may appear in story descriptions and acceptance criteria.

Changes

• Updated command syntax: Changed from inline quoted strings to $(cat <<'EOF'...'EOF') pattern for all --description parameters in both br create (Rust) and bd create (base) skill documentation
• Added critical warning: Included explicit guidance to always use single-quoted <<'EOF' delimiter to prevent unintended shell expansion
• Applied consistently: Updated both the generic command examples and all concrete examples in the "Friends Outreach Track" walkthrough (epic + 3 user stories)

Implementation Details

• The HEREDOC syntax safely handles multi-line descriptions with special characters
• Single quotes around the delimiter (<<'EOF' not <<"EOF") prevent variable and command substitution
• This is a documentation-only change affecting two skill files with identical updates
• No functional code changes; purely improves shell command safety and reliability

Why This Matters

Story descriptions often contain special characters like pipes (|), parentheses, and backticks in acceptance criteria. Without HEREDOC syntax, these can cause shell interpretation errors or unexpected behavior. This change ensures robust bead creation regardless of description content.

Summary by CodeRabbit

• Documentation
  • Updated bead creation command documentation to use HEREDOC syntax for multi-line descriptions
  • Added critical guidance emphasising single-quoted HEREDOC delimiters (<<'EOF') to prevent shell interpretation of special characters
  • Refreshed example commands for Epic and Story creation with improved formatting standards

_{✏️ Tip: You can customize this high-level summary in your review settings.}