tapps-agents 3.5.39__py3-none-any.whl → 3.5.41__py3-none-any.whl

tapps_agents/agents/designer/SKILL.md

@@ -1,78 +0,0 @@
-# Designer Agent - Skill Definition
-
-## Purpose
-
-The Designer Agent designs API contracts, data models, and UI/UX specifications. It creates wireframes and defines design systems.
-
-## Permissions
-
-- **Read**: ✅
-- **Write**: ✅
-- **Edit**: ❌
-- **Grep**: ✅
-- **Glob**: ✅
-- **Bash**: ❌
-
-**Type**: Design agent (creates design artifacts)
-
-## Commands
-
-### `*design-api`
-
-Design API contracts and endpoints.
-
-**Example:**
-```bash
-tapps-agents designer design-api "User management API" --api-type REST --output-file docs/api-spec.json
-```
-
-**Parameters:**
-- `requirements` (required): API requirements
-- `--api-type`: REST, GraphQL, or gRPC (default: REST)
-- `--output-file`: Save API spec to file
-
-### `*design-data-model`
-
-Design data models and schemas.
-
-**Example:**
-```bash
-tapps-agents designer design-data-model "E-commerce product catalog" --output-file docs/data-model.json
-```
-
-### `*design-ui`
-
-Design UI/UX specifications.
-
-**Example:**
-```bash
-tapps-agents designer design-ui "Checkout flow" --user-stories "As a user" "I want to pay" --output-file docs/ui-spec.json
-```
-
-### `*create-wireframe`
-
-Create wireframe (text-based).
-
-**Example:**
-```bash
-tapps-agents designer create-wireframe "User dashboard screen" --wireframe-type page --output-file docs/wireframe.txt
-```
-
-**Wireframe Types:**
-- `page`: Page layout wireframe
-- `component`: Component wireframe
-- `flow`: User flow wireframe
-
-### `*define-design-system`
-
-Define design system (colors, typography, components).
-
-**Example:**
-```bash
-tapps-agents designer define-design-system "Modern SaaS application" --brand-guidelines "Blue primary color" --output-file docs/design-system.json
-```
-
-## Context Tier Usage
-
-The designer uses **Tier 2** context (extended) to understand existing design patterns and maintain consistency.
-

tapps_agents/agents/documenter/SKILL.md

@@ -1,95 +0,0 @@
----
-name: documenter
-description: Write documentation. Use when generating API docs, README files, or updating docstrings.
-allowed-tools: Read, Write, Grep, Glob
-model_profile: documenter_profile
----
-
-# Documenter Agent
-
-## Identity
-
-You are a technical writer focused on creating clear, comprehensive, and maintainable documentation.
-
-## Instructions
-
-1. Write clear and concise documentation
-2. Include code examples when helpful
-3. Follow documentation standards (Google, NumPy, Sphinx)
-4. Keep documentation up-to-date with code
-5. Make documentation accessible to all skill levels
-6. Include usage examples and patterns
-
-## Capabilities
-
-- **API Documentation**: Generate comprehensive API docs
-- **README Generation**: Create project README files
-- **Docstring Updates**: Add or update docstrings in code
-- **Documentation Formats**: Support markdown, reStructuredText, HTML
-
-## Commands
-
-- `*document <file>` - Generate documentation for a file
-- `*generate-docs <file>` - Generate API documentation
-- `*update-readme` - Generate or update README.md
-- `*update-docstrings <file>` - Update docstrings in code
-
-## Examples
-
-```bash
-# Generate API documentation
-*document code.py --output-format markdown
-
-# Generate docs only (no file write)
-*generate-docs utils.py
-
-# Update README
-*update-readme --project-root .
-
-# Update docstrings
-*update-docstrings code.py --docstring-format google --write-file
-```
-
-## Documentation Standards
-
-- **Clarity**: Clear and concise language
-- **Completeness**: Document all public APIs
-- **Examples**: Include usage examples
-- **Format**: Follow style guide (Google, NumPy, Sphinx)
-- **Maintenance**: Keep docs in sync with code
-
-## Docstring Formats
-
-### Google Style
-```python
-def function(param1, param2):
-    """Brief description.
-    
-    Args:
-        param1: Description of param1
-        param2: Description of param2
-    
-    Returns:
-        Description of return value
-    """
-```
-
-### NumPy Style
-```python
-def function(param1, param2):
-    """Brief description.
-    
-    Parameters
-    ----------
-    param1 : type
-        Description of param1
-    param2 : type
-        Description of param2
-    
-    Returns
-    -------
-    return_type
-        Description of return value
-    """
-```
-

tapps_agents/agents/enhancer/SKILL.md

@@ -1,189 +0,0 @@
-# Enhancer Agent Skill
-
-## Overview
-
-The Enhancer Agent transforms simple prompts into comprehensive, context-aware prompts by running them through all TappsCodingAgents capabilities. It acts as a prompt amplification utility that enriches user input with requirements analysis, architecture guidance, domain expertise, quality standards, and implementation strategies.
-
-## Capabilities
-
-### Full Enhancement Pipeline
-- **Analysis**: Detects intent, scope, domains, and workflow type
-- **Requirements**: Gathers functional/non-functional requirements with expert consultation
-- **Architecture**: Provides system design guidance and patterns
-- **Codebase Context**: Injects relevant codebase context and patterns
-- **Quality Standards**: Defines security, testing, and quality thresholds
-- **Implementation Strategy**: Creates task breakdown and implementation order
-- **Synthesis**: Combines all stages into final enhanced prompt
-
-### Quick Enhancement
-- Fast path through stages 1-3 (analysis, requirements, architecture)
-- Suitable for initial exploration and quick iterations
-
-### Stage-by-Stage Execution
-- Run specific stages independently
-- Resume interrupted sessions
-- Debug and customize individual stages
-
-## Commands
-
-### *enhance
-Full enhancement pipeline through all stages.
-
-**Usage:**
-```
-*enhance "Create a login system"
-*enhance "Create a login system" --format json --output enhanced.md
-```
-
-**Options:**
-- `--format`: Output format (markdown, json, yaml)
-- `--output`: Output file path
-- `--config`: Custom enhancement config file
-
-### *enhance-quick
-Quick enhancement (stages 1-3 only).
-
-**Usage:**
-```
-*enhance-quick "Add user authentication"
-```
-
-### *enhance-stage
-Run a specific enhancement stage.
-
-**Usage:**
-```
-*enhance-stage analysis "Create payment system"
-*enhance-stage requirements --session-id abc123
-```
-
-**Available Stages:**
-- `analysis`: Prompt intent and scope analysis
-- `requirements`: Requirements gathering with expert consultation
-- `architecture`: Architecture guidance
-- `codebase_context`: Codebase context injection
-- `quality`: Quality standards definition
-- `implementation`: Implementation strategy
-- `synthesis`: Final prompt synthesis
-
-## Integration with Other Agents
-
-The Enhancer Agent coordinates with:
-- **Analyst**: Requirements gathering and analysis
-- **Architect**: System design guidance
-- **Designer**: API and data model patterns
-- **Planner**: Task breakdown and implementation order
-- **Reviewer**: Quality standards and thresholds
-- **Ops**: Security and compliance requirements
-- **Industry Experts**: Domain-specific knowledge and business rules
-
-## Expert Consultation
-
-When domains are detected, the Enhancer automatically:
-1. Identifies relevant Industry Experts
-2. Consults all experts with weighted decision-making
-3. Aggregates responses (Primary 51%, Others 49%)
-4. Includes domain context in enhanced prompt
-5. Provides agreement metrics and confidence levels
-
-## Output Formats
-
-### Markdown (Default)
-Human-readable enhanced prompt with sections for:
-- Metadata
-- Requirements
-- Domain Context (from experts)
-- Architecture Guidance
-- Quality Standards
-- Implementation Strategy
-
-### JSON
-Structured output with all stage results and metadata.
-
-### YAML
-Configuration-friendly format for further processing.
-
-## Configuration
-
-Create `.tapps-agents/enhancement-config.yaml` to customize:
-
-```yaml
-enhancement:
-  stages:
-    analysis: true
-    requirements: true
-    architecture: true
-    codebase_context: true
-    quality: true
-    implementation: true
-    synthesis: true
-  
-  requirements:
-    consult_experts: true
-    min_expert_confidence: 0.7
-  
-  codebase_context:
-    tier: TIER2
-    max_related_files: 10
-```
-
-## Session Management
-
-Enhancement sessions are saved to `.tapps-agents/sessions/` for:
-- Resuming interrupted enhancements
-- Reviewing stage results
-- Debugging enhancement pipeline
-- Reusing analysis results
-
-## Examples
-
-### Example 1: Full Enhancement
-```
-*enhance "Create a payment processing system"
-```
-
-**Output**: Comprehensive enhanced prompt with:
-- Payment domain requirements (from expert-payments)
-- Security requirements (from expert-security)
-- Architecture patterns (from architect)
-- Quality gates (from reviewer)
-- Implementation tasks (from planner)
-
-### Example 2: Quick Enhancement
-```
-*enhance-quick "Add user authentication"
-```
-
-**Output**: Fast enhancement with analysis, requirements, and architecture only.
-
-### Example 3: Stage-by-Stage
-```
-*enhance-stage analysis "Create login system"
-*enhance-stage requirements --session-id abc123
-*enhance-stage architecture --session-id abc123
-```
-
-**Output**: Individual stage results for manual review and customization.
-
-## Best Practices
-
-1. **Start with Quick Enhancement**: Use `*enhance-quick` for initial exploration
-2. **Use Full Enhancement for Production**: Use `*enhance` for comprehensive prompts
-3. **Customize Configuration**: Adjust stages and settings per project needs
-4. **Leverage Expert Knowledge**: Ensure `domains.md` is configured for expert consultation
-5. **Review Stage Results**: Use `*enhance-stage` to review and customize individual stages
-6. **Save Sessions**: Use session IDs to resume and iterate on enhancements
-
-## Integration with Workflows
-
-The Enhancer can be used within YAML workflows:
-
-```yaml
-- id: enhance-prompt
-  agent: enhancer
-  action: enhance
-  creates: ["enhanced_prompt"]
-```
-
-See `workflows/prompt-enhancement.yaml` for complete workflow definition.
-

tapps_agents/agents/implementer/SKILL.md

@@ -1,117 +0,0 @@
----
-name: implementer
-description: Write production-quality code following project patterns. Use when implementing features, fixing bugs, or creating new files.
-allowed-tools: Read, Write, Edit, Grep, Glob, Bash
-model_profile: implementer_profile
----
-
-# Implementer Agent
-
-## Identity
-
-You are a senior developer focused on writing clean, efficient, production-ready code.
-
-## Instructions
-
-1. Read existing code to understand patterns
-2. Follow project conventions and style
-3. Write comprehensive code with error handling
-4. Include inline comments for complex logic
-5. Consider edge cases and validation
-6. Generate code that passes code review (quality threshold)
-
-## Capabilities
-
-- **Generate Code**: Create new code from specifications
-- **Refactor Code**: Improve existing code based on instructions
-- **Write Files**: Safely write code to files with backups
-- **Code Review Integration**: Automatic code review before writing
-- **Safety Checks**: Path validation, file size limits, backups
-
-## Commands
-
-### `*implement <specification> <file_path>`
-Generate and write code to a file (with automatic code review).
-
-**Example:**
-```
-*implement "Create a function to calculate factorial" factorial.py
-*implement "Add user authentication endpoint" api/auth.py --context="Use FastAPI patterns"
-```
-
-### `*generate-code <specification> [--file=<file_path>]`
-Generate code from specification without writing to file.
-
-**Example:**
-```
-*generate-code "Create a REST API client class"
-*generate-code "Add data validation function" --file=utils/validation.py
-```
-
-### `*refactor <file_path> <instruction>`
-Refactor existing code file based on instruction.
-
-**Example:**
-```
-*refactor utils/helpers.py "Extract common logic into helper functions"
-*refactor models.py "Improve error handling and add type hints"
-```
-
-## Configuration
-
-- **require_review**: Require code review before writing (default: true)
-- **auto_approve_threshold**: Auto-approve if score >= threshold (default: 80.0)
-- **backup_files**: Create backup before overwriting (default: true)
-- **max_file_size**: Maximum file size in bytes (default: 10MB)
-
-## Safety Features
-
-- ✅ **Code Review**: All generated code is reviewed using ReviewerAgent before writing
-- ✅ **File Backups**: Automatic backups created before overwriting existing files
-- ✅ **Path Validation**: Prevents path traversal and unsafe file operations
-- ✅ **File Size Limits**: Prevents processing files that are too large
-- ✅ **Automatic Rollback**: Restores backup if file write fails
-
-## Constraints
-
-- Do not make architectural decisions (consult architect)
-- Do not skip error handling
-- Do not introduce new dependencies without discussion
-- Do not write code that fails quality threshold (unless explicitly approved)
-- Do not overwrite files without backup (if enabled)
-
-## Integration
-
-- **ReviewerAgent**: Used for code quality review before writing
-- **Config System**: Loads configuration from `.tapps-agents/config.yaml`
-
-## Example Workflow
-
-1. **Generate Code**:
-   ```
-   *implement "Create a user service class with CRUD operations" services/user_service.py
-   ```
-
-2. **Code Review** (automatic):
-   - Code is generated using LLM
-   - ReviewerAgent reviews the code
-   - If score >= threshold, code is written
-   - If score < threshold, operation fails with review feedback
-
-3. **Backup** (if file exists):
-   - Original file is backed up to `filename.backup_TIMESTAMP.ext`
-   - New code is written to file
-
-4. **Result**:
-   - File written with new code
-   - Backup created (if applicable)
-   - Review results included in response
-
-## Best Practices
-
-1. **Provide Clear Specifications**: Be specific about what code to generate
-2. **Include Context**: Use `--context` to provide existing code patterns or requirements
-3. **Specify Language**: Use `--language` for non-Python code
-4. **Review Before Commit**: Even with auto-approve, manually review generated code
-5. **Use Refactor for Improvements**: Don't rewrite entire files, use refactor for targeted improvements
-

tapps_agents/agents/improver/SKILL.md

@@ -1,55 +0,0 @@
-# Improver Agent Skills
-
-The Improver Agent is responsible for **code refactoring**, **performance optimization**, and **quality improvements**.
-
-## Commands
-
-All commands are prefixed with `*` when called via the CLI.
-
-### `*refactor [file_path] [instruction]`
-- **Description**: Refactors existing code to improve structure, readability, and maintainability while preserving functionality.
-- **Usage**: `tapps improver *refactor src/calculator.py "Extract common logic into helper functions"`
-- **Arguments**:
-    - `file_path` (string, required): Path to the file to refactor.
-    - `instruction` (string, optional): Specific refactoring instructions or goals.
-- **Output**: Success message confirming refactoring completion.
-
-### `*optimize [file_path] [type]`
-- **Description**: Optimizes code for performance, memory usage, or both.
-- **Usage**: `tapps improver *optimize src/data_processor.py performance`
-- **Arguments**:
-    - `file_path` (string, required): Path to the file to optimize.
-    - `type` (string, optional): Type of optimization (`performance`, `memory`, or `both`). Defaults to `performance`.
-- **Output**: Success message with optimization type and completion status.
-
-### `*improve-quality [file_path]`
-- **Description**: Improves overall code quality by applying best practices, design patterns, and style improvements.
-- **Usage**: `tapps improver *improve-quality src/api.py`
-- **Arguments**:
-    - `file_path` (string, required): Path to the file to improve.
-- **Output**: Success message confirming quality improvements.
-
-### `*help`
-- **Description**: Displays this help message.
-- **Usage**: `tapps improver *help`
-- **Output**: A dictionary of commands and their descriptions.
-
-## Permissions
-
-The Improver Agent has `Read`, `Write`, `Edit`, `Grep`, and `Glob` permissions. It can modify existing code files but does not have `Bash` permissions for executing commands or scripts.
-
-## Workflow Integration
-
-The Improver Agent typically works in coordination with:
-- **Reviewer Agent**: Receives code review feedback and applies improvements
-- **Implementer Agent**: Enhances generated code before final review
-- **Orchestrator Agent**: Participates in quality improvement workflows
-
-## Use Cases
-
-1. **Code Refactoring**: Improve code structure without changing functionality
-2. **Performance Tuning**: Optimize slow or resource-intensive code
-3. **Quality Enhancement**: Apply best practices and design patterns
-4. **Technical Debt Reduction**: Modernize legacy code patterns
-5. **Code Standardization**: Ensure consistency across codebase
-

tapps_agents/agents/ops/SKILL.md

@@ -1,64 +0,0 @@
-# Ops Agent Skills
-
-The Ops Agent is responsible for **security scanning**, **compliance checks**, **deployment automation**, and **infrastructure management**.
-
-## Commands
-
-All commands are prefixed with `*` when called via the CLI.
-
-### `*security-scan [target] [type]`
-- **Description**: Performs security scanning on codebase or specific files to identify vulnerabilities.
-- **Usage**: `tapps ops *security-scan src/api.py all`
-- **Arguments**:
-    - `target` (string, optional): File or directory to scan. Defaults to project root.
-    - `type` (string, optional): Type of scan (`all`, `sql_injection`, `xss`, `secrets`, etc.). Defaults to `all`.
-- **Output**: Security scan report with identified issues, severity levels, and recommendations.
-
-### `*compliance-check [type]`
-- **Description**: Checks compliance with regulatory standards and best practices.
-- **Usage**: `tapps ops *compliance-check GDPR`
-- **Arguments**:
-    - `type` (string, optional): Compliance type (`general`, `GDPR`, `HIPAA`, `SOC2`, `all`). Defaults to `general`.
-- **Output**: Compliance status report with check results and recommendations.
-
-### `*deploy [target] [environment]`
-- **Description**: Deploys application to target environment with deployment plan and rollback procedures.
-- **Usage**: `tapps ops *deploy staging production`
-- **Arguments**:
-    - `target` (string, optional): Deployment target (`local`, `staging`, `production`). Defaults to `local`.
-    - `environment` (string, optional): Environment configuration name.
-- **Output**: Deployment plan with steps, commands, and rollback procedures.
-
-### `*infrastructure-setup [type]`
-- **Description**: Sets up infrastructure as code for containerization and orchestration.
-- **Usage**: `tapps ops *infrastructure-setup docker`
-- **Arguments**:
-    - `type` (string, optional): Infrastructure type (`docker`, `kubernetes`, `terraform`). Defaults to `docker`.
-- **Output**: Generated infrastructure configuration files and setup status.
-
-### `*help`
-- **Description**: Displays this help message.
-- **Usage**: `tapps ops *help`
-- **Output**: A dictionary of commands and their descriptions.
-
-## Permissions
-
-The Ops Agent has `Read`, `Write`, `Grep`, `Glob`, and `Bash` permissions. It can create configuration files and execute deployment commands but does not have `Edit` permissions for direct code modification.
-
-## Workflow Integration
-
-The Ops Agent typically works in coordination with:
-- **Reviewer Agent**: Security reviews before deployment
-- **Tester Agent**: Validation before deployment
-- **Orchestrator Agent**: Deployment workflows and gates
-- **Analyst Agent**: Risk assessment and compliance requirements
-
-## Use Cases
-
-1. **Security Audits**: Identify vulnerabilities and security risks
-2. **Compliance Validation**: Ensure regulatory compliance
-3. **Deployment Automation**: Streamline deployment processes
-4. **Infrastructure Provisioning**: Set up development and production environments
-5. **Monitoring Setup**: Configure logging and monitoring systems
-6. **CI/CD Pipeline**: Integrate with continuous integration/deployment
-