agent-council-nudge

Preamble

# Read proactive config from ~/.council/config.json
_COUNCIL_PROACTIVE="true"
if [ -f "$HOME/.council/config.json" ]; then
  _CP=$(cat "$HOME/.council/config.json" 2>/dev/null | grep -o '"proactive"[[:space:]]*:[[:space:]]*[a-z]*' | grep -o 'true\|false')
  [ -n "$_CP" ] && _COUNCIL_PROACTIVE="$_CP"
fi
echo "COUNCIL_PROACTIVE: $_COUNCIL_PROACTIVE"

# Check for stale sessions (>7 days, no outcome recorded)
_STALE_SESSION="none"
_STALE_DAYS=""
if [ -d "$HOME/.council" ]; then
  for _meta in $(find "$HOME/.council" -name "meta.json" -mtime +7 2>/dev/null | head -5); do
    if ! grep -q '"outcome"' "$_meta" 2>/dev/null; then
      _STALE_SESSION=$(basename "$(dirname "$_meta")")
      _STALE_DAYS=$(( ( $(date +%s) - $(date -r "$_meta" +%s) ) / 86400 ))
      break
    fi
  done
fi
echo "STALE_SESSION: $_STALE_SESSION"
[ "$_STALE_SESSION" != "none" ] && echo "STALE_DAYS: $_STALE_DAYS"

# Session nudge counter (max 2 per session)
_NUDGE_FILE="/tmp/council-nudges-$$"
_NUDGE_COUNT=$(cat "$_NUDGE_FILE" 2>/dev/null || echo "0")
echo "NUDGE_COUNT: $_NUDGE_COUNT"

Nudge Behavior

If COUNCIL_PROACTIVE is "false": do nothing. Do not suggest any council commands. The user opted out.

If COUNCIL_PROACTIVE is "true" AND NUDGE_COUNT is less than 2:

You may suggest council commands at natural pause points in the conversation. The suggestion goes AFTER your full response, as a single quiet line. Never as a question. Never as the main content. Never mid-thought.

When to suggest /council

If the user's message matches ANY of these patterns:

• Explicit comparison: "should we use X or Y", "X vs Y", "which approach"
• Trade-off language: "trade-off", "pros and cons", "compare options"
• Architecture decisions: "how should we structure", "what pattern", "which database"
• Decision paralysis: "I'm not sure", "I'm torn", "what do you think about" + technical topic
• Multiple competing options being weighed

Suggest: Tip: Looks like a decision with trade-offs. /council gets 3 independent AI perspectives on this.