powershell-module-architect — Claude Code subagent

Q: How do I install powershell-module-architect in Claude Code?

Add the marketplace with `/plugin marketplace add VoltAgent/awesome-claude-code-subagents`, then install the package with `/plugin install voltagent-dev-exp@voltagent-subagents`. The subagent file is `.claude/agents/powershell-module-architect.md`.

What powershell-module-architect does

This subagent turns fragmented PowerShell scripts into reusable modules. It can separate public and private functions, structure a module manifest, extract shared helper logic, and organize dot-sourcing. For function design, it uses CmdletBinding, strict parameter types, validation, consistent error handling, and -WhatIf/-Confirm support.

For profiles, it checks for heavy startup work, suggests lazy imports, and groups profile fragments into core, dev, and infra areas. It also accounts for differences between PowerShell 5.1 and 7+, with backward-compatible patterns and migration guidance. Its configured tools are Read, Write, Edit, Bash, Glob, and Grep; the model is sonnet.

Install it when a PowerShell codebase needs a shared structure or a library must support multiple versions. A small one-off profile edit does not need this subagent.

What it helps with

refactor AD scripts into a reusable module
separate public and private PowerShell functions
reduce profile startup work with lazy imports
design an automation library for PowerShell 5.1 and 7+
standardize function errors and parameter validation

Example prompts for the agent

“Refactor a set of AD scripts into a reusable module”
“Create a standardized profile for helpdesk teams”
“Design a cross-platform automation toolkit”

How to install powershell-module-architect

1Plugin marketplace

/plugin marketplace add VoltAgent/awesome-claude-code-subagents

/plugin install voltagent-dev-exp@voltagent-subagents

2Manually: put the files in place

.claude/agents/powershell-module-architect.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Manually: put the files in place

.codex/agents/powershell-module-architect.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Manually: put the files in place

.cursor/agents/powershell-module-architect.md

Cursor also reads .claude/agents/

From the same set129

The whole set →

frontend-developer VoltAgent Community Subagent for building complete frontend applications with React 18+, Vue 3+, and Angular 15+. Handles component architecture, state management, testing, and accessibility. Claude Code 40,905installs code-reviewer VoltAgent Community Reviews code changes for bugs, security flaws and maintenance issues. Use it before merging complex work or auditing a project. Claude Code 31,050installs fullstack-developer VoltAgent Community This subagent carries a feature across the database, API, and frontend layers. Use it when one change needs a consistent end-to-end implementation. Claude Code 18,117installs prompt-engineer VoltAgent Community This subagent designs, tests, and improves prompts for LLM production systems. Use it when prompts need evaluation, metrics, or cost tracking. Claude Code 16,078installs debugger VoltAgent Community Diagnoses software failures, reads stack traces, and isolates root causes to fix elusive bugs. Helpful when logs alone do not explain a crash. Claude Code 13,459installs python-pro VoltAgent Community A subagent for type-safe Python code across web APIs, system utilities, and complex applications. Use it when async patterns and broad type coverage matter. Claude Code 11,689installs security-auditor VoltAgent Community Audits security controls, vulnerabilities, risks, and compliance gaps across systems, infrastructure, and processes. Use it when you need documented findings. Claude Code 10,718installs context-manager VoltAgent Community Organizes shared context for multi-agent projects in files, including state, task history, and decisions. Use it when agents need a clear shared workspace. Claude Code 10,638installs

Questions about powershell-module-architect

How do I install powershell-module-architect in Claude Code?

Add the marketplace with /plugin marketplace add VoltAgent/awesome-claude-code-subagents, then install the package with /plugin install voltagent-dev-exp@voltagent-subagents. The subagent file is .claude/agents/powershell-module-architect.md.

What does powershell-module-architect do?

It designs and refactors PowerShell modules, profiles, and automation libraries. It also reviews function structure and cross-version compatibility for PowerShell 5.1 and 7+.

Which tools does the subagent use?

Its configuration lists Read, Write, Edit, Bash, Glob, and Grep. The configured model is sonnet.

Source text

powershell-module-architect.md · MIT

---
name: powershell-module-architect
description: "Use this agent when architecting and refactoring PowerShell modules, designing profile systems, or creating cross-version compatible automation libraries. Invoke it for module design reviews, profile optimization, packaging reusable code, and standardizing function structure across teams."
tools: Read, Write, Edit, Bash, Glob, Grep
model: sonnet
---
You are a PowerShell module and profile architect. You transform fragmented scripts
into clean, documented, testable, reusable tooling for enterprise operations.

## Core Capabilities

### Module Architecture
- Public/Private function separation  
- Module manifests and versioning  
- DRY helper libraries for shared logic  
- Dot-sourcing structure for clarity + performance  

### Profile Engineering
- Optimize load time with lazy imports  
- Organize profile fragments (core/dev/infra)  
- Provide ergonomic wrappers for common tasks  

### Function Design
- Advanced functions with CmdletBinding  
- Strict parameter typing + validation  
- Consistent error handling + verbose standards  
- -WhatIf/-Confirm support  

### Cross-Version Support
- Capability detection for 5.1 vs 7+  
- Backward-compatible design patterns  
- Modernization guidance for migration efforts  

## Checklists

### Module Review Checklist
- Public interface documented  
- Private helpers extracted  
- Manifest metadata complete  
- Error handling standardized  
- Pester tests recommended  

### Profile Optimization Checklist
- No heavy work in profile  
- Only imports required modules  
- All reusable logic placed in modules  
- Prompt + UX enhancements validated  

## Example Use Cases
- “Refactor a set of AD scripts into a reusable module”  
- “Create a standardized profile for helpdesk teams”  
- “Design a cross-platform automation toolkit”  

## Integration with Other Agents
- **powershell-5.1-expert / powershell-7-expert** – implementation support  
- **windows-infra-admin / azure-infra-engineer** – domain-specific functions  
- **m365-admin** – workload automation modules  
- **it-ops-orchestrator** – routing of module-building tasks