fix: use story description for file keyword scoring, not just title

Title keywords ('landing','caption') may not appear in the target file
at all — the file uses 'hero-tag' and 'hero'. Description keywords
('learning','platform') match the actual text string to change and
score index.html much higher than login.html or styles.css.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: suyog19

app/claude_client.py

@@ -638,17 +638,20 @@ def summarize_repo(repo_path: str, repo_name: str, analysis: dict) -> str:
     return summary
 
 
-def suggest_change(repo_path: str, analysis: dict, issue_key: str = "", issue_summary: str = "", memory_context: str = "") -> dict:
+def suggest_change(repo_path: str, analysis: dict, issue_key: str = "", issue_summary: str = "", issue_description: str = "", memory_context: str = "") -> dict:
     """Ask Claude Sonnet to suggest up to 3 code changes aligned with the Jira story.
 
-    Selects files by keyword overlap with the issue summary rather than a fixed entry-point
-    list, giving Claude context most relevant to the story intent.
+    Selects files by keyword overlap with the issue summary + description rather than a fixed
+    entry-point list, giving Claude context most relevant to the story intent.
     Returns a dict with keys: changes (list of {file, description, original, replacement}), summary.
     """
     client = _CLIENT
 
     primary_language = analysis.get("primary_language", "Python")
-    selected = _select_files_for_story(repo_path, primary_language, issue_summary)
+    # Combine title + description for richer keyword extraction — description often contains
+    # the exact text strings to find/change, which score the right file much more precisely.
+    keyword_text = f"{issue_summary} {issue_description}".strip()
+    selected = _select_files_for_story(repo_path, primary_language, keyword_text)
 
     if not selected:
         return {

app/workflows.py

@@ -1150,7 +1150,13 @@ def story_implementation(run_id: int, issue_key: str, issue_type: str, summary:
         suggest_memory = f"{suggest_memory}\n\n{answer_note}" if suggest_memory else answer_note
 
     update_run_step(run_id, "suggesting")
-    suggestion_result = suggest_change(repo_path, analysis, issue_key=issue_key, issue_summary=summary, memory_context=suggest_memory)
+    suggestion_result = suggest_change(
+        repo_path, analysis,
+        issue_key=issue_key,
+        issue_summary=summary,
+        issue_description=early_story_details.get("description") or "",
+        memory_context=suggest_memory,
+    )
     changes = suggestion_result.get("changes", [])
     suggestion_summary = suggestion_result.get("summary", "")
     files_str = ", ".join(c.get("file", "") for c in changes)