Introduce terminal UX design skill and update documentation (#230)

* feat(#214): introduce terminal UX design skill and instruction
- Add terminal UX design skill for PowerShell cmdlets and CLI workflows
- Include guidance based on Atlassian's principles and Nielsen's heuristics
- Update agent entry points and documentation to reflect new skill

* #214 feat: Adding Agentic Copilot workflow to the list of pr affected areas.

* fix(#214): expand coverage globs before invoking Pester

Author: stiwicourage

.github/agents/architect.agent.md

@@ -37,6 +37,7 @@ Design or reshape changes that cross public commands, private helper boundaries,
 ## Skills to use
 
 - `/powershell-module-development`
+- `/terminal-ux-design`
 - `/release-and-changelog`
 - `/markdown-authoring`
 - `/building-maintainable-code`

.github/agents/powershell-developer.agent.md

@@ -32,6 +32,7 @@ Implement PowerShell command and helper changes in the NovaModuleTools style.
 ## Skills to use
 
 - `/powershell-module-development`
+- `/terminal-ux-design`
 - `/pester-testing`
 - `/building-maintainable-code`
 - `/codescene-quality`

.github/agents/reviewer.agent.md

@@ -41,6 +41,7 @@ Review changes for correctness, maintainability, test coverage, workflow safety,
 
 ## Skills to use
 
+- `/terminal-ux-design`
 - `/codescene-quality`
 - `/safeguarding-ai-generated-code`
 - `/building-maintainable-code`

.github/copilot-instructions.md

@@ -37,15 +37,15 @@ For new or not-yet-scoped work, use the `architect` agent with `.github/prompts/
 
 The table below shows how to route work. Prompts are the task entry points; each prompt delegates to its agent, which uses the listed skills, which in turn enforce the listed instructions.
 
-| Task                          | Prompt                                     | Agent                  | Primary skills                                                                       | Primary instructions                                                              |
-| ----------------------------- | ------------------------------------------ | ---------------------- | ------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------- |
-| Design or scope a change      | `design-change.prompt.md`                  | `architect`            | `powershell-module-development`, `github-actions`, `release-and-changelog`, `markdown-authoring` | `repository-conventions`, `code-quality-matrix`                                   |
-| Implement an issue            | `implement-issue.prompt.md`                | `powershell-developer` | `powershell-module-development`, `pester-testing`, `building-maintainable-code`, `codescene-quality`, `safeguarding-ai-generated-code` | `repository-conventions`, `code-quality-matrix`, `psscriptanalyzer`, `powershell-coding-standards`, `platyps-help` |
-| Review a change               | `review-change.prompt.md`                  | `reviewer`             | `codescene-quality`, `safeguarding-ai-generated-code`, `building-maintainable-code`, `docs-site`, `markdown-authoring`, `pester-testing`, `release-and-changelog`, `github-actions` | All `.github/instructions/*.instructions.md`                                       |
-| Improve test coverage         | `improve-test-coverage.prompt.md`          | `test-engineer`        | `pester-testing`, `building-maintainable-code`, `codescene-quality`, `github-actions`, `guiding-refactoring-with-code-health`, `safeguarding-ai-generated-code` | `testing-policy`, `psscriptanalyzer`                                              |
-| Prepare a release             | `prepare-release.prompt.md`                | `release-manager`      | `release-and-changelog`, `markdown-authoring`                                        | `release-policy`, `repository-conventions`                                         |
-| Fix a CI failure              | `fix-ci-failure.prompt.md`                 | `powershell-developer` (or `test-engineer`) | `github-actions`, `pester-testing`                                                   | `testing-policy`, `psscriptanalyzer`, `repository-conventions`                     |
-| Update website docs           | (no dedicated prompt — invoke agent)        | `docs-site`            | `docs-site`, `markdown-authoring`                                                    | `documentation-separation`                                                         |
+| Task                     | Prompt                               | Agent                                       | Primary skills                                                                                                                                                                                            | Primary instructions                                                                                               |
+|--------------------------|--------------------------------------|---------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------|
+| Design or scope a change | `design-change.prompt.md`            | `architect`                                 | `powershell-module-development`, `terminal-ux-design`, `github-actions`, `release-and-changelog`, `markdown-authoring`                                                                                    | `repository-conventions`, `code-quality-matrix`                                                                    |
+| Implement an issue       | `implement-issue.prompt.md`          | `powershell-developer`                      | `powershell-module-development`, `terminal-ux-design`, `pester-testing`, `building-maintainable-code`, `codescene-quality`, `safeguarding-ai-generated-code`                                              | `repository-conventions`, `code-quality-matrix`, `psscriptanalyzer`, `powershell-coding-standards`, `platyps-help` |
+| Review a change          | `review-change.prompt.md`            | `reviewer`                                  | `terminal-ux-design`, `codescene-quality`, `safeguarding-ai-generated-code`, `building-maintainable-code`, `docs-site`, `markdown-authoring`, `pester-testing`, `release-and-changelog`, `github-actions` | All `.github/instructions/*.instructions.md`                                                                       |
+| Improve test coverage    | `improve-test-coverage.prompt.md`    | `test-engineer`                             | `pester-testing`, `building-maintainable-code`, `codescene-quality`, `github-actions`, `guiding-refactoring-with-code-health`, `safeguarding-ai-generated-code`                                           | `testing-policy`, `psscriptanalyzer`                                                                               |
+| Prepare a release        | `prepare-release.prompt.md`          | `release-manager`                           | `release-and-changelog`, `markdown-authoring`                                                                                                                                                             | `release-policy`, `repository-conventions`                                                                         |
+| Fix a CI failure         | `fix-ci-failure.prompt.md`           | `powershell-developer` (or `test-engineer`) | `github-actions`, `pester-testing`                                                                                                                                                                        | `testing-policy`, `psscriptanalyzer`, `repository-conventions`                                                     |
+| Update website docs      | (no dedicated prompt — invoke agent) | `docs-site`                                 | `docs-site`, `markdown-authoring`                                                                                                                                                                         | `documentation-separation`                                                                                         |
 
 ## Notation
 
@@ -61,5 +61,6 @@ The table below shows how to route work. Prompts are the task entry points; each
 - PSScriptAnalyzer workflow: `.github/instructions/psscriptanalyzer.instructions.md`
 - PowerShell coding standards: `.github/instructions/powershell-coding-standards.instructions.md`
 - PlatyPS help generation: `.github/instructions/platyps-help.instructions.md`
+- Terminal UX: `.github/instructions/terminal-ux-design.instructions.md` + `terminal-ux-design` skill
 - Release flow: `.github/instructions/release-policy.instructions.md` + `release-and-changelog` skill
 - Documentation separation: `.github/instructions/documentation-separation.instructions.md` + `docs-site` skill

.github/instructions/terminal-ux-design.instructions.md

@@ -0,0 +1,21 @@
+---
+applyTo: "**"
+---
+
+# Terminal UX design
+
+Use the `terminal-ux-design` skill when a change touches any user-facing command, terminal output, prompt, help surface, progress indicator, warning, error message, or scaffold guidance for those surfaces.
+
+This applies to:
+
+- PowerShell cmdlets
+- `% nova` CLI routes
+- private helpers that shape user-visible terminal behavior
+- contributor docs, command help, and scaffold content that teach those workflows
+
+Keep PowerShell cmdlet UX and `% nova` CLI UX distinct, but hold both to the same terminal UX bar.
+
+The skill is authoritative for:
+
+- Atlassian's 10 design principles for delightful CLIs
+- Jakob Nielsen's 10 usability heuristics for user interface design

.github/pull_request_template.md

@@ -20,6 +20,7 @@
 - [ ] Dependency or manifest changes (`project.json`, workflow dependencies, release tooling)
 - [ ] Security-sensitive change
 - [ ] Documentation-only change
+- [ ] Agentic Copilot Workflow + scaffold mirror + scaffold-sync guardrail test.
 - [ ] Other
 
 ## Review guidance