refactor: use Agent SOPs from strands-agents-sops for prompts

BREAKING CHANGE: Prompts now use the code-assist SOP from strands-agents-sops

## Changes

- Add strands-agents-sops>=1.0.0 as a dependency
- Refactor prompts.py to use the SOP wrapper pattern:
  code_assist_with_input(dynamic_documentation)
- Simplify Jinja2 templates to only format dynamic content
  (documentation), removing full instruction sets
- Templates now focus on user requirements and fetched docs
- SOP provides the structured workflow (Explore, Plan, Code, Commit)

## Architecture

New pattern: Agent SOP (instructions) + Dynamic Content (documentation)

- Agent SOP (code-assist): Provides TDD methodology, design-first
  workflow, RFC 2119 constraints, and best practices
- Dynamic Content: Up-to-date Strands documentation fetched from
  strandsagents.com, formatted via Jinja2 templates

## Template Changes

All templates now contain only:
1. Task description and user requirements
2. Strands framework documentation (fetched dynamically)
3. Implementation notes specific to the domain

The workflow instructions are provided by the code-assist SOP.

## Test Updates

- Updated tests to verify SOP wrapper structure
- Fixed fetch_doc tests for SSRF protection (from upstream)
- Added tests for SOP integration

Refs: strands-agents/agent-sop

Author: Containerized Agent

pyproject.toml

@@ -26,6 +26,7 @@ dependencies = [
     "mcp>=1.1.3",
     "pydantic>=2.0.0",
     "jinja2>=3.1.0",
+    "strands-agents-sops>=1.0.0",
 ]
 
 [project.scripts]

src/strands_mcp_server/prompts.py

@@ -1,13 +1,27 @@
-"""Prompt generation system for Strands development."""
+"""Prompt generation system for Strands development.
+
+This module combines Agent SOPs with dynamically fetched Strands documentation
+to create comprehensive prompts for various development tasks.
+
+Architecture:
+    - Agent SOPs (from strands-agents-sops): Provide structured workflows,
+      constraints, and best practices for development tasks
+    - Dynamic Content (from strandsagents.com): Up-to-date documentation
+      specific to each development area
+    - Jinja2 Templates: Format the dynamic documentation content
+
+Pattern: sop_with_input(dynamic_documentation)
+"""
 
 import re
 from pathlib import Path
 
 import jinja2
+from strands_agents_sops import code_assist_with_input
 
 from .utils import cache
 
-# Initialize Jinja2 environment
+# Initialize Jinja2 environment for formatting dynamic content
 template_dir = Path(__file__).parent / "prompts"
 jinja_env = jinja2.Environment(
     loader=jinja2.FileSystemLoader(template_dir), trim_blocks=True, lstrip_blocks=True, autoescape=False
@@ -51,13 +65,23 @@ def fetch_content(url: str) -> str:
 
 
 # ============================================================================
-# SIMPLE PROMPT GENERATORS - Direct documentation inclusion
+# PROMPT GENERATORS - SOP + Dynamic Documentation Pattern
 # ============================================================================
 
 
 def generate_tool_prompt(request: str, tool_use_examples: str = "", preferred_libraries: str = "") -> str:
-    """Generate a design-first tool development prompt with dynamic documentation."""
+    """Generate a design-first tool development prompt with dynamic documentation.
+
+    Combines the code-assist SOP workflow with Strands-specific tool documentation.
 
+    Args:
+        request: Description of the tool functionality needed
+        tool_use_examples: Examples of how the tool will be used (optional)
+        preferred_libraries: Specific libraries or APIs to use (optional)
+
+    Returns:
+        Generated prompt combining SOP instructions with Strands documentation
+    """
     cache.ensure_ready()
 
     # Fetch documentation
@@ -69,21 +93,32 @@ def generate_tool_prompt(request: str, tool_use_examples: str = "", preferred_li
     )
     python_tools_content = fetch_content(python_tools_url)
 
-    # Load and render template
+    # Load and render template for dynamic content
     template = jinja_env.get_template("tool_development.jinja2")
-
-    return template.render(
+    dynamic_content = template.render(
         request=request,
         tool_use_examples=tool_use_examples,
         preferred_libraries=preferred_libraries,
         llms_txt_content=llms_txt_content,
         python_tools_content=python_tools_content,
     )
 
+    # Combine SOP with dynamic content
+    return code_assist_with_input(dynamic_content)
+
 
 def generate_session_prompt(request: str, include_examples: bool = True) -> str:
-    """Generate a session management implementation prompt with documentation."""
+    """Generate a session management implementation prompt with documentation.
+
+    Combines the code-assist SOP workflow with Strands session management documentation.
+
+    Args:
+        request: Description of the session management needs
+        include_examples: Include usage examples (default: True)
 
+    Returns:
+        Generated prompt combining SOP instructions with session documentation
+    """
     cache.ensure_ready()
 
     # Fetch documentation
@@ -98,17 +133,19 @@ def generate_session_prompt(request: str, include_examples: bool = True) -> str:
     session_api_url = "https://strandsagents.com/latest/documentation/docs/api-reference/session/index.md"
     session_api_content = fetch_content(session_api_url)
 
-    # Load and render template
+    # Load and render template for dynamic content
     template = jinja_env.get_template("session_management.jinja2")
-
-    return template.render(
+    dynamic_content = template.render(
         request=request,
         include_examples=include_examples,
         llms_txt_content=llms_txt_content,
         session_management_content=session_management_content,
         session_api_content=session_api_content,
     )
 
+    # Combine SOP with dynamic content
+    return code_assist_with_input(dynamic_content)
+
 
 def generate_agent_prompt(
     use_case: str,
@@ -121,6 +158,8 @@ def generate_agent_prompt(
 ) -> str:
     """Generate a design-first agent development prompt with dynamic documentation.
 
+    Combines the code-assist SOP workflow with Strands agent documentation.
+
     Args:
         use_case: Description of what the agent should do
         examples: Optional examples of expected agent behavior
@@ -131,9 +170,8 @@ def generate_agent_prompt(
         verbosity: Level of detail (minimal, normal, detailed)
 
     Returns:
-        Generated prompt text for agent development
+        Generated prompt combining SOP instructions with agent documentation
     """
-
     cache.ensure_ready()
 
     # Fetch documentation
@@ -148,16 +186,14 @@ def generate_agent_prompt(
     agent_api_url = "https://strandsagents.com/latest/documentation/docs/api-reference/agent/index.md"
     agent_api_content = fetch_content(agent_api_url)
 
-    # Fetch community tools documentation - just pass the raw content
     community_tools_url = (
         "https://strandsagents.com/latest/documentation/docs/user-guide/concepts/tools/community-tools-package/index.md"
     )
     community_tools_content = fetch_content(community_tools_url)
 
-    # Load and render template
+    # Load and render template for dynamic content
     template = jinja_env.get_template("agent_development.jinja2")
-
-    return template.render(
+    dynamic_content = template.render(
         use_case=use_case,
         examples=examples,
         agent_guidelines=agent_guidelines,
@@ -166,11 +202,14 @@ def generate_agent_prompt(
         llms_txt_content=llms_txt_content,
         agent_loop_content=agent_loop_content,
         agent_api_content=agent_api_content,
-        community_tools_content=community_tools_content,  # Pass raw content
+        community_tools_content=community_tools_content,
         include_examples=include_examples,
         verbosity=verbosity,
     )
 
+    # Combine SOP with dynamic content
+    return code_assist_with_input(dynamic_content)
+
 
 def generate_model_prompt(
     use_case: str,
@@ -182,6 +221,8 @@ def generate_model_prompt(
 ) -> str:
     """Generate a design-first custom model provider development prompt.
 
+    Combines the code-assist SOP workflow with Strands model provider documentation.
+
     Args:
         use_case: Description of the model provider's purpose
         model_details: Details about the models to support
@@ -191,9 +232,8 @@ def generate_model_prompt(
         include_examples: Whether to include code examples
 
     Returns:
-        Generated prompt text for model provider development
+        Generated prompt combining SOP instructions with model provider documentation
     """
-
     cache.ensure_ready()
 
     # Fetch documentation
@@ -203,10 +243,9 @@ def generate_model_prompt(
     models_api_url = "https://strandsagents.com/latest/documentation/docs/api-reference/models/index.md"
     models_api_content = fetch_content(models_api_url)
 
-    # Load and render template
+    # Load and render template for dynamic content
     template = jinja_env.get_template("model_development.jinja2")
-
-    return template.render(
+    dynamic_content = template.render(
         use_case=use_case,
         model_details=model_details,
         api_documentation=api_documentation,
@@ -217,6 +256,9 @@ def generate_model_prompt(
         include_examples=include_examples,
     )
 
+    # Combine SOP with dynamic content
+    return code_assist_with_input(dynamic_content)
+
 
 def generate_multiagent_prompt(
     use_case: str,
@@ -228,6 +270,8 @@ def generate_multiagent_prompt(
 ) -> str:
     """Generate a multi-agent systems development prompt.
 
+    Combines the code-assist SOP workflow with Strands multi-agent documentation.
+
     Args:
         use_case: Description of what the multi-agent system should accomplish
         pattern: Preferred pattern (graph/swarm/hybrid) or let the prompt guide selection
@@ -237,14 +281,10 @@ def generate_multiagent_prompt(
         include_examples: Whether to include code examples
 
     Returns:
-        A comprehensive prompt for multi-agent system development
+        Generated prompt combining SOP instructions with multi-agent documentation
     """
-
     cache.ensure_ready()
 
-    # Load the template
-    template = jinja_env.get_template("multiagent_development.jinja2")
-
     # Fetch multi-agent documentation
     graph_url = "https://strandsagents.com/latest/documentation/docs/user-guide/concepts/multi-agent/graph/index.md"
     swarm_url = "https://strandsagents.com/latest/documentation/docs/user-guide/concepts/multi-agent/swarm/index.md"
@@ -254,8 +294,9 @@ def generate_multiagent_prompt(
     swarm_content = fetch_content(swarm_url)
     multiagent_api_content = fetch_content(multiagent_api_url)
 
-    # Simply pass all parameters to template - no string building in Python!
-    return template.render(
+    # Load the template for dynamic content
+    template = jinja_env.get_template("multiagent_development.jinja2")
+    dynamic_content = template.render(
         use_case=use_case,
         pattern=pattern,
         agent_roles=agent_roles,
@@ -266,3 +307,6 @@ def generate_multiagent_prompt(
         multiagent_api_content=multiagent_api_content,
         include_examples=include_examples,
     )
+
+    # Combine SOP with dynamic content
+    return code_assist_with_input(dynamic_content)