@pjmendonca/devflow 1.9.0

package/tooling/.automation/overrides/templates/writer/docs-as-code.yaml

@@ -0,0 +1,108 @@
+# Docs-as-Code Persona
+# Focus: Automated docs, living documentation, CI/CD integration
+# Best for: Engineering teams, open source projects, developer tools
+
+persona:
+  name: "Docs-as-Code Practitioner"
+  description: "Engineer-writer hybrid focused on automated, maintainable documentation"
+
+personality:
+  traits:
+    - automation_first
+    - developer_tooling_savvy
+    - consistency_obsessed
+    - maintainability_focused
+    - contribution_friendly
+  
+  communication_style:
+    tone: technical_collegial
+    detail_level: engineer_appropriate
+    audience: developers_contributors
+    tooling: markdown_native
+    preferred_formats:
+      - markdown
+      - diagrams_as_code
+      - automated_references
+
+behavior:
+  documentation_approach:
+    philosophy: "Docs live with code"
+    infrastructure:
+      - docs_in_repo
+      - ci_cd_publishing
+      - automated_testing
+      - version_control
+    
+  content_creation:
+    automation:
+      - api_docs_from_code
+      - diagrams_from_definitions
+      - changelog_generation
+      - link_checking
+    standards:
+      - linting_rules
+      - style_guides
+      - templates
+    
+  focus_areas:
+    - automation
+    - maintainability
+    - contribution_ease
+    - single_source_of_truth
+    - freshness
+
+tooling:
+  authoring:
+    - markdown
+    - mdx
+    - asciidoc
+  static_sites:
+    - docusaurus
+    - mkdocs
+    - hugo
+  diagrams:
+    - mermaid
+    - plantuml
+    - d2
+  automation:
+    - github_actions
+    - pre_commit_hooks
+    - vale_linting
+
+deliverables:
+  infrastructure:
+    - documentation_site
+    - contributing_guide
+    - style_guide
+    - templates
+    
+  automation:
+    - ci_cd_pipeline
+    - link_checker
+    - freshness_checker
+    - api_doc_generator
+
+quality_standards:
+  automation:
+    - all_docs_linted
+    - links_validated
+    - builds_tested
+    - previews_generated
+  contribution:
+    - clear_guidelines
+    - easy_local_setup
+    - templates_provided
+    - review_process_defined
+
+constraints:
+  always:
+    - automate_what_can_be_automated
+    - keep_docs_with_code
+    - enable_contributions
+    - version_documentation
+    - test_documentation
+  never:
+    - create_documentation_silos
+    - skip_automation_opportunities
+    - make_contribution_hard
+    - let_docs_rot

package/tooling/.automation/overrides/templates/writer/user-guide-author.yaml

@@ -0,0 +1,100 @@
+# User Guide Author Persona
+# Focus: End-user documentation, tutorials, help content
+# Best for: Consumer products, SaaS applications, user-facing software
+
+persona:
+  name: "User Guide Author"
+  description: "User-focused writer creating accessible, helpful documentation"
+
+personality:
+  traits:
+    - user_empathetic
+    - clarity_focused
+    - task_oriented
+    - accessibility_conscious
+    - patience_embodied
+  
+  communication_style:
+    tone: friendly_professional
+    detail_level: step_by_step
+    audience: end_users
+    jargon: minimal_explained
+    preferred_formats:
+      - task_based_guides
+      - tutorials
+      - faq
+
+behavior:
+  documentation_approach:
+    philosophy: "Help users succeed"
+    structure:
+      - getting_started
+      - common_tasks
+      - feature_guides
+      - troubleshooting
+      - faq
+    
+  content_creation:
+    every_guide:
+      - clear_objective
+      - prerequisites
+      - numbered_steps
+      - screenshots
+      - expected_outcome
+      - troubleshooting_tips
+    language:
+      - second_person_you
+      - active_voice
+      - simple_sentences
+    
+  focus_areas:
+    - user_success
+    - task_completion
+    - visual_aids
+    - accessibility
+    - searchability
+
+deliverables:
+  onboarding:
+    - welcome_guide
+    - quick_start
+    - first_steps_tutorial
+    
+  reference:
+    - feature_documentation
+    - settings_reference
+    - keyboard_shortcuts
+    
+  support:
+    - troubleshooting_guide
+    - faq
+    - known_issues
+    - contact_support
+
+quality_standards:
+  readability:
+    - flesch_kincaid_grade_8
+    - short_paragraphs
+    - bullet_points
+    - clear_headings
+  visuals:
+    - annotated_screenshots
+    - consistent_styling
+    - alt_text_included
+  accessibility:
+    - screen_reader_friendly
+    - color_contrast_compliant
+    - keyboard_navigable
+
+constraints:
+  always:
+    - write_for_the_user
+    - include_visuals
+    - test_procedures
+    - provide_context
+    - anticipate_questions
+  never:
+    - assume_technical_knowledge
+    - use_unexplained_jargon
+    - skip_steps
+    - forget_accessibility

package/tooling/completions/DevflowCompletion.ps1

@@ -0,0 +1,213 @@
+# Devflow PowerShell Tab Completion
+#
+# Installation:
+# 1. Add to your PowerShell profile ($PROFILE):
+#    . /path/to/devflow/tooling/completions/DevflowCompletion.ps1
+#
+# 2. Or import as module:
+#    Import-Module /path/to/devflow/tooling/completions/DevflowCompletion.ps1
+
+# Agent personas
+$script:DevflowAgents = @(
+    [PSCustomObject]@{ Name = 'SM'; Description = 'Scrum Master - Sprint coordination' }
+    [PSCustomObject]@{ Name = 'DEV'; Description = 'Developer - Code implementation' }
+    [PSCustomObject]@{ Name = 'BA'; Description = 'Business Analyst - Requirements' }
+    [PSCustomObject]@{ Name = 'ARCHITECT'; Description = 'Architect - System design' }
+    [PSCustomObject]@{ Name = 'PM'; Description = 'Product Manager - Roadmap' }
+    [PSCustomObject]@{ Name = 'WRITER'; Description = 'Technical Writer - Documentation' }
+    [PSCustomObject]@{ Name = 'MAINTAINER'; Description = 'Maintainer - Code quality' }
+    [PSCustomObject]@{ Name = 'REVIEWER'; Description = 'Code Reviewer - Quality assurance' }
+)
+
+$script:DevflowModels = @('opus', 'sonnet', 'haiku')
+$script:DevflowModes = @('swarm', 'pair', 'auto', 'sequential')
+
+# Argument completer for run-story.ps1
+Register-ArgumentCompleter -CommandName 'run-story.ps1', 'run-story' -Native -ScriptBlock {
+    param($wordToComplete, $commandAst, $cursorPosition)
+    
+    $params = @(
+        @{ Name = '-Swarm'; Tooltip = 'Enable swarm mode (multi-agent debate)' }
+        @{ Name = '-Pair'; Tooltip = 'Enable pair programming mode' }
+        @{ Name = '-Auto'; Tooltip = 'Enable auto-routing mode' }
+        @{ Name = '-Sequential'; Tooltip = 'Enable sequential mode' }
+        @{ Name = '-Agents'; Tooltip = 'Comma-separated agent list' }
+        @{ Name = '-MaxIterations'; Tooltip = 'Max iterations (default: 3)' }
+        @{ Name = '-Model'; Tooltip = 'Claude model (opus, sonnet, haiku)' }
+        @{ Name = '-Budget'; Tooltip = 'Budget limit in USD' }
+        @{ Name = '-Memory'; Tooltip = 'Show shared memory' }
+        @{ Name = '-Query'; Tooltip = 'Query knowledge graph' }
+        @{ Name = '-RouteOnly'; Tooltip = 'Only show routing decision' }
+        @{ Name = '-Quiet'; Tooltip = 'Reduce output verbosity' }
+        @{ Name = '-Help'; Tooltip = 'Show help' }
+    )
+    
+    # Get the current word being typed
+    $commandElements = $commandAst.CommandElements
+    $lastWord = if ($commandElements.Count -gt 1) { 
+        $commandElements[-1].Extent.Text 
+    } else { '' }
+    
+    # Check if completing a parameter value
+    $previousWord = if ($commandElements.Count -gt 2) {
+        $commandElements[-2].Extent.Text
+    } else { '' }
+    
+    # Model completion
+    if ($previousWord -eq '-Model') {
+        $script:DevflowModels | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+            [System.Management.Automation.CompletionResult]::new(
+                $_,
+                $_,
+                'ParameterValue',
+                "Claude model: $_"
+            )
+        }
+        return
+    }
+    
+    # Agent completion
+    if ($previousWord -eq '-Agents') {
+        # Support comma-separated completion
+        $existingAgents = if ($wordToComplete -match ',') {
+            $wordToComplete -replace ',[^,]*$', ','
+        } else { '' }
+        
+        $currentPart = if ($wordToComplete -match ',') {
+            ($wordToComplete -split ',')[-1]
+        } else { $wordToComplete }
+        
+        $script:DevflowAgents | Where-Object { $_.Name -like "$currentPart*" } | ForEach-Object {
+            [System.Management.Automation.CompletionResult]::new(
+                "$existingAgents$($_.Name)",
+                $_.Name,
+                'ParameterValue',
+                $_.Description
+            )
+        }
+        return
+    }
+    
+    # Parameter completion
+    $params | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object {
+        [System.Management.Automation.CompletionResult]::new(
+            $_.Name,
+            $_.Name,
+            'ParameterName',
+            $_.Tooltip
+        )
+    }
+}
+
+# Argument completer for run-collab.ps1
+Register-ArgumentCompleter -CommandName 'run-collab.ps1', 'run-collab' -Native -ScriptBlock {
+    param($wordToComplete, $commandAst, $cursorPosition)
+    
+    $params = @(
+        @{ Name = '-Swarm'; Tooltip = 'Enable swarm mode' }
+        @{ Name = '-Pair'; Tooltip = 'Enable pair programming' }
+        @{ Name = '-Auto'; Tooltip = 'Enable auto-routing' }
+        @{ Name = '-Sequential'; Tooltip = 'Sequential pipeline' }
+        @{ Name = '-Agents'; Tooltip = 'Comma-separated agents' }
+        @{ Name = '-MaxIterations'; Tooltip = 'Max iterations' }
+        @{ Name = '-Model'; Tooltip = 'Claude model' }
+        @{ Name = '-Budget'; Tooltip = 'Budget limit USD' }
+        @{ Name = '-Memory'; Tooltip = 'Show shared memory' }
+        @{ Name = '-Query'; Tooltip = 'Query knowledge graph' }
+        @{ Name = '-RouteOnly'; Tooltip = 'Routing only' }
+        @{ Name = '-Quiet'; Tooltip = 'Quiet mode' }
+        @{ Name = '-StoryKey'; Tooltip = 'Story key or description' }
+    )
+    
+    $commandElements = $commandAst.CommandElements
+    $previousWord = if ($commandElements.Count -gt 2) {
+        $commandElements[-2].Extent.Text
+    } else { '' }
+    
+    # Model completion
+    if ($previousWord -eq '-Model') {
+        $script:DevflowModels | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+            [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+        }
+        return
+    }
+    
+    # Agent completion
+    if ($previousWord -eq '-Agents') {
+        $existingAgents = if ($wordToComplete -match ',') {
+            $wordToComplete -replace ',[^,]*$', ','
+        } else { '' }
+        
+        $currentPart = if ($wordToComplete -match ',') {
+            ($wordToComplete -split ',')[-1]
+        } else { $wordToComplete }
+        
+        $script:DevflowAgents | Where-Object { $_.Name -like "$currentPart*" } | ForEach-Object {
+            [System.Management.Automation.CompletionResult]::new(
+                "$existingAgents$($_.Name)",
+                $_.Name,
+                'ParameterValue',
+                $_.Description
+            )
+        }
+        return
+    }
+    
+    # Parameter completion
+    $params | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object {
+        [System.Management.Automation.CompletionResult]::new(
+            $_.Name,
+            $_.Name,
+            'ParameterName',
+            $_.Tooltip
+        )
+    }
+}
+
+# Helper function to show available commands
+function Get-DevflowCommands {
+    @"
+    
+Devflow Collaboration Commands
+==============================
+
+run-story.ps1 / run-story.sh
+  Main story runner with collaboration modes
+  
+  Modes:
+    -Swarm        Multi-agent debate/consensus
+    -Pair         DEV + REVIEWER pair programming  
+    -Auto         Intelligent auto-routing (default)
+    -Sequential   Traditional sequential pipeline
+
+run-collab.ps1 / run-collab.py
+  Direct Python collaboration CLI
+  
+  Same modes as run-story with additional:
+    -Memory       View shared memory
+    -Query        Query knowledge graph
+    -RouteOnly    Preview routing without execution
+
+Available Agents:
+  SM          Scrum Master
+  DEV         Developer
+  BA          Business Analyst
+  ARCHITECT   Architect
+  PM          Product Manager
+  WRITER      Technical Writer
+  MAINTAINER  Maintainer
+  REVIEWER    Code Reviewer
+
+Examples:
+  run-story.ps1 -StoryKey "PROJ-123" -Swarm
+  run-story.ps1 -StoryKey "PROJ-123" -Pair
+  run-story.ps1 -StoryKey "PROJ-123" -Agents SM,DEV,ARCHITECT
+  run-collab.ps1 -StoryKey "fix auth bug" -Auto -RouteOnly
+
+"@
+}
+
+# Export alias
+Set-Alias -Name devflow-help -Value Get-DevflowCommands
+
+Write-Host "Devflow tab completion loaded. Use 'devflow-help' for command reference." -ForegroundColor Cyan

package/tooling/completions/_run-story

@@ -0,0 +1,116 @@
+#compdef run-story.sh run-story run-collab.sh run-collab
+
+# Devflow Story Runner Zsh Completion
+# 
+# Installation:
+# 1. Copy this file to a directory in your $fpath (e.g., ~/.zsh/completions/)
+# 2. Add to ~/.zshrc: fpath=(~/.zsh/completions $fpath)
+# 3. Reload: source ~/.zshrc
+# 
+# Or for quick setup, add to ~/.zshrc:
+#   source /path/to/devflow/tooling/completions/_run-story
+
+# Agent personas
+local -a agents
+agents=(
+    'SM:Scrum Master - Sprint coordination and Agile practices'
+    'DEV:Developer - Code implementation and technical solutions'
+    'BA:Business Analyst - Requirements analysis and stakeholder alignment'
+    'ARCHITECT:Architect - System design and technical decisions'
+    'PM:Product Manager - Roadmap and feature prioritization'
+    'WRITER:Technical Writer - Documentation and user guides'
+    'MAINTAINER:Maintainer - Code quality and long-term health'
+    'REVIEWER:Code Reviewer - Quality assurance and best practices'
+)
+
+# Collaboration modes
+local -a modes
+modes=(
+    'swarm:Multi-agent debate with consensus building'
+    'pair:DEV + REVIEWER pair programming'
+    'auto:Intelligent auto-routing to best agents'
+    'sequential:Traditional sequential pipeline'
+)
+
+# Model options
+local -a models
+models=(
+    'opus:Claude Opus - Most capable, highest quality'
+    'sonnet:Claude Sonnet - Balanced performance'
+    'haiku:Claude Haiku - Fast and efficient'
+)
+
+# Common options
+local -a common_opts
+common_opts=(
+    '--help[Show help message]'
+    '--quiet[Reduce output verbosity]'
+    '--debug[Enable debug mode]'
+    '--dry-run[Show what would be done without executing]'
+)
+
+# Collaboration options
+local -a collab_opts
+collab_opts=(
+    '--swarm[Enable swarm mode - multi-agent debate]'
+    '--pair[Enable pair programming mode]'
+    '--auto-route[Enable auto-routing mode]'
+    '--sequential[Enable sequential mode]'
+    '--agents[Comma-separated list of agents]:agent list:_values -s , agents SM DEV BA ARCHITECT PM WRITER MAINTAINER REVIEWER'
+    '--max-iterations[Maximum iterations]:iterations:(1 2 3 4 5)'
+    '--model[Claude model to use]:model:(opus sonnet haiku)'
+    '--budget[Budget limit in USD]:budget:'
+    '--memory[Show shared memory and knowledge graph]'
+    '--query[Query the knowledge graph]:query:'
+    '--route-only[Only show routing decision]'
+)
+
+# run-story.sh specific completions
+_run-story() {
+    local curcontext="$curcontext" state line
+    typeset -A opt_args
+
+    _arguments -C \
+        '1:story key or description:->story' \
+        '*::option:->option' \
+        $common_opts \
+        $collab_opts
+
+    case $state in
+        story)
+            # Could provide completions from JIRA/etc if configured
+            _message 'story key (e.g., PROJ-123) or task description'
+            ;;
+        option)
+            _arguments $common_opts $collab_opts
+            ;;
+    esac
+}
+
+# run-collab.py specific completions
+_run-collab() {
+    _arguments \
+        '1:story key or description:' \
+        '--swarm[Enable swarm mode]' \
+        '--pair[Enable pair programming mode]' \
+        '--auto[Enable auto-routing mode]' \
+        '--sequential[Enable sequential mode]' \
+        '--agents[Agent list]:agents:_values -s , agents SM DEV BA ARCHITECT PM WRITER MAINTAINER REVIEWER' \
+        '--max-iterations[Max iterations]:iterations:(1 2 3 4 5 10)' \
+        '--model[Claude model]:model:(opus sonnet haiku)' \
+        '--budget[Budget limit]:budget:' \
+        '--memory[Show shared memory]' \
+        '--query[Query knowledge graph]:query:' \
+        '--route-only[Only show routing]' \
+        '--quiet[Reduce verbosity]' \
+        '--help[Show help]'
+}
+
+# Alias completions  
+compdef _run-story run-story.sh
+compdef _run-story run-story
+compdef _run-collab run-collab.py
+compdef _run-collab run-collab
+
+# Export for direct sourcing
+_run-story "$@"

package/tooling/completions/run-story-completion.bash

@@ -0,0 +1,136 @@
+#!/bin/bash
+# Devflow Bash Tab Completion
+#
+# Installation:
+# 1. Source in ~/.bashrc:
+#    source /path/to/devflow/tooling/completions/run-story-completion.bash
+#
+# 2. Or copy to system completions:
+#    cp run-story-completion.bash /etc/bash_completion.d/devflow
+
+# Available agents
+_devflow_agents="SM DEV BA ARCHITECT PM WRITER MAINTAINER REVIEWER"
+
+# Available models
+_devflow_models="opus sonnet haiku"
+
+# Collaboration modes
+_devflow_modes="swarm pair auto-route sequential"
+
+# run-story.sh completion
+_run_story_completion() {
+    local cur prev opts
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+    
+    # Main options
+    opts="--swarm --pair --auto-route --sequential --agents --max-iterations --model --budget --memory --query --route-only --quiet --debug --dry-run --help"
+    
+    case "${prev}" in
+        --agents|-a)
+            # Support comma-separated agent completion
+            local existing_agents current_part
+            if [[ "$cur" == *,* ]]; then
+                existing_agents="${cur%,*},"
+                current_part="${cur##*,}"
+            else
+                existing_agents=""
+                current_part="$cur"
+            fi
+            
+            local suggestions=""
+            for agent in $_devflow_agents; do
+                if [[ "$agent" == ${current_part}* ]]; then
+                    suggestions="$suggestions ${existing_agents}${agent}"
+                fi
+            done
+            COMPREPLY=( $(compgen -W "$suggestions" -- "") )
+            return 0
+            ;;
+        --model|-m)
+            COMPREPLY=( $(compgen -W "${_devflow_models}" -- "${cur}") )
+            return 0
+            ;;
+        --max-iterations|--max-iter)
+            COMPREPLY=( $(compgen -W "1 2 3 4 5 10" -- "${cur}") )
+            return 0
+            ;;
+        --budget)
+            COMPREPLY=( $(compgen -W "5.0 10.0 20.0 50.0 100.0" -- "${cur}") )
+            return 0
+            ;;
+        --query)
+            # No specific completions for query text
+            return 0
+            ;;
+        *)
+            ;;
+    esac
+    
+    # Complete options
+    if [[ ${cur} == -* ]]; then
+        COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+        return 0
+    fi
+}
+
+# run-collab.py completion
+_run_collab_completion() {
+    local cur prev opts
+    COMPREPLY=()
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD-1]}"
+    
+    opts="--swarm --pair --auto --sequential --agents --max-iterations --model --budget --memory --query --route-only --quiet --help"
+    
+    case "${prev}" in
+        --agents)
+            local existing_agents current_part
+            if [[ "$cur" == *,* ]]; then
+                existing_agents="${cur%,*},"
+                current_part="${cur##*,}"
+            else
+                existing_agents=""
+                current_part="$cur"
+            fi
+            
+            local suggestions=""
+            for agent in $_devflow_agents; do
+                if [[ "$agent" == ${current_part}* ]]; then
+                    suggestions="$suggestions ${existing_agents}${agent}"
+                fi
+            done
+            COMPREPLY=( $(compgen -W "$suggestions" -- "") )
+            return 0
+            ;;
+        --model)
+            COMPREPLY=( $(compgen -W "${_devflow_models}" -- "${cur}") )
+            return 0
+            ;;
+        --max-iterations)
+            COMPREPLY=( $(compgen -W "1 2 3 4 5 10" -- "${cur}") )
+            return 0
+            ;;
+        --budget)
+            COMPREPLY=( $(compgen -W "5.0 10.0 20.0 50.0 100.0" -- "${cur}") )
+            return 0
+            ;;
+        *)
+            ;;
+    esac
+    
+    if [[ ${cur} == -* ]]; then
+        COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+        return 0
+    fi
+}
+
+# Register completions
+complete -F _run_story_completion run-story.sh
+complete -F _run_story_completion run-story
+complete -F _run_collab_completion run-collab.py
+complete -F _run_collab_completion run-collab
+complete -F _run_collab_completion python3 run-collab.py
+
+echo "Devflow bash completion loaded."