Complete Script Reference

Comprehensive guide to all PowerShell automation scripts in Portfolio OS

Overview

Comprehensive guide to all PowerShell automation scripts in Portfolio OS

Comprehensive documentation for all PowerShell automation scripts organized by category.

100+ Automation Scripts:

Portfolio OS includes over 100 PowerShell scripts providing complete automation for PR management, issue tracking, multi-agent coordination, monitoring, and maintenance.

Script Categories

PR Management

Automated pull request workflows, quality checking, and intelligent configuration

Issue Management

Issue tracking, analysis, queue management, and implementation automation

Agent Management

Multi-agent development system with worktree orchestration

Core Utilities

Shared utilities, helpers, and GitHub API integration

Monitoring

Real-time metrics, performance analytics, and system health

Housekeeping

Project maintenance, cleanup, and organization tools

PR Management

Location: scripts/pr-management/

Overview

Comprehensive pull request management system with intelligent assignment, quality checking, and automated configuration.

PR Automation Workflow

Core Scripts

`automate-pr-unified.ps1`

Complete PR Automation:

This is the primary PR automation script that orchestrates AI-powered analysis, quality checks, and automated responses.

Complete PR automation with AI-powered analysis.

# Full PR automation
.\automate-pr-unified.ps1 -PRNumber 150 -Action all

# Analyze only
.\automate-pr-unified.ps1 -PRNumber 150 -Action analyze

# Generate responses
.\automate-pr-unified.ps1 -PRNumber 150 -Action respond

`configure-pr-auto.ps1`

Automated PR configuration and field management.

# Auto-configure PR
.\configure-pr-auto.ps1 -PRNumber 150

# With specific fields
.\configure-pr-auto.ps1 -PRNumber 150 `
  -Priority P1 `
  -Size M `
  -App "Portfolio Site" `
  -Area "Frontend"

Status Management

Todo, In progress, Ready, Done

Priority Levels

P0 (Critical), P1 (High), P2 (Medium), P3 (Low)

Size Estimation

XS, S, M, L, XL

Categorization

App, Area, and Assignee fields

`pr-quality-checker.ps1`

Quality Gates:

This script enforces quality standards before PR approval. Failed checks will prevent merging until resolved.

Automated quality assurance and testing.

# Complete quality check
.\pr-quality-checker.ps1 -PRNumber 150 -Checks all -AutoFix

# Specific checks
.\pr-quality-checker.ps1 -PRNumber 150 -Checks security,performance

# With tests
.\pr-quality-checker.ps1 -PRNumber 150 -Checks all -RunTests

Check Types:

Linting

ESLint and Prettier code quality checks

Formatting

Code style and formatting validation

Security

Dependency scanning and security vulnerabilities

Performance

Bundle size and performance impact analysis

Documentation

Documentation completeness and quality

Tests

Unit, integration, and E2E test execution

`pr-analyzer.ps1`

Comprehensive PR analysis and assessment.

# Full analysis
.\pr-analyzer.ps1 -PRNumber 150 -Analysis comprehensive

# Security analysis
.\pr-analyzer.ps1 -PRNumber 150 -Analysis security

# Performance analysis
.\pr-analyzer.ps1 -PRNumber 150 -Analysis performance

Analysis Types:

comprehensive - Complete analysis
security - Security assessment
performance - Performance impact
complexity - Code complexity
review - Review status
changes - Change impact

`pr-monitor.ps1`

Real-time PR monitoring and status tracking.

# Monitor open PRs
.\pr-monitor.ps1 -Filter open -ShowDetails

# Watch mode
.\pr-monitor.ps1 -WatchMode -Interval 30

# Export report
.\pr-monitor.ps1 -Filter open -ExportTo "pr-report.json"

Quick Reference

Script	Primary Use	Automation Level
`automate-pr-unified.ps1`	Complete automation	High
`configure-pr-auto.ps1`	Field configuration	Medium
`pr-quality-checker.ps1`	Quality assurance	High
`pr-analyzer.ps1`	Analysis & insights	Medium
`pr-monitor.ps1`	Real-time monitoring	High

Issue Management

Location: scripts/issue-management/

Directory Structure

Issue Processing Pipeline

Core Scripts

Analysis Tools

analyze-issues.ps1 - Comprehensive issue analysis

# Analyze specific issue
.\analysis\analyze-issues.ps1 -IssueNumber 250 -GeneratePlan

# Analyze multiple issues
.\analysis\analyze-issues.ps1 -IssueNumbers 250,251,252

analyze-stale-issues.ps1 - Identify stale issues

# Find stale issues
.\analysis\analyze-stale-issues.ps1

# With custom threshold
.\analysis\analyze-stale-issues.ps1 -DaysInactive 30

Configuration Tools

configure-issue-auto.ps1 - Auto-configure issues

# Auto-configure
.\configuration\configure-issue-auto.ps1 -IssueNumber 250

# With specific fields
.\configuration\configure-issue-auto.ps1 -IssueNumber 250 `
  -Priority P1 `
  -Size M `
  -App "Portfolio Site"

configure-issues-unified.ps1 - Unified configuration system

# Use preset
.\configuration\configure-issues-unified.ps1 -IssueNumber 250 -Preset blog

# Enable AI recommendations
.\configuration\configure-issues-unified.ps1 -IssueNumber 250 -EnableAI

Implementation Tools

implement-issues.ps1 - Complete implementation workflow

# Full implementation
.\implementation\implement-issues.ps1 -IssueNumber 250 -Mode auto

# Interactive mode
.\implementation\implement-issues.ps1 -IssueNumber 250 -Interactive

Queue Management

manage-issue-queue.ps1 - Queue management

# List queue
.\management\manage-issue-queue.ps1 -List

# Process queue
.\management\manage-issue-queue.ps1 -Process

# Clear queue
.\management\manage-issue-queue.ps1 -Clear

run-issue-pipeline.ps1 - Continuous pipeline

# Run pipeline
.\management\run-issue-pipeline.ps1 -MaxIssues 5

# Watch mode
.\management\run-issue-pipeline.ps1 -Watch

Agent Management

Location: scripts/agent-management/

Overview

Enterprise Multi-Agent System:

Enterprise-grade multi-agent development framework for orchestrating parallel development workflows with Git worktrees.

Enterprise-grade multi-agent development framework for orchestrating parallel development workflows.

Multi-Agent Architecture

Core Scripts

`manage-multi-agent-system.ps1`

Core system management

# Initialize system
.\manage-multi-agent-system.ps1 -Operation setup

# Create agent worktree
.\manage-multi-agent-system.ps1 -Operation create -Agent "agent-frontend"

# Check status
.\manage-multi-agent-system.ps1 -Operation status

# Cleanup
.\manage-multi-agent-system.ps1 -Operation cleanup -Force

Operations:

setup - Initialize environment
create - Create worktrees
destroy - Remove worktrees
list - Display agents
assign - Assign issues
sync - Synchronize
status - System health
cleanup - Maintenance

`assign-agent-enhanced.ps1`

Intelligent issue assignment

# Auto-assign issue
.\assign-agent-enhanced.ps1 -IssueNumber 250

# Preview assignment
.\assign-agent-enhanced.ps1 -IssueNumber 250 -DryRun

# Force assignment
.\assign-agent-enhanced.ps1 -IssueNumber 250 -Force

`manage-worktree-operations-unified.ps1`

Comprehensive worktree management

# Assign worktree
.\manage-worktree-operations-unified.ps1 -Operation assign -IssueNumber 250

# Switch worktree
.\manage-worktree-operations-unified.ps1 -Operation switch -Agent "agent-frontend"

# Sync worktrees
.\manage-worktree-operations-unified.ps1 -Operation sync

`start-multi-agent-e2e-unified.ps1`

End-to-end development workflow

# Continuous mode
.\start-multi-agent-e2e-unified.ps1 -Mode continuous

# Individual agent
.\start-multi-agent-e2e-unified.ps1 -Mode individual -Agent "agent-frontend"

# Monitor mode
.\start-multi-agent-e2e-unified.ps1 -Mode monitor

Agent Configuration

Agent Assignment Config:

Configure agent capabilities, skills, and workload limits in scripts/configuration/agent-assignment-config.json

scripts/configuration/agent-assignment-config.json

{
  "humanAgents": {
    "agent-frontend": {
      "assignedAreas": ["Frontend", "UI/UX", "Components"],
      "skills": ["React", "TypeScript", "Tailwind"],
      "maxConcurrentIssues": 4,
      "priority": "high"
    }
  }
}

Core Utilities

Location: scripts/core-utilities/

Scripts

get-github-utilities.ps1 - GitHub API helpers

# Get issue details
.\get-github-utilities.ps1 -Operation getIssue -IssueNumber 250

# List PRs
.\get-github-utilities.ps1 -Operation listPRs -State open

set-estimate-iteration.ps1 - Set estimates and iterations

# Set estimate
.\set-estimate-iteration.ps1 -IssueNumber 250 -Estimate 3

# Set iteration
.\set-estimate-iteration.ps1 -IssueNumber 250 -Iteration "@current"

docs-updater.ps1 - Update documentation

# Update docs
.\docs-updater.ps1 -Category "agent-management"

# Force update
.\docs-updater.ps1 -Category "all" -Force

Monitoring

Location: scripts/monitoring/

Monitoring Architecture

Scripts

`automation-metrics.ps1`

Comprehensive Analytics:

Track PR velocity, issue throughput, agent performance, and system health with detailed metrics and historical trends.

Comprehensive analytics system for all automation operations.

# System overview
.\automation-metrics.ps1 -Operation overview

# Performance metrics
.\automation-metrics.ps1 -Operation performance -TimeRange 7

# Agent activity
.\automation-metrics.ps1 -Operation agents

`real-time-dashboard.ps1`

Live monitoring dashboard

# Start dashboard
.\real-time-dashboard.ps1

# Custom refresh
.\real-time-dashboard.ps1 -RefreshInterval 10

# With alerts
.\real-time-dashboard.ps1 -ShowAlerts -ShowPerformance

`performance-analyzer.ps1`

Performance analysis tools

# System analysis
.\performance-analyzer.ps1 -Analysis system

# Comprehensive report
.\performance-analyzer.ps1 -Analysis comprehensive

Analysis Types:

system - System resources
scripts - Script performance
api - API response times
git - Git operations
comprehensive - Full analysis

Housekeeping

Location: scripts/housekeeping/

Automated Maintenance:

Keep your repository clean and organized with automated housekeeping scripts for file organization, cleanup, and validation.

Scripts

`clean-house-main.ps1`

Comprehensive housekeeping and maintenance.

Full Mode

Complete housekeeping with all operations

Organization

File and directory organization

Cleanup

Temporary file and cache cleanup

Validation

Project structure validation

Documentation

Documentation organization and updates

`clean-house-quick.ps1`

Quick access to common tasks

# Quick clean
.\clean-house-quick.ps1 -Action clean

# Organize files
.\clean-house-quick.ps1 -Action organize

# Validate structure
.\clean-house-quick.ps1 -Action validate

`clean-house-advanced.ps1`

Advanced Features:

This script includes security scanning, performance analysis, and deep cleaning operations. Always run with -DryRun first.

Advanced cleaning with security & performance analysis.

# Full advanced cleanup
.\clean-house-advanced.ps1 -Mode full -DryRun

# Security scan
.\clean-house-advanced.ps1 -Mode security

# Performance analysis
.\clean-house-advanced.ps1 -Mode performance

Security Scanning

Scan dependencies for vulnerabilities and outdated packages

Performance Analysis

Analyze bundle sizes, build times, and optimization opportunities

Dependency Management

Check for unused dependencies and version conflicts

Git History Analysis

Identify large files and optimize repository size

Deep Cleaning

Remove redundant files, caches, and temporary data

Script Execution Best Practices

Best Practices:

Follow these guidelines for safe and effective script execution in production environments.

Execution Guidelines

Always Use -DryRun First

Test scripts with -DryRun or -WhatIf to preview changes before execution

Check Prerequisites

Verify required environment variables and GitHub tokens are configured

Monitor Execution

Watch script output for errors, warnings, and completion status

Review Logs

Check generated logs in logs/ directory for detailed execution history

Handle Errors Gracefully

Scripts include error handling and rollback mechanisms

Common Parameters

All major scripts support these common parameters:

-DryRun

Preview changes without executing

-Verbose

Enable detailed logging output

-Force

Skip confirmation prompts

-WhatIf

Show what would happen

Additional Resources

Internal Documentation

CI/CD Workflows - GitHub Actions integration
Multi-Agent Architecture - System design
Configuration Reference - Environment variables
Troubleshooting - Common issues
Testing Guide - Test automation

Need Help?:

Check the Troubleshooting Guide for common issues and solutions, or explore the Configuration Reference for setup details.

Script Reference

PR Management Scripts