Skip to main content
subagent CX Codex

powershell-module-architect · voltagent/awesome-codex-subagents — Codex subagent: what it does, setup

powershell-module-architect designs PowerShell module structures, refines cmdlet contracts, and handles packaging issues with minimal disruption.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/powershell-module-architect.toml
Open on GitHub

What powershell-module-architect does

This subagent handles PowerShell module layout, command discovery, packaging, and profile architecture. Instead of broad rewrites, it targets the specific point of friction. The agent validates one standard path, one failure scenario, and an integration boundary before finishing.

It focuses on Verb-Noun cmdlet naming conventions, pipeline input and output consistency, script signing, and cross-platform compatibility across PowerShell editions. Unless the parent agent explicitly asks for a full API overhaul, this subagent restricts changes to the smallest intervention that fixes the issue.

What it helps with

  • design PowerShell module layout and clean public command boundaries
  • align cmdlet parameter contracts with standard Verb-Noun and pipeline rules
  • prepare module manifests and packaging for safe versioned publishing
  • validate cross-platform and cross-edition PowerShell compatibility

Example prompts for the agent

  • Review the public API surface and export rules in our PowerShell module
  • Fix pipeline input handling for the Set-Config cmdlet without breaking existing callers
  • Prepare module packaging and manifest checks for enterprise distribution

How to install powershell-module-architect

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/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about powershell-module-architect

How to install powershell-module-architect in Codex?

Place the subagent configuration file at .codex/agents/powershell-module-architect.toml.

What does powershell-module-architect do?

It guides PowerShell module structuring, cmdlet design, pipeline integration, error diagnostics, and safe packaging workflows.

Will powershell-module-architect redesign my whole module?

No, it is constrained to recommend the smallest safe intervention and avoids redesigning the entire public API for localized problems.

Source text

powershell-module-architect.toml · MIT
# powershell-module-architect

Use when a task needs PowerShell module structure, command design, packaging, or profile architecture work.

Own PowerShell module architecture work as developer productivity and workflow reliability engineering, not checklist execution.

Prioritize the smallest practical change or recommendation that reduces friction, preserves safety, and improves day-to-day delivery speed.

Working mode:
1. Map the workflow boundary and identify the concrete pain/failure point.
2. Distinguish evidence-backed root causes from symptoms.
3. Implement or recommend the smallest coherent intervention.
4. Validate one normal path, one failure path, and one integration edge.

Focus on:
- module layout, command discoverability, and coherent public API boundaries
- cmdlet contract quality: Verb-Noun naming, parameters, and pipeline behavior
- error model consistency and operator-friendly diagnostics
- packaging, versioning, and publication safety for module consumers
- script signing and trust posture where enterprise distribution applies
- cross-version/cross-platform behavior where PowerShell editions differ
- help/documentation fidelity with implemented command behavior

Quality checks:
- verify command contracts are stable for existing automation users
- confirm pipeline input/output behavior is explicit and testable
- check module manifest/version updates for upgrade compatibility
- ensure error handling provides actionable operator guidance
- call out signing/publication checks needed in target environments

Return:
- exact workflow/tool boundary analyzed or changed
- primary friction/failure source and supporting evidence
- smallest safe change/recommendation and key tradeoffs
- validations performed and remaining environment-level checks
- residual risk and prioritized follow-up actions

Do not redesign the entire module API for localized issues unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for DevOps and infrastructure →

powershell-module-architect by other authors comes first.

powershell-module-architect VoltAgent Community powershell-module-architect is a Claude Code subagent for designing and refactoring PowerShell modules. It handles profile systems, reusable libraries, and cross-version automation work. CX Codex 183installs powershell-ui-architect VoltAgent Community powershell-ui-architect designs desktop graphical interfaces (WinForms, WPF, Metro) and terminal UIs for PowerShell tools while keeping business logic separate. CX Codex 218installs powershell-master JosiahSiegel powershell-master — a skill for PowerShell work: cmdlet syntax, PSGallery modules, CI/CD pipeline patterns and security. Useful whenever the agent writes a .ps1 or edits a pipeline. CX Codex +1 1,200installs powershell-windows davila7 powershell-windows defines patterns for Windows PowerShell scripts, enforcing cmdlet parentheses, pure ASCII console output, and safe JSON parsing. Solves common syntax crashes. CX Codex +1 169installs powershell official github A GitHub Copilot rule that pushes it toward idiomatic PowerShell scripts following Microsoft's cmdlet guidelines. Useful when your repo has .ps1 and .psm1 files. CX Codex +1 ★ 41,430repo stars write-script-powershell windmill-labs write-script-powershell directs coding agents on writing PowerShell scripts for Windmill, handling safe local execution, metadata locks, and platform resources. CX Codex +1 1installs powershell-7-expert VoltAgent Community powershell-7-expert builds cross-platform PowerShell 7+ scripts for Azure, Microsoft Graph, and CI/CD pipelines with .NET 6/7 interop. CX Codex 256installs

From the same set176

The whole set →
slack-expert slack-expert is a Codex subagent for Slack development, from bot behavior to event handling and workflows. It joins tasks that involve Slack interactions or platform-specific integration details. CX Codex ★ 6,505repo stars refactoring-specialist refactoring-specialist delivers low-risk structural refactoring that preserves existing runtime behavior while improving modularity. CX Codex ★ 6,505repo stars readme-generator The readme-generator subagent builds a README from the repository’s actual files and behavior. Use it to document setup, commands, and configuration without making up details. CX Codex ★ 6,505repo stars powershell-ui-architect powershell-ui-architect is a Codex subagent for PowerShell interfaces in terminals, forms, WPF, and admin tools. It examines interactive workflows to locate friction and failures. CX Codex ★ 6,505repo stars mcp-developer The mcp-developer subagent handles MCP servers, clients, tool wiring, and protocol-aware integrations. Use it when contract behavior and failure handling need a close review. CX Codex ★ 6,505repo stars legacy-modernizer legacy-modernizer helps plan upgrades to older code, frameworks, or architecture without breaking what works. Use when you need to move to newer technology but the stakes are high for deployment risk. CX Codex ★ 6,505repo stars git-workflow-manager git-workflow-manager guides branching strategies, merge routines, and release flows. It recommends small, practical fixes rather than overhauling the repository setup. CX Codex ★ 6,505repo stars dx-optimizer The dx-optimizer subagent finds friction in setup, local workflows, and feedback loops. It recommends small changes and checks both normal and failing paths. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open