# Navigate to scripts directory
cd scripts/category-name

# View help
Get-Help .\script-name.ps1 -Full

# Execute script
.\script-name.ps1 -Parameter Value

# Create PR automatically
.\pr-management\automate-pr-unified.ps1 `
  -Title "feat: add dark mode" `
  -Body "Implements dark mode toggle"

# Analyze PR quality
.\pr-management\pr-quality-checker.ps1 -PRNumber 123

# Monitor PR status
.\pr-management\pr-monitor.ps1

# Setup agent worktree
.\agent-management\setup-agent-development.ps1 -AgentName "agent-1"

# Start multi-agent workflow
.\agent-management\start-multi-agent-e2e-unified.ps1 `
  -NumAgents 2 `
  -Tasks "Implement feature A", "Implement feature B"

# Update agent status
.\agent-management\update-agent-status.ps1 -AgentName "agent-1" -Status "in-progress"

# Update docs for PR
.\core-utilities\docs-updater.ps1 `
  -PRNumber 123 `
  -UpdateChangelog `
  -GenerateDocs

# Generate full changelog
.\documentation\generate-full-changelog.ps1

# Update project fields
.\project-management\manage-projects.ps1 `
  -Action update `
  -IssueNumber 123 `
  -Status "In Progress"

# Create release
.\project-management\create-release.ps1 -Version "1.2.0"

scripts/
├── agent-management/         # Multi-agent development
│   ├── setup-agent-development.ps1
│   ├── manage-multi-agent-system.ps1
│   └── start-multi-agent-e2e-unified.ps1
│
├── pr-management/           # PR automation
│   ├── automate-pr-unified.ps1
│   ├── pr-quality-checker.ps1
│   └── pr-analyzer.ps1
│
├── issue-management/        # Issue automation
│   ├── management/
│   ├── analysis/
│   └── implementation/
│
├── core-utilities/          # Essential tools
│   ├── get-github-utilities.ps1
│   ├── docs-updater.ps1
│   └── manage-ai-services.ps1
│
├── project-management/      # Project operations
│   ├── manage-projects.ps1
│   ├── create-release.ps1
│   └── backfill-project-fields.ps1
│
├── monitoring/              # System monitoring
│   ├── real-time-dashboard.ps1
│   ├── performance-analyzer.ps1
│   └── automation-metrics.ps1
│
├── housekeeping/           # Maintenance
│   ├── clean-house-main.ps1
│   └── clean-folder-intelligent.ps1
│
└── branch-management/       # Git operations
    ├── create-branch-from-develop.ps1
    └── manage-branches.ps1

# GitHub token (required for API access)
$env:GITHUB_TOKEN = "ghp_..."

# OpenAI API key (for AI-powered features)
$env:OPENAI_API_KEY = "sk-..."

# Repository information
$env:GITHUB_REPOSITORY = "jschibelli/portfolio-os"

gh auth status

# If not authenticated
gh auth login

# Scripts check prerequisites
if (-not (Get-Command gh -ErrorAction SilentlyContinue)) {
    Write-Error "GitHub CLI not installed"
    exit 1
}

# Dry run mode available
.\script-name.ps1 -DryRun

# Automatically retries on failure
$prInfo = Get-PRInfo -PRNumber "123" -MaxRetries 3

# Repository info is cached
$repo = Get-RepoInfo # Cached after first call

# Logs saved to logs/
.\script-name.ps1 # Creates logs/script-name-YYYY-MM-DD.log

# Check execution policy
Get-ExecutionPolicy

# If restricted, allow scripts
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

# Check rate limit
gh api rate_limit

# Use personal access token with higher limits
$env:GITHUB_TOKEN = "your-token"

# Install required modules
Install-Module -Name SomeModule -Scope CurrentUser