tapps-agents 3.5.40__py3-none-any.whl → 3.6.0__py3-none-any.whl

tapps_agents/cli/parsers/debugger.py

@@ -1,116 +1,116 @@
-"""
-Debugger agent parser definitions
-"""
-import argparse
-
-
-def add_debugger_parser(subparsers: argparse._SubParsersAction) -> None:
-    """Add debugger agent parser and subparsers"""
-    debugger_parser = subparsers.add_parser(
-        "debugger",
-        help="Debugger Agent commands",
-        description="""Error debugging and code analysis agent.
-        
-The Debugger Agent helps diagnose and fix issues:
-  • Debug errors and exceptions
-  • Analyze stack traces
-  • Trace code execution paths
-  • Identify root causes
-  • Suggest fixes
-
-Use this agent when encountering bugs or unexpected behavior in your code.""",
-    )
-    debugger_subparsers = debugger_parser.add_subparsers(
-        dest="command", help="Debugger agent subcommand (use 'help' to see all available commands)"
-    )
-
-    debug_parser = debugger_subparsers.add_parser(
-        "debug",
-        aliases=["*debug"],
-        help="Debug an error or issue",
-        description="""Debug errors and issues in your code.
-        
-Analyzes error messages, stack traces, and code context to:
-  • Identify root causes
-  • Suggest fixes
-  • Explain error mechanisms
-  • Provide prevention strategies
-
-Example:
-  tapps-agents debugger debug "KeyError: 'user_id'" --file src/api.py --line 42
-  tapps-agents debugger debug "Connection timeout" --stack-trace "traceback.txt\"""",
-    )
-    debug_parser.add_argument("error_message", help="The error message or exception text to debug. Include the full error message for best results.")
-    debug_parser.add_argument("--file", help="Path to the source code file where the error occurred. Helps provide context-aware debugging.")
-    debug_parser.add_argument(
-        "--line", type=int, help="Line number in the source file where the error occurred. Combined with --file, provides precise error location."
-    )
-    debug_parser.add_argument("--stack-trace", help="Full stack trace from the error. Can be a file path or the stack trace text. Provides execution context for better debugging.")
-    debug_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    debug_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
-    debug_parser.add_argument(
-        "--verbose-output",
-        action="store_true",
-        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
-    )
-
-    analyze_error_parser = debugger_subparsers.add_parser(
-        "analyze-error",
-        aliases=["*analyze-error"],
-        help="Perform detailed analysis of error message and stack trace",
-        description="""Analyze error messages and stack traces to identify root causes.
-        
-Provides:
-  • Error type and category identification
-  • Root cause analysis
-  • Execution path leading to error
-  • Variable state analysis
-  • Suggested fixes
-  • Prevention strategies
-
-Use this for in-depth error analysis when you have both error message and stack trace available.""",
-    )
-    analyze_error_parser.add_argument("error_message", help="The error message or exception text to analyze. Include the complete error message.")
-    analyze_error_parser.add_argument("--stack-trace", help="Full stack trace from the error. Can be a file path containing the stack trace or the stack trace text itself.")
-    analyze_error_parser.add_argument(
-        "--code-context", help="Code context around the error location (e.g., function code, surrounding lines). Helps provide more accurate analysis by understanding the code structure."
-    )
-    analyze_error_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    analyze_error_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
-    analyze_error_parser.add_argument(
-        "--verbose-output",
-        action="store_true",
-        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
-    )
-
-    trace_parser = debugger_subparsers.add_parser(
-        "trace", 
-        aliases=["*trace"], 
-        help="Trace code execution path and control flow",
-        description="""Trace code execution path to understand control flow and identify issues.
-        
-Analyzes:
-  • Function call sequences
-  • Control flow paths
-  • Variable state changes
-  • Conditional branches taken
-  • Loop iterations
-  • Exception handling paths
-
-Use this to understand how code executes and identify unexpected execution paths or logic errors.""",
-    )
-    trace_parser.add_argument("file", help="Path to the source code file to trace. The file will be analyzed to determine execution paths.")
-    trace_parser.add_argument("--function", help="Name of the function to start tracing from. If not provided, traces from the entry point of the file.")
-    trace_parser.add_argument("--line", type=int, help="Line number to start tracing from. Useful for tracing from a specific point in the code.")
-    trace_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    trace_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
-    trace_parser.add_argument(
-        "--verbose-output",
-        action="store_true",
-        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
-    )
-
-    debugger_subparsers.add_parser(
-        "help", aliases=["*help"], help="Show debugger commands"
-    )
-
+"""
+Debugger agent parser definitions
+"""
+import argparse
+
+
+def add_debugger_parser(subparsers: argparse._SubParsersAction) -> None:
+    """Add debugger agent parser and subparsers"""
+    debugger_parser = subparsers.add_parser(
+        "debugger",
+        help="Debugger Agent commands",
+        description="""Error debugging and code analysis agent.
+        
+The Debugger Agent helps diagnose and fix issues:
+  • Debug errors and exceptions
+  • Analyze stack traces
+  • Trace code execution paths
+  • Identify root causes
+  • Suggest fixes
+
+Use this agent when encountering bugs or unexpected behavior in your code.""",
+    )
+    debugger_subparsers = debugger_parser.add_subparsers(
+        dest="command", help="Debugger agent subcommand (use 'help' to see all available commands)"
+    )
+
+    debug_parser = debugger_subparsers.add_parser(
+        "debug",
+        aliases=["*debug"],
+        help="Debug an error or issue",
+        description="""Debug errors and issues in your code.
+        
+Analyzes error messages, stack traces, and code context to:
+  • Identify root causes
+  • Suggest fixes
+  • Explain error mechanisms
+  • Provide prevention strategies
+
+Example:
+  tapps-agents debugger debug "KeyError: 'user_id'" --file src/api.py --line 42
+  tapps-agents debugger debug "Connection timeout" --stack-trace "traceback.txt\"""",
+    )
+    debug_parser.add_argument("error_message", help="The error message or exception text to debug. Include the full error message for best results.")
+    debug_parser.add_argument("--file", help="Path to the source code file where the error occurred. Helps provide context-aware debugging.")
+    debug_parser.add_argument(
+        "--line", type=int, help="Line number in the source file where the error occurred. Combined with --file, provides precise error location."
+    )
+    debug_parser.add_argument("--stack-trace", help="Full stack trace from the error. Can be a file path or the stack trace text. Provides execution context for better debugging.")
+    debug_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    debug_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
+    debug_parser.add_argument(
+        "--verbose-output",
+        action="store_true",
+        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
+    )
+
+    analyze_error_parser = debugger_subparsers.add_parser(
+        "analyze-error",
+        aliases=["*analyze-error"],
+        help="Perform detailed analysis of error message and stack trace",
+        description="""Analyze error messages and stack traces to identify root causes.
+        
+Provides:
+  • Error type and category identification
+  • Root cause analysis
+  • Execution path leading to error
+  • Variable state analysis
+  • Suggested fixes
+  • Prevention strategies
+
+Use this for in-depth error analysis when you have both error message and stack trace available.""",
+    )
+    analyze_error_parser.add_argument("error_message", help="The error message or exception text to analyze. Include the complete error message.")
+    analyze_error_parser.add_argument("--stack-trace", help="Full stack trace from the error. Can be a file path containing the stack trace or the stack trace text itself.")
+    analyze_error_parser.add_argument(
+        "--code-context", help="Code context around the error location (e.g., function code, surrounding lines). Helps provide more accurate analysis by understanding the code structure."
+    )
+    analyze_error_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    analyze_error_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
+    analyze_error_parser.add_argument(
+        "--verbose-output",
+        action="store_true",
+        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
+    )
+
+    trace_parser = debugger_subparsers.add_parser(
+        "trace", 
+        aliases=["*trace"], 
+        help="Trace code execution path and control flow",
+        description="""Trace code execution path to understand control flow and identify issues.
+        
+Analyzes:
+  • Function call sequences
+  • Control flow paths
+  • Variable state changes
+  • Conditional branches taken
+  • Loop iterations
+  • Exception handling paths
+
+Use this to understand how code executes and identify unexpected execution paths or logic errors.""",
+    )
+    trace_parser.add_argument("file", help="Path to the source code file to trace. The file will be analyzed to determine execution paths.")
+    trace_parser.add_argument("--function", help="Name of the function to start tracing from. If not provided, traces from the entry point of the file.")
+    trace_parser.add_argument("--line", type=int, help="Line number to start tracing from. Useful for tracing from a specific point in the code.")
+    trace_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    trace_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
+    trace_parser.add_argument(
+        "--verbose-output",
+        action="store_true",
+        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
+    )
+
+    debugger_subparsers.add_parser(
+        "help", aliases=["*help"], help="Show debugger commands"
+    )
+

tapps_agents/cli/parsers/designer.py

@@ -1,182 +1,182 @@
-"""
-Designer agent parser definitions
-"""
-import argparse
-
-
-def add_designer_parser(subparsers: argparse._SubParsersAction) -> None:
-    """Add designer agent parser and subparsers"""
-    designer_parser = subparsers.add_parser(
-        "designer",
-        help="Designer Agent commands",
-        description="""API, data model, and UI/UX design agent.
-        
-The Designer Agent creates design specifications:
-  • API design (REST, GraphQL, gRPC)
-  • Data model and schema design
-  • UI/UX design specifications
-  • Wireframes
-  • Design systems
-
-Use this agent to design interfaces, APIs, and user experiences before implementation.""",
-    )
-    designer_subparsers = designer_parser.add_subparsers(
-        dest="command", help="Designer agent subcommand (use 'help' to see all available commands)"
-    )
-
-    api_design_parser = designer_subparsers.add_parser(
-        "api-design",
-        aliases=["*api-design"],
-        help="Design APIs (REST, GraphQL, gRPC)",
-        description="""Design API specifications for REST, GraphQL, or gRPC.
-        
-Creates comprehensive API designs including:
-  • Endpoints and routes
-  • Request/response schemas
-  • Authentication and authorization
-  • Error handling
-  • Versioning strategy
-  • Documentation structure
-
-Example:
-  tapps-agents designer api-design "User management API with CRUD operations"
-  tapps-agents designer api-design "Product catalog API" --api-type GraphQL --output-file api-spec.yaml""",
-    )
-    api_design_parser.add_argument("requirements", help="API requirements description including endpoints needed, data models, authentication requirements, and use cases. Be specific about functionality and constraints.")
-    api_design_parser.add_argument(
-        "--api-type", default="REST", help="API type to design: 'REST' for RESTful APIs (default), 'GraphQL' for GraphQL APIs, 'gRPC' for gRPC services"
-    )
-    api_design_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    api_design_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
-    api_design_parser.add_argument(
-        "--no-enhance",
-        action="store_true",
-        help="Disable automatic prompt enhancement for this command",
-    )
-    api_design_parser.add_argument(
-        "--enhance",
-        action="store_true",
-        help="Force prompt enhancement even if quality is high",
-    )
-    api_design_parser.add_argument(
-        "--enhance-mode",
-        choices=["quick", "full"],
-        help="Override enhancement mode: 'quick' for fast 3-stage enhancement, 'full' for complete 7-stage enhancement",
-    )
-    api_design_parser.add_argument(
-        "--verbose-output",
-        action="store_true",
-        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
-    )
-
-    data_model_parser = designer_subparsers.add_parser(
-        "data-model-design",
-        aliases=["*data-model-design"],
-        help="Design data models, schemas, and database structures",
-        description="""Design comprehensive data models and database schemas.
-        
-Creates:
-  • Entity definitions and relationships
-  • Field types and constraints
-  • Primary and foreign keys
-  • Indexes and optimization
-  • Validation rules
-  • Migration considerations
-
-Use this to design database schemas, ORM models, or data structures before implementation.""",
-    )
-    data_model_parser.add_argument("requirements", help="Data model requirements description including entities, relationships, data types, constraints, and use cases. Describe what data needs to be stored and how it relates.")
-    data_model_parser.add_argument("--data-source", help="Description of the data source or database system (e.g., 'PostgreSQL', 'MongoDB', 'in-memory'). Influences schema design and optimization strategies.")
-    data_model_parser.add_argument(
-        "--no-enhance",
-        action="store_true",
-        help="Disable automatic prompt enhancement for this command",
-    )
-    data_model_parser.add_argument(
-        "--enhance",
-        action="store_true",
-        help="Force prompt enhancement even if quality is high",
-    )
-    data_model_parser.add_argument(
-        "--enhance-mode",
-        choices=["quick", "full"],
-        help="Override enhancement mode: 'quick' for fast 3-stage enhancement, 'full' for complete 7-stage enhancement",
-    )
-    data_model_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    data_model_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
-
-    ui_ux_parser = designer_subparsers.add_parser(
-        "ui-ux-design",
-        aliases=["*ui-ux-design"],
-        help="Design user interfaces and user experiences",
-        description="""Design user interfaces and user experience specifications.
-        
-Creates:
-  • UI component specifications
-  • User flow diagrams
-  • Interaction patterns
-  • Accessibility considerations
-  • Responsive design guidelines
-  • User experience principles
-
-Use this to design interfaces before implementation, ensuring good UX and accessibility.""",
-    )
-    ui_ux_parser.add_argument("feature_description", help="Description of the feature or interface to design. Include user goals, functionality, and any design constraints or brand guidelines.")
-    ui_ux_parser.add_argument("--user-stories", nargs="+", help="Space-separated list of user stories that inform the design (e.g., 'As a user, I want to login so that I can access my account'). Helps ensure design meets user needs.")
-    ui_ux_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    ui_ux_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
-
-    wireframes_parser = designer_subparsers.add_parser(
-        "wireframes", 
-        aliases=["*wireframes"], 
-        help="Generate wireframes for user interface design",
-        description="""Generate wireframe specifications for UI screens and components.
-        
-Creates:
-  • Layout structure and positioning
-  • Component placement
-  • Navigation elements
-  • Content hierarchy
-  • Interactive elements
-  • Responsive breakpoints
-
-Wireframes are provided in text format (ASCII art or structured descriptions) that can be used as blueprints for implementation.""",
-    )
-    wireframes_parser.add_argument("screen_description", help="Description of the screen, page, or component to wireframe. Include purpose, key elements, user actions, and layout requirements.")
-    wireframes_parser.add_argument(
-        "--wireframe-type",
-        default="page",
-        help="Type of wireframe to generate: 'page' for full page layouts (default), 'component' for individual UI components, 'flow' for multi-screen user flows",
-    )
-    wireframes_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    wireframes_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
-
-    design_system_designer_parser = designer_subparsers.add_parser(
-        "design-system",
-        aliases=["*design-system"],
-        help="Develop or extend a design system for consistent UI/UX",
-        description="""Create or extend a comprehensive design system.
-        
-Develops:
-  • Component library specifications
-  • Design tokens (colors, typography, spacing)
-  • Style guidelines
-  • Usage patterns and best practices
-  • Accessibility standards
-  • Responsive design rules
-
-Use this to establish or extend a design system that ensures consistency across your application.""",
-    )
-    design_system_designer_parser.add_argument(
-        "project_description", help="Description of the project or application for which to develop the design system. Include project goals, target users, and any existing design elements."
-    )
-    design_system_designer_parser.add_argument(
-        "--brand-guidelines", help="Brand guidelines, color schemes, typography preferences, or existing brand assets that should be incorporated into the design system"
-    )
-    design_system_designer_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
-    design_system_designer_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
-
-    designer_subparsers.add_parser(
-        "help", aliases=["*help"], help="Show designer commands"
-    )
-
+"""
+Designer agent parser definitions
+"""
+import argparse
+
+
+def add_designer_parser(subparsers: argparse._SubParsersAction) -> None:
+    """Add designer agent parser and subparsers"""
+    designer_parser = subparsers.add_parser(
+        "designer",
+        help="Designer Agent commands",
+        description="""API, data model, and UI/UX design agent.
+        
+The Designer Agent creates design specifications:
+  • API design (REST, GraphQL, gRPC)
+  • Data model and schema design
+  • UI/UX design specifications
+  • Wireframes
+  • Design systems
+
+Use this agent to design interfaces, APIs, and user experiences before implementation.""",
+    )
+    designer_subparsers = designer_parser.add_subparsers(
+        dest="command", help="Designer agent subcommand (use 'help' to see all available commands)"
+    )
+
+    api_design_parser = designer_subparsers.add_parser(
+        "api-design",
+        aliases=["*api-design"],
+        help="Design APIs (REST, GraphQL, gRPC)",
+        description="""Design API specifications for REST, GraphQL, or gRPC.
+        
+Creates comprehensive API designs including:
+  • Endpoints and routes
+  • Request/response schemas
+  • Authentication and authorization
+  • Error handling
+  • Versioning strategy
+  • Documentation structure
+
+Example:
+  tapps-agents designer api-design "User management API with CRUD operations"
+  tapps-agents designer api-design "Product catalog API" --api-type GraphQL --output-file api-spec.yaml""",
+    )
+    api_design_parser.add_argument("requirements", help="API requirements description including endpoints needed, data models, authentication requirements, and use cases. Be specific about functionality and constraints.")
+    api_design_parser.add_argument(
+        "--api-type", default="REST", help="API type to design: 'REST' for RESTful APIs (default), 'GraphQL' for GraphQL APIs, 'gRPC' for gRPC services"
+    )
+    api_design_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    api_design_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
+    api_design_parser.add_argument(
+        "--no-enhance",
+        action="store_true",
+        help="Disable automatic prompt enhancement for this command",
+    )
+    api_design_parser.add_argument(
+        "--enhance",
+        action="store_true",
+        help="Force prompt enhancement even if quality is high",
+    )
+    api_design_parser.add_argument(
+        "--enhance-mode",
+        choices=["quick", "full"],
+        help="Override enhancement mode: 'quick' for fast 3-stage enhancement, 'full' for complete 7-stage enhancement",
+    )
+    api_design_parser.add_argument(
+        "--verbose-output",
+        action="store_true",
+        help="Include all verbose debug data in output. By default, output is compacted to prevent Cursor terminal overflow.",
+    )
+
+    data_model_parser = designer_subparsers.add_parser(
+        "data-model-design",
+        aliases=["*data-model-design"],
+        help="Design data models, schemas, and database structures",
+        description="""Design comprehensive data models and database schemas.
+        
+Creates:
+  • Entity definitions and relationships
+  • Field types and constraints
+  • Primary and foreign keys
+  • Indexes and optimization
+  • Validation rules
+  • Migration considerations
+
+Use this to design database schemas, ORM models, or data structures before implementation.""",
+    )
+    data_model_parser.add_argument("requirements", help="Data model requirements description including entities, relationships, data types, constraints, and use cases. Describe what data needs to be stored and how it relates.")
+    data_model_parser.add_argument("--data-source", help="Description of the data source or database system (e.g., 'PostgreSQL', 'MongoDB', 'in-memory'). Influences schema design and optimization strategies.")
+    data_model_parser.add_argument(
+        "--no-enhance",
+        action="store_true",
+        help="Disable automatic prompt enhancement for this command",
+    )
+    data_model_parser.add_argument(
+        "--enhance",
+        action="store_true",
+        help="Force prompt enhancement even if quality is high",
+    )
+    data_model_parser.add_argument(
+        "--enhance-mode",
+        choices=["quick", "full"],
+        help="Override enhancement mode: 'quick' for fast 3-stage enhancement, 'full' for complete 7-stage enhancement",
+    )
+    data_model_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    data_model_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
+
+    ui_ux_parser = designer_subparsers.add_parser(
+        "ui-ux-design",
+        aliases=["*ui-ux-design"],
+        help="Design user interfaces and user experiences",
+        description="""Design user interfaces and user experience specifications.
+        
+Creates:
+  • UI component specifications
+  • User flow diagrams
+  • Interaction patterns
+  • Accessibility considerations
+  • Responsive design guidelines
+  • User experience principles
+
+Use this to design interfaces before implementation, ensuring good UX and accessibility.""",
+    )
+    ui_ux_parser.add_argument("feature_description", help="Description of the feature or interface to design. Include user goals, functionality, and any design constraints or brand guidelines.")
+    ui_ux_parser.add_argument("--user-stories", nargs="+", help="Space-separated list of user stories that inform the design (e.g., 'As a user, I want to login so that I can access my account'). Helps ensure design meets user needs.")
+    ui_ux_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    ui_ux_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
+
+    wireframes_parser = designer_subparsers.add_parser(
+        "wireframes", 
+        aliases=["*wireframes"], 
+        help="Generate wireframes for user interface design",
+        description="""Generate wireframe specifications for UI screens and components.
+        
+Creates:
+  • Layout structure and positioning
+  • Component placement
+  • Navigation elements
+  • Content hierarchy
+  • Interactive elements
+  • Responsive breakpoints
+
+Wireframes are provided in text format (ASCII art or structured descriptions) that can be used as blueprints for implementation.""",
+    )
+    wireframes_parser.add_argument("screen_description", help="Description of the screen, page, or component to wireframe. Include purpose, key elements, user actions, and layout requirements.")
+    wireframes_parser.add_argument(
+        "--wireframe-type",
+        default="page",
+        help="Type of wireframe to generate: 'page' for full page layouts (default), 'component' for individual UI components, 'flow' for multi-screen user flows",
+    )
+    wireframes_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    wireframes_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
+
+    design_system_designer_parser = designer_subparsers.add_parser(
+        "design-system",
+        aliases=["*design-system"],
+        help="Develop or extend a design system for consistent UI/UX",
+        description="""Create or extend a comprehensive design system.
+        
+Develops:
+  • Component library specifications
+  • Design tokens (colors, typography, spacing)
+  • Style guidelines
+  • Usage patterns and best practices
+  • Accessibility standards
+  • Responsive design rules
+
+Use this to establish or extend a design system that ensures consistency across your application.""",
+    )
+    design_system_designer_parser.add_argument(
+        "project_description", help="Description of the project or application for which to develop the design system. Include project goals, target users, and any existing design elements."
+    )
+    design_system_designer_parser.add_argument(
+        "--brand-guidelines", help="Brand guidelines, color schemes, typography preferences, or existing brand assets that should be incorporated into the design system"
+    )
+    design_system_designer_parser.add_argument("--output", help="Output file path. If specified, results will be written to this file instead of stdout. Format is determined by file extension or --format option.")
+    design_system_designer_parser.add_argument("--format", choices=["json", "text", "markdown"], default="json", help="Output format: 'json' for structured data (default), 'text' for human-readable, 'markdown' for markdown format")
+
+    designer_subparsers.add_parser(
+        "help", aliases=["*help"], help="Show designer commands"
+    )
+