proagents 1.6.20 → 1.6.21

package/.proagents/pm-integration/linear.md

@@ -1,409 +0,0 @@
-# Linear Integration
-
-Modern, fast integration with Linear for agile development teams.
-
----
-
-## Setup
-
-### 1. Create API Key
-
-1. Go to Linear Settings → API
-2. Click "Create key"
-3. Name it "ProAgents"
-4. Copy the API key
-
-### 2. Configure Connection
-
-```yaml
-# proagents.config.yaml
-
-integrations:
-  linear:
-    enabled: true
-    api_key_env: "LINEAR_API_KEY"
-
-    # Team settings
-    team_id: "TEAM-123"  # or team key
-    default_project: "Backend"
-```
-
-### 3. Set Environment Variable
-
-```bash
-export LINEAR_API_KEY="lin_api_xxxxx"
-```
-
-### 4. Verify Connection
-
-```bash
-proagents pm connect linear
-proagents pm status
-```
-
----
-
-## Configuration
-
-```yaml
-integrations:
-  linear:
-    enabled: true
-    api_key_env: "LINEAR_API_KEY"
-
-    # Team and project
-    team_id: "TEAM-123"
-    default_project: "Backend"
-
-    # Issue defaults
-    defaults:
-      state: "Backlog"
-      priority: 2  # 0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low
-
-    # Label mapping
-    labels:
-      feature: "feature"
-      bug: "bug"
-      refactor: "improvement"
-      proagents: "proagents-managed"
-```
-
----
-
-## State Mapping
-
-Map ProAgents phases to Linear states:
-
-```yaml
-integrations:
-  linear:
-    state_mapping:
-      # ProAgents phase: Linear state
-      init: "Backlog"
-      analysis: "In Progress"
-      requirements: "In Progress"
-      design: "In Progress"
-      planning: "In Progress"
-      implementation: "In Progress"
-      testing: "In Review"
-      review: "In Review"
-      documentation: "In Review"
-      deployment: "Done"
-      deployed: "Done"
-
-    # Custom states (if using custom workflow)
-    custom_states:
-      in_development: "state_uuid_1"
-      in_qa: "state_uuid_2"
-```
-
----
-
-## Auto-Actions
-
-### On Feature Start
-
-```yaml
-integrations:
-  linear:
-    on_feature_start:
-      create_issue: true
-
-      template:
-        title: "{{feature_name}}"
-        description: |
-          ## Description
-          {{feature_description}}
-
-          ## Acceptance Criteria
-          {{acceptance_criteria}}
-
-          ---
-          *Managed by ProAgents*
-
-        labels:
-          - "proagents"
-          - "{{entry_mode}}"
-
-        # Assign to current user
-        assign_to_me: true
-```
-
-### On Phase Change
-
-```yaml
-integrations:
-  linear:
-    on_phase_change:
-      update_state: true
-      add_comment: true
-
-      comment_template: |
-        **Phase**: {{current_phase}}
-        **Progress**: {{progress_percentage}}%
-
-        {{phase_summary}}
-```
-
-### On PR Created
-
-```yaml
-integrations:
-  linear:
-    on_pr_created:
-      # Linear auto-links PRs with issue ID in branch name
-      add_comment: true
-
-      comment_template: |
-        PR opened: [{{pr_title}}]({{pr_url}})
-```
-
-### On Feature Complete
-
-```yaml
-integrations:
-  linear:
-    on_feature_complete:
-      complete_issue: true
-      add_comment: true
-
-      comment_template: |
-        **Completed**
-
-        - Duration: {{total_duration}}
-        - Test Coverage: {{test_coverage}}%
-        - Files Changed: {{files_changed}}
-```
-
----
-
-## Cycle Integration
-
-Integrate with Linear Cycles (Sprints):
-
-```yaml
-integrations:
-  linear:
-    cycles:
-      # Assign to current cycle
-      assign_to_current: true
-
-      # Or specify cycle
-      default_cycle: "cycle_uuid"
-
-      # Create cycle if not exists
-      auto_create: false
-```
-
----
-
-## Project Integration
-
-```yaml
-integrations:
-  linear:
-    projects:
-      # Map feature types to projects
-      mapping:
-        frontend: "Frontend"
-        backend: "Backend"
-        mobile: "Mobile"
-        infrastructure: "Infrastructure"
-
-      # Default project
-      default: "Backend"
-
-      # Auto-detect from file paths
-      auto_detect:
-        enabled: true
-        rules:
-          - path: "src/web/**"
-            project: "Frontend"
-          - path: "src/api/**"
-            project: "Backend"
-          - path: "src/mobile/**"
-            project: "Mobile"
-```
-
----
-
-## GraphQL Queries
-
-Linear uses GraphQL. Custom queries:
-
-```yaml
-integrations:
-  linear:
-    queries:
-      # Find my issues
-      my_issues: |
-        query {
-          viewer {
-            assignedIssues(first: 50) {
-              nodes {
-                id
-                title
-                state { name }
-              }
-            }
-          }
-        }
-
-      # Find team issues
-      team_issues: |
-        query($teamId: String!) {
-          team(id: $teamId) {
-            issues(first: 100, filter: { state: { type: { eq: "started" } } }) {
-              nodes {
-                id
-                title
-                assignee { name }
-              }
-            }
-          }
-        }
-```
-
----
-
-## Bi-Directional Sync
-
-Linear changes can trigger ProAgents actions:
-
-```yaml
-integrations:
-  linear:
-    bidirectional:
-      enabled: true
-
-      # When issue state changes in Linear
-      on_state_change:
-        # Update local feature status
-        update_feature: true
-
-        # State to action mapping
-        actions:
-          "Canceled": "pause_feature"
-          "Done": "mark_complete"
-
-      # When assigned in Linear
-      on_assignment:
-        notify_assignee: true
-```
-
----
-
-## Smart Linking
-
-Auto-link issues by branch name:
-
-```yaml
-integrations:
-  linear:
-    smart_linking:
-      enabled: true
-
-      # Branch naming convention
-      branch_pattern: "^(?:feature|fix)/([A-Z]+-\\d+)"
-
-      # Auto-link on branch creation
-      auto_link: true
-
-      # Update issue when linked
-      on_link:
-        move_to_state: "In Progress"
-        add_label: "in-development"
-```
-
----
-
-## Webhooks
-
-Set up real-time sync:
-
-```yaml
-integrations:
-  linear:
-    webhooks:
-      enabled: true
-      endpoint: "/webhooks/linear"
-
-      events:
-        - "Issue"
-        - "Comment"
-        - "IssueLabel"
-
-      # Webhook secret
-      secret_env: "LINEAR_WEBHOOK_SECRET"
-```
-
----
-
-## Commands
-
-```bash
-# Link to existing issue
-proagents pm link TEAM-123
-
-# Create new issue
-proagents pm create --title "Feature name"
-
-# Sync current feature
-proagents pm sync
-
-# List team issues
-proagents pm list --state "In Progress"
-
-# Search issues
-proagents pm search "authentication"
-```
-
----
-
-## Example Workflow
-
-```
-1. Start feature linked to Linear issue
-   proagents feature start --link TEAM-456 "Implement OAuth"
-
-2. Linear issue TEAM-456 moves to "In Progress"
-
-3. Work through phases
-   - Each phase change updates Linear comment
-
-4. PR created
-   - Linear auto-links PR (branch contains TEAM-456)
-
-5. Feature completed
-   - TEAM-456 moves to "Done"
-   - Summary comment added
-```
-
----
-
-## Troubleshooting
-
-### Connection Issues
-
-```bash
-# Test API connection
-proagents pm test linear
-
-# Check team access
-proagents pm teams linear
-```
-
-### Common Errors
-
-| Error | Solution |
-|-------|----------|
-| Invalid API key | Regenerate API key |
-| Team not found | Check team ID/key |
-| State not found | Verify state names match |
-| Rate limited | Reduce sync frequency |
-
-### Debug Mode
-
-```bash
-proagents pm sync --debug
-```

package/.proagents/pm-integration/notion.md

@@ -1,275 +0,0 @@
-# Notion Integration
-
-Database and documentation integration with Notion.
-
----
-
-## Setup
-
-### 1. Create Integration
-
-1. Go to [Notion Integrations](https://www.notion.so/my-integrations)
-2. Create new integration
-3. Copy the Internal Integration Token
-4. Share your database with the integration
-
-### 2. Configure Connection
-
-```yaml
-# proagents.config.yaml
-
-integrations:
-  notion:
-    enabled: true
-    token_env: "NOTION_TOKEN"
-
-    # Database settings
-    databases:
-      features: "database-id-for-features"
-      documentation: "database-id-for-docs"
-      changelog: "database-id-for-changelog"
-```
-
-### 3. Set Environment Variable
-
-```bash
-export NOTION_TOKEN="secret_xxx..."
-```
-
-### 4. Verify Connection
-
-```bash
-proagents pm connect notion
-proagents pm status
-```
-
----
-
-## Database Schema
-
-### Features Database
-
-```yaml
-integrations:
-  notion:
-    databases:
-      features:
-        id: "your-database-id"
-
-        # Property mapping
-        properties:
-          title: "Name"              # Title property
-          status: "Status"           # Select property
-          phase: "Phase"             # Select property
-          assignee: "Assignee"       # Person property
-          branch: "Branch"           # Text property
-          pr_link: "PR"              # URL property
-          start_date: "Start Date"   # Date property
-          due_date: "Due Date"       # Date property
-          tags: "Tags"               # Multi-select property
-
-        # Status options
-        status_mapping:
-          init: "Not Started"
-          analysis: "In Progress"
-          implementation: "In Progress"
-          testing: "Testing"
-          review: "Review"
-          deployed: "Done"
-```
-
-### Documentation Database
-
-```yaml
-integrations:
-  notion:
-    databases:
-      documentation:
-        id: "docs-database-id"
-
-        properties:
-          title: "Title"
-          type: "Type"           # Feature Doc, API Doc, etc.
-          feature: "Feature"     # Relation to features
-          status: "Status"
-          last_updated: "Last Updated"
-```
-
----
-
-## Auto-Sync Features
-
-### On Feature Start
-
-```yaml
-integrations:
-  notion:
-    on_feature_start:
-      # Create page in features database
-      create_page:
-        database: "features"
-        properties:
-          Name: "{{feature_name}}"
-          Status: "In Progress"
-          Phase: "Analysis"
-          Assignee: "{{user}}"
-          "Start Date": "{{today}}"
-          Tags: ["proagents", "{{entry_mode}}"]
-
-      # Create documentation page
-      create_doc:
-        database: "documentation"
-        template: "feature-doc-template"
-```
-
-### On Phase Change
-
-```yaml
-integrations:
-  notion:
-    on_phase_change:
-      update_page:
-        properties:
-          Phase: "{{current_phase}}"
-
-      # Add to page content
-      append_block:
-        type: "callout"
-        content: |
-          **Phase Update**: {{previous_phase}} → {{current_phase}}
-          {{phase_summary}}
-```
-
-### On Feature Complete
-
-```yaml
-integrations:
-  notion:
-    on_feature_complete:
-      update_page:
-        properties:
-          Status: "Done"
-          Phase: "Deployed"
-
-      # Update documentation
-      update_doc:
-        add_section: "Implementation Details"
-        content: "{{implementation_summary}}"
-
-      # Add to changelog
-      add_changelog:
-        database: "changelog"
-        properties:
-          Title: "{{feature_name}} Released"
-          Date: "{{today}}"
-          Type: "Feature"
-```
-
----
-
-## Documentation Sync
-
-### Sync Project Docs to Notion
-
-```yaml
-integrations:
-  notion:
-    documentation_sync:
-      enabled: true
-
-      # Sync these docs to Notion
-      sync_paths:
-        - source: "docs/architecture.md"
-          notion_page: "Architecture"
-
-        - source: "docs/api/*.md"
-          notion_database: "documentation"
-          type: "API Doc"
-
-      # Sync frequency
-      frequency: "on_change"  # or "daily", "manual"
-```
-
-### Sync Notion to Local
-
-```yaml
-integrations:
-  notion:
-    documentation_sync:
-      # Pull from Notion
-      pull:
-        enabled: true
-        pages:
-          - notion_page: "Design Guidelines"
-            local_path: "docs/design-guidelines.md"
-```
-
----
-
-## Queries and Filters
-
-### Query Features
-
-```bash
-# List features by status
-proagents pm list --status "In Progress"
-
-# Query with filter
-proagents pm query --filter "Phase equals Testing"
-```
-
-### Filter Configuration
-
-```yaml
-integrations:
-  notion:
-    queries:
-      my_features:
-        database: "features"
-        filter:
-          property: "Assignee"
-          people:
-            contains: "{{user_id}}"
-
-      active_features:
-        database: "features"
-        filter:
-          and:
-            - property: "Status"
-              select:
-                does_not_equal: "Done"
-            - property: "Tags"
-              multi_select:
-                contains: "proagents"
-```
-
----
-
-## Commands
-
-```bash
-# Link to existing page
-proagents pm link --page "page-id"
-
-# Create feature page
-proagents pm create --title "Feature name"
-
-# Update status
-proagents pm update --status "In Review"
-
-# Sync documentation
-proagents pm sync-docs
-
-# Query features
-proagents pm query --filter "Status = In Progress"
-```
-
----
-
-## Best Practices
-
-1. **Use Templates**: Create Notion templates for consistency
-2. **Relations**: Link features to documentation pages
-3. **Views**: Create filtered views for different needs
-4. **Automation**: Use Notion automations alongside ProAgents
-5. **Backup**: Notion changes are tracked, but keep local backups