v1.23.1 - Enhanced Continuous Agent Engagement

🎯 Enhanced Continuous Agent Engagement

This release significantly improves how agents interact with the doc-bot server throughout their workflow, moving from one-time initialization to continuous engagement.

✨ What's New

🔄 Continuous Engagement Features

• Enhanced doc_bot tool description: Now emphasizes continuous use over one-time initialization

  • Positions it as a "continuous project compass" rather than a startup tool
  • Lists 6 specific checkpoint triggers for when to return
  • Warns that skipping check-ins leads to violations

• Mandatory Checkpoint Reminders: Added to getToolCatalog output

  • 5 specific checkpoint triggers with examples
  • Clear failure consequences section
  • "Continuous check-ins = Continuous correctness" mantra

📊 FOMO-Driven Responses

• Search Results Enhancement: Added "Continue Your Investigation" section

  • Creates awareness of missing file-specific docs
  • Warns about incomplete API exploration
  • Emphasizes error risk of incomplete context

• API Exploration Enhancement: Added "What This Response Doesn't Include" section

  • Lists project-specific gaps (usage patterns, forbidden patterns, gotchas)
  • Provides 3-step recommended action plan
  • Checkpoint reminder emphasizing generic vs project-specific info

• File Documentation Enhancement: Added context warnings

  • Clarifies file rules are IN ADDITION to global rules
  • Guidance on resolving conflicts
  • Checkpoint reminder specific to files being modified

• Document Reading Enhancement: Added cross-reference suggestions

  • Suggests related searches based on keywords
  • Reminds to verify with doc_bot() before implementing

🔗 Tool Relationship Clarification

• Enhanced check_project_rules description: Clarifies relationship with doc_bot()
  • Positions check_project_rules as "what rules apply to this task"
  • Positions doc_bot as "am I still aligned with the project"
  • Makes them complementary, not alternatives

🎮 How It Works

The changes implement several psychological engagement principles:

1. Information Debt: Every response indicates what's NOT included
2. Checkpoint Framing: Uses mandatory language ("MUST", "REQUIRED")
3. Failure Prevention: Shows what goes wrong when tools aren't used
4. FOMO Creation: Emphasizes missing information and increased error risk
5. Continuous Value: Each response points to additional value through other tools

🚀 Impact

Agents using this version will:

• Naturally develop a continuous check-in rhythm
• Be reminded at key decision points to consult doc-bot
• Understand the consequences of incomplete context
• See clear triggers for when to return to documentation tools

📦 Installation

npm install -g @afterxleep/doc-bot@1.23.1

🔧 Technical Details

• All 126 tests passing
• No breaking changes
• Backward compatible with existing configurations

---

Full Changelog: v1.23.0...v1.23.1