diff --git a/agents/manifests/resume_reviewer_agent.json b/agents/manifests/resume_reviewer_agent.json
index 7248d3c..4e99a77 100644
--- a/agents/manifests/resume_reviewer_agent.json
+++ b/agents/manifests/resume_reviewer_agent.json
@@ -1,37 +1,62 @@
 {
   "id": "resume_reviewer",
   "name": "Resume Reviewer Agent",
-  "description": "Reviews resume documents and provides actionable feedback for improvement.",
+  "description": "Reviews resume documents against industry standards and job requirements, providing tailored feedback, market trend insights, and scoring.",
   "category": "Career",
   "creator": "AgentStore Team",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "status": "published",
   "rating": 4.6,
   "downloads": 2100,
   "installs": 1500,
   "runs": 8900,
   "tags": ["career", "resume", "job-search"],
-  "tools_required": ["file_reader"],
-  "permissions_required": ["files.read"],
+  "tools_required": ["file_reader", "web_search"],
+  "permissions_required": ["files.read", "internet.access"],
   "inputs": {
     "type": "object",
     "properties": {
-      "file_path": { "type": "string" },
-      "target_role": { "type": "string" }
-    }
+      "file_path": { 
+        "type": "string", 
+        "description": "Path to the uploaded resume document (PDF/Word)." 
+      },
+      "target_role": { 
+        "type": "string", 
+        "description": "The job title or role being targeted for tailored analysis and real-time market trend alignment (optional)." 
+      }
+    },
+    "required": ["file_path"]
   },
   "outputs": {
     "type": "object",
     "properties": {
-      "overall_score": { "type": "number" },
-      "strengths": { "type": "array", "items": { "type": "string" } },
-      "improvements": { "type": "array", "items": { "type": "string" } },
-      "section_feedback": { "type": "object" }
-    }
+      "overall_score": { 
+        "type": "number", 
+        "minimum": 0, 
+        "maximum": 100, 
+        "description": "Resume quality score from 0 to 100 based on formatting, content, and market relevance." 
+      },
+      "strengths": { 
+        "type": "array", 
+        "items": { "type": "string" }, 
+        "description": "List of strong points and key competitive advantages identified in the resume." 
+      },
+      "improvements": { 
+        "type": "array", 
+        "items": { "type": "string" }, 
+        "description": "Actionable areas and critical gaps that need enhancement or adjustment." 
+      },
+      "section_feedback": { 
+        "type": "object", 
+        "description": "Detailed breakdowns and keyword optimization recommendations for sections like Experience, Skills, or Education." 
+      }
+    },
+    "required": ["overall_score", "strengths", "improvements"]
   },
-  "example_use_case": "Upload a resume and get tailored feedback for a software engineering role.",
+  "example_use_case": "Upload your resume and optionally specify a target job to get tailored formatting, content feedback, and keyword optimization based on real-time market trends.",
   "example_prompts": [
-    "Review my resume for a data scientist position",
-    "What sections of my resume need improvement?"
+    "Review /documents/resume_2026.pdf for a data scientist position",
+    "Analyze /downloads/cv.pdf and suggest improvements for a senior software engineer role",
+    "What sections of my uploaded resume need improvement?"
   ]
-}
+}
\ No newline at end of file
diff --git a/agents/traces/resume_reviewer_trace.json b/agents/traces/resume_reviewer_trace.json
new file mode 100644
index 0000000..0a14746
--- /dev/null
+++ b/agents/traces/resume_reviewer_trace.json
@@ -0,0 +1,67 @@
+{
+  "agent_id": "resume_reviewer",
+  "run_id": "run_resume_001",
+  "status": "completed",
+  "started_at": "2026-06-17T09:00:00Z",
+  "completed_at": "2026-06-17T09:00:05Z",
+  "user_request": "Review /documents/resume_2026.pdf for a data scientist position",
+  "steps": [
+    {
+      "step": 1,
+      "action": "Receive user request",
+      "details": "Parsed request: file_path='/documents/resume_2026.pdf', target_role='data scientist'"
+    },
+    {
+      "step": 2,
+      "action": "Identify required tools",
+      "details": "Agent manifest requires: file_reader, web_search"
+    },
+    {
+      "step": 3,
+      "action": "Call mock tool",
+      "tool": "file_reader",
+      "input": { "file_path": "/documents/resume_2026.pdf" },
+      "output_summary": "Successfully read PDF. Extracted content: 3 years experience, Python, SQL, basic Machine Learning, missing production deployment details."
+    },
+    {
+      "step": 4,
+      "action": "Call mock tool",
+      "tool": "web_search",
+      "input": { "query": "data scientist job requirements market trends 2026 production LLM MLOps" },
+      "output_summary": "Found 4 recruitment trends: High demand for MLOps, LLM fine-tuning experience, and cloud deployment (AWS/GCP)."
+    },
+    {
+      "step": 5,
+      "action": "Process tool response",
+      "details": "Compared resume tech stack against 2026 market trends. Calculated gaps in deployment and advanced ML frameworks."
+    },
+    {
+      "step": 6,
+      "action": "Generate final answer",
+      "details": "Structured final output with an overall score of 82, matching all required schema constraints."
+    },
+    {
+      "step": 7,
+      "action": "Save run history",
+      "details": "Run logged to trace store with run_id run_resume_001"
+    }
+  ],
+  "final_output": {
+    "overall_score": 82,
+    "strengths": [
+      "Strong foundational skills in Python data analysis and SQL database management.",
+      "Clear metrics provided for past data analytics projects (e.g., 'improved model accuracy by 15%').",
+      "Solid academic background with relevant coursework in statistical modeling."
+    ],
+    "improvements": [
+      "Lacks keywords related to modern deployment tools like Docker, Kubernetes, or MLOps pipelines.",
+      "Needs more emphasis on practical experience with Large Language Models (LLMs) or generative AI framework integration.",
+      "The summary section is slightly passive; recommend leading with impact-driven action verbs."
+    ],
+    "section_feedback": {
+      "Summary": "Good introduction, but could be punchier by defining your specific niche (e.g., 'NLP-focused Data Scientist').",
+      "Experience": "Project descriptions are strong. However, to align with current market trends, specify how you deployed these models to production.",
+      "Skills": "Add cloud platforms (AWS/GCP) and containerization if applicable, as 85% of 2026 Data Science postings require them."
+    }
+  }
+}
\ No newline at end of file