Converted skill
Applied rewrites:
- Rewrite merged standing-guidance source paths to the native AGENTS.md target.
- Rewrite merged standing-guidance source paths to the native AGENTS.md target.
- Rewrite merged standing-guidance source paths to the native AGENTS.md target.
- Rewrite Claude skill paths to shared skill paths.
- Rewrite Claude rule paths to shared skill paths.
name: invoke-powershell-engineer
description: Invoke the powershell-typed-engineer worker to design, implement, and verify PowerShell changes within typed repository boundaries. Applies PoshQC format -> analyze -> test toolchain, the 1-2 production-file direct-mode budget, the 3-production + 3-test per-batch cap, and zero-regression quality gates.
Implement PowerShell Skill
This direct-use wrapper delegates PowerShell implementation work to the powershell-typed-engineer worker. Use this entry point when a prompt needs a scoped PowerShell change that must stay inside the typed engineer's guardrails.
When to Use This Skill
Use this skill when:
- The user requests a PowerShell code change, bug fix, refactor, or test addition.
- Estimated scope fits the direct-mode path (1-2 production PowerShell files plus corresponding tests).
- The toolchain (PoshQC format, PSScriptAnalyzer, Pester with coverage where enforced) can be run in the current environment, or the user has explicitly authorized an unverified plan-only response.
If the estimated scope exceeds the direct-mode budget, this skill defers to the orchestrated flow via powershell-change-budget-router instead of proceeding directly.
Inputs
- Objective statement (what the change must accomplish).
- Files or entrypoints in scope (exact script or module paths and corresponding
*.Tests.ps1 paths).
- Constraints, including public function or module contracts that must be preserved.
- Optional approved plan. If none is supplied, the worker delegates plan authoring to
atomic_planner before any edits.
- Optional budget override in the form
budget: prod=<N>, test=<M> subject to repo policy compliance.
Output Paths
- PowerShell source (
*.ps1, *.psm1, *.psd1) and Pester test (*.Tests.ps1) files within the approved scope.
- Baseline evidence under
<FEATURE>/evidence/baseline/<timestamp>/ and post-change evidence under <FEATURE>/evidence/qa-gates/<timestamp>/ per evidence-and-timestamp-conventions.
- This location is canonical per evidence-and-timestamp-conventions and is not overridable. See
.agents/skills/evidence-and-timestamp-conventions/SKILL.md for the canonical evidence path authority.
- Plan artifacts under the active feature folder when the task is feature-scoped.
Required Reporting Block
The worker must return the powershell-qa-gate reporting block:
- Scope (exact file list).
- Baseline (PSScriptAnalyzer, Pester, coverage status).
- Plan (design and test strategy, including minimal DI seams and external executable wrapper mock strategy).
- Diffs (patch-style or full-file replacements).
- QA Gate Results (PSScriptAnalyzer, Pester, and coverage deltas, or clearly marked unverified).
Worker Routing
- Worker:
powershell-typed-engineer
Preloaded Contracts
The worker operates under the following preloaded skills and rules:
policy-compliance-order
powershell-change-budget-router
powershell-orchestration-state-machine
atomic-plan-contract
powershell-qa-gate
acceptance-criteria-tracking
feature-promotion-lifecycle
remediation-handoff-atomic-planner
evidence-and-timestamp-conventions
.agents/skills/powershell/SKILL.md (path-scoped for **/*.ps1, **/*.psm1, **/*.psd1)
AGENTS.md
AGENTS.md
AGENTS.md
1---2name: invoke-powershell-engineer-53description: Converted skill4---5# Converted skill67Applied rewrites:8- Rewrite merged standing-guidance source paths to the native AGENTS.md target.9- Rewrite merged standing-guidance source paths to the native AGENTS.md target.10- Rewrite merged standing-guidance source paths to the native AGENTS.md target.11- Rewrite Claude skill paths to shared skill paths.12- Rewrite Claude rule paths to shared skill paths.1314---15name: invoke-powershell-engineer16description: Invoke the powershell-typed-engineer worker to design, implement, and verify PowerShell changes within typed repository boundaries. Applies PoshQC format -> analyze -> test toolchain, the 1-2 production-file direct-mode budget, the 3-production + 3-test per-batch cap, and zero-regression quality gates.17---1819# Implement PowerShell Skill2021This direct-use wrapper delegates PowerShell implementation work to the `powershell-typed-engineer` worker. Use this entry point when a prompt needs a scoped PowerShell change that must stay inside the typed engineer's guardrails.2223## When to Use This Skill2425Use this skill when:2627- The user requests a PowerShell code change, bug fix, refactor, or test addition.28- Estimated scope fits the direct-mode path (1-2 production PowerShell files plus corresponding tests).29- The toolchain (PoshQC format, PSScriptAnalyzer, Pester with coverage where enforced) can be run in the current environment, or the user has explicitly authorized an unverified plan-only response.3031If the estimated scope exceeds the direct-mode budget, this skill defers to the orchestrated flow via `powershell-change-budget-router` instead of proceeding directly.3233## Inputs3435- Objective statement (what the change must accomplish).36- Files or entrypoints in scope (exact script or module paths and corresponding `*.Tests.ps1` paths).37- Constraints, including public function or module contracts that must be preserved.38- Optional approved plan. If none is supplied, the worker delegates plan authoring to `atomic_planner` before any edits.39- Optional budget override in the form `budget: prod=<N>, test=<M>` subject to repo policy compliance.4041## Output Paths4243- PowerShell source (`*.ps1`, `*.psm1`, `*.psd1`) and Pester test (`*.Tests.ps1`) files within the approved scope.44- Baseline evidence under `<FEATURE>/evidence/baseline/<timestamp>/` and post-change evidence under `<FEATURE>/evidence/qa-gates/<timestamp>/` per `evidence-and-timestamp-conventions`.45- This location is canonical per evidence-and-timestamp-conventions and is not overridable. See `.agents/skills/evidence-and-timestamp-conventions/SKILL.md` for the canonical evidence path authority.46- Plan artifacts under the active feature folder when the task is feature-scoped.4748## Required Reporting Block4950The worker must return the `powershell-qa-gate` reporting block:51521. Scope (exact file list).532. Baseline (PSScriptAnalyzer, Pester, coverage status).543. Plan (design and test strategy, including minimal DI seams and external executable wrapper mock strategy).554. Diffs (patch-style or full-file replacements).565. QA Gate Results (PSScriptAnalyzer, Pester, and coverage deltas, or clearly marked **unverified**).5758## Worker Routing5960- Worker: `powershell-typed-engineer`6162## Preloaded Contracts6364The worker operates under the following preloaded skills and rules:6566- `policy-compliance-order`67- `powershell-change-budget-router`68- `powershell-orchestration-state-machine`69- `atomic-plan-contract`70- `powershell-qa-gate`71- `acceptance-criteria-tracking`72- `feature-promotion-lifecycle`73- `remediation-handoff-atomic-planner`74- `evidence-and-timestamp-conventions`75- `.agents/skills/powershell/SKILL.md` (path-scoped for `**/*.ps1`, `**/*.psm1`, `**/*.psd1`)76- `AGENTS.md`77- `AGENTS.md`78- `AGENTS.md`