You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fix: clean up whitespace and formatting in multiple files
- Removed unnecessary blank lines in ReadAwesomeHost.ps1
- Adjusted spacing in GetNovaResolvedProjectPackageSettings.ps1
- Standardized spacing in SKILL.md and other markdown files
Copy file name to clipboardExpand all lines: .github/agents/architect.agent.md
+8-16Lines changed: 8 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,25 +7,21 @@ description: Designs and scopes NovaModuleTools changes through a discussion-fir
7
7
8
8
## Purpose
9
9
10
-
Design or reshape changes that cross public commands, private helper boundaries, workflows, documentation layers, or
11
-
release automation.
10
+
Design or reshape changes that cross public commands, private helper boundaries, workflows, documentation layers, or release automation.
12
11
13
12
## Responsibilities
14
13
15
-
- Default new work to analysis first: clarify the problem, scope, risks, affected layers, validation needs, and
16
-
documentation impact before implementation starts.
14
+
- Default new work to analysis first: clarify the problem, scope, risks, affected layers, validation needs, and documentation impact before implementation starts.
17
15
- Keep new-work design conversations interactive instead of collapsing them into a complete solution in the first reply.
18
16
- Identify the affected public surface, internal helper domains, tests, docs, and workflows.
19
17
- Keep the change aligned with the repo's layering and ArchitectureGuardrails expectations.
20
18
- Recommend the smallest structure that solves the problem cleanly.
21
19
- Treat scope cuts, deferrals, and out-of-scope boundaries as proposals that require explicit user confirmation.
22
-
- Before offering finalization when unresolved questions remain, summarize what is settled, what is still unresolved, and
23
-
present the explicit next-step choices.
20
+
- Before offering finalization when unresolved questions remain, summarize what is settled, what is still unresolved, and present the explicit next-step choices.
24
21
- Support two finalization modes when the discussion is sufficiently scoped:
25
22
- design package plus GitHub issue draft
26
23
- design package only
27
-
- Once the discussion is sufficiently scoped, produce an issue-ready change design with acceptance criteria,
28
-
out-of-scope boundaries, and a GitHub issue draft.
24
+
- Once the discussion is sufficiently scoped, produce an issue-ready change design with acceptance criteria, out-of-scope boundaries, and a GitHub issue draft.
29
25
30
26
## Inputs to inspect
31
27
@@ -54,10 +50,8 @@ release automation.
54
50
- Preserve the public/private command model and CLI vs PowerShell distinction.
55
51
- Avoid introducing new abstractions unless the current structure clearly duplicates or conflicts.
56
52
- Do not edit repository files unless the user explicitly asks to move from design into implementation.
57
-
- Do not finalize the full design package until the user says the discussion is done, or you explicitly ask whether you
58
-
should finalize it now.
59
-
- Do not ask to finalize as if the change is fully issue-ready when unresolved questions still exist; surface those
60
-
unresolved items explicitly before asking how the user wants to proceed.
53
+
- Do not finalize the full design package until the user says the discussion is done, or you explicitly ask whether you should finalize it now.
54
+
- Do not ask to finalize as if the change is fully issue-ready when unresolved questions still exist; surface those unresolved items explicitly before asking how the user wants to proceed.
61
55
- Do not finalize out-of-scope decisions unless the user has explicitly confirmed them.
62
56
63
57
## Definition of done
@@ -75,8 +69,6 @@ release automation.
75
69
- Must not invent new build or test tools.
76
70
- Must not bypass established adapters or shared helpers without a strong reason.
77
71
- Must not create or edit repository files when the task is still in design mode.
78
-
- Must not return a full implementation plan or finished issue draft in the first reply when the user is clearly asking
79
-
for a design discussion.
72
+
- Must not return a full implementation plan or finished issue draft in the first reply when the user is clearly asking for a design discussion.
80
73
- Must not leave the user guessing whether the final output is a handoff document, paste-ready issue text, or both.
81
-
- Must not decide on its own that requested work is out of scope and then finalize the design without the user's
82
-
confirmation.
74
+
- Must not decide on its own that requested work is out of scope and then finalize the design without the user's confirmation.
Copy file name to clipboardExpand all lines: .github/agents/docs-site.agent.md
+2-4Lines changed: 2 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,8 +7,7 @@ description: Keeps NovaModuleTools website documentation accurate and clearly se
7
7
8
8
## Purpose
9
9
10
-
Keep the GitHub Pages documentation under `docs/*.html` accurate, user-focused, and clearly separated from PowerShell
11
-
cmdlet help and contributor documentation.
10
+
Keep the GitHub Pages documentation under `docs/*.html` accurate, user-focused, and clearly separated from PowerShell cmdlet help and contributor documentation.
12
11
13
12
## Responsibilities
14
13
@@ -37,8 +36,7 @@ cmdlet help and contributor documentation.
37
36
38
37
- Treat `docs/*.html` as end-user website docs, not cmdlet help.
39
38
- Keep CLI and cmdlet surfaces clearly separated.
40
-
- Mention PowerShell-only commands in CLI-oriented docs only when there is no CLI equivalent for that scenario, such as
41
-
installing NovaModuleTools with `Install-Module`.
39
+
- Mention PowerShell-only commands in CLI-oriented docs only when there is no CLI equivalent for that scenario, such as installing NovaModuleTools with `Install-Module`.
Copy file name to clipboardExpand all lines: .github/agents/release-manager.agent.md
+2-4Lines changed: 2 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,8 +14,7 @@ Handle versioning, changelog shaping, release-flow documentation, and publish au
14
14
- Verify how a change affects stable vs prerelease behavior.
15
15
- Keep `CHANGELOG.md` accurate and release-ready.
16
16
- Review workflow, docs, and versioning implications together.
17
-
- Produce a release-ready summary that follows `.github/pull_request_template.md` when a release preparation summary is
18
-
requested.
17
+
- Produce a release-ready summary that follows `.github/pull_request_template.md` when a release preparation summary is requested.
19
18
20
19
## Inputs to inspect
21
20
@@ -39,8 +38,7 @@ Handle versioning, changelog shaping, release-flow documentation, and publish au
39
38
- Keep Keep a Changelog structure intact.
40
39
- Use only the official Keep a Changelog section types in `CHANGELOG.md` and `RELEASE_NOTE.md`: `Added`, `Changed`,
41
40
`Deprecated`, `Removed`, `Fixed`, and `Security`.
42
-
- Do not invent extra changelog section headings such as `Documentation`; place documentation-related release notes under
43
-
the official type that best matches the actual impact.
41
+
- Do not invent extra changelog section headings such as `Documentation`; place documentation-related release notes under the official type that best matches the actual impact.
44
42
- Distinguish contributor docs from end-user docs.
45
43
- Treat `.github/pull_request_template.md` as the authoritative format for structured release summaries.
46
44
- When the release summary is returned as Markdown or copy-ready UI output, it must follow the `markdown-authoring`
Copy file name to clipboardExpand all lines: .github/copilot-instructions.md
+9-24Lines changed: 9 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,8 +4,7 @@
4
4
5
5
Use this file as the repository-wide Copilot instruction entry point for NovaModuleTools.
6
6
7
-
NovaModuleTools is not a generic PowerShell repo. It has a strong split between public commands, private helpers,
8
-
Pester-heavy testing, GitHub Actions automation, CodeScene coverage gates, and Keep a Changelog / SemVer release flow.
7
+
NovaModuleTools is not a generic PowerShell repo. It has a strong split between public commands, private helpers, Pester-heavy testing, GitHub Actions automation, CodeScene coverage gates, and Keep a Changelog / SemVer release flow.
9
8
10
9
## Start here
11
10
@@ -17,22 +16,15 @@ Read these files before making non-trivial changes:
17
16
4. The relevant file in `.github/instructions/`
18
17
5. The relevant skill under `.github/skills/<skill-name>/SKILL.md`
19
18
20
-
Prompt templates under `.github/prompts/*.prompt.md` are not auto-loaded. Reference them explicitly in chat when you
21
-
want
22
-
to use one of the repository's reusable task prompts.
19
+
Prompt templates under `.github/prompts/*.prompt.md` are not auto-loaded. Reference them explicitly in chat when you want to use one of the repository's reusable task prompts.
23
20
24
21
For new or not-yet-scoped work, start with `.github/agents/architect.agent.md` and
25
-
`.github/prompts/design-change.prompt.md`. That flow should stay conversational first: analyze the request, ask
26
-
clarifying questions, present design options when needed, and only draft the final scoped solution or GitHub issue after
27
-
the discussion is complete. When unresolved questions still remain, architect should surface what is settled vs
28
-
unresolved before asking whether to finalize, and should allow either full finalization or a resumable design-package-only
29
-
handoff. Proposed scope cuts or out-of-scope boundaries must be confirmed by the user before they are treated as final.
22
+
`.github/prompts/design-change.prompt.md`. That flow should stay conversational first: analyze the request, ask clarifying questions, present design options when needed, and only draft the final scoped solution or GitHub issue after the discussion is complete. When unresolved questions still remain, architect should surface what is settled vs unresolved before asking whether to finalize, and should allow either full finalization or a resumable design-package-only handoff. Proposed scope cuts or out-of-scope boundaries must be confirmed by the user before they are treated as final.
30
23
31
24
## Repository map
32
25
33
26
-`src/public/` - public PowerShell command surface; one top-level function per file
-`tests/` - Pester tests and shared test-support scripts
37
29
-`scripts/build/` - local analyzer and build helpers
38
30
-`scripts/build/ci/` - CI coverage, CodeScene, and artifact helpers
@@ -58,11 +50,8 @@ handoff. Proposed scope cuts or out-of-scope boundaries must be confirmed by the
58
50
59
51
- When you are asked to suggest or prepare a commit message, answer in English.
60
52
- Use Conventional Commit format.
61
-
- Extract the ticket number from `$GIT_BRANCH_NAME` and render it as `(#<number>)` immediately after the type when one
62
-
is
63
-
available.
64
-
- If `$GIT_BRANCH_NAME` starts with `hotfix/` or `bug/`, use `fix` as the type even when the implementation looks more
65
-
like a feature. Use `fix!` if that branch change is also breaking.
53
+
- Extract the ticket number from `$GIT_BRANCH_NAME` and render it as `(#<number>)` immediately after the type when one is available.
54
+
- If `$GIT_BRANCH_NAME` starts with `hotfix/` or `bug/`, use `fix` as the type even when the implementation looks more like a feature. Use `fix!` if that branch change is also breaking.
66
55
- Otherwise estimate the type from the actual change:
67
56
-`feat` for feature work
68
57
-`fix` for bug fixes
@@ -74,11 +63,8 @@ handoff. Proposed scope cuts or out-of-scope boundaries must be confirmed by the
74
63
75
64
## Markdown output guidance
76
65
77
-
- When the output is intended to be copied as Markdown from the UI or written to a Markdown file, follow
78
-
the `markdown-authoring` skill (`.github/skills/markdown-authoring/SKILL.md`).
79
-
- Apply that rule especially to release summaries, review summaries, contributor-facing Markdown docs, prompt output,
80
-
and
81
-
PR-template-shaped text.
66
+
- When the output is intended to be copied as Markdown from the UI or written to a Markdown file, follow the `markdown-authoring` skill (`.github/skills/markdown-authoring/SKILL.md`).
67
+
- Apply that rule especially to release summaries, review summaries, contributor-facing Markdown docs, prompt output, and PR-template-shaped text.
82
68
83
69
## Validation expectations
84
70
@@ -97,8 +83,7 @@ When CodeScene tooling is available:
97
83
- use the `guiding-refactoring-with-code-health` skill for small, measured Code Health-driven refactors
98
84
- use the `safeguarding-ai-generated-code` skill when deciding whether AI-touched work is ready for commit or PR handoff
99
85
100
-
If CodeScene tooling is unavailable locally, continue with the normal repository validation flow and continue silently;
101
-
the pull request and CI flow remains the effective CodeScene gate.
86
+
If CodeScene tooling is unavailable locally, continue with the normal repository validation flow and continue silently; the pull request and CI flow remains the effective CodeScene gate.
102
87
103
88
For documentation-only changes, executable validation may be skipped if no code path or workflow behavior changed.
Copy file name to clipboardExpand all lines: .github/instructions/powershell-coding-standards.instructions.md
+3-7Lines changed: 3 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,8 +20,7 @@ Use this file when changing `src/public/`, `src/private/`, or PowerShell build/r
20
20
21
21
- Put internal helpers in the correct domain folder under `src/private/`.
22
22
- Reuse existing adapters and shared helpers before adding new infrastructure calls.
23
-
- Keep direct environment access, Git execution, upload requests, and self-update execution in their approved helper
24
-
locations. `tests/ArchitectureGuardrails.Tests.ps1` is authoritative.
23
+
- Keep direct environment access, Git execution, upload requests, and self-update execution in their approved helper locations. `tests/ArchitectureGuardrails.Tests.ps1` is authoritative.
- When an expression wraps onto the next line, indent the continuation line one extra level instead of trying to align
42
-
it
43
-
visually to a previous token column.
40
+
- When an expression wraps onto the next line, indent the continuation line one extra level instead of trying to align it visually to a previous token column.
44
41
45
42
### Spacing
46
43
@@ -56,8 +53,7 @@ Use this file when changing `src/public/`, `src/private/`, or PowerShell build/r
56
53
57
54
### Wrapping and braces
58
55
59
-
- Use same-line opening braces for functions, control statements, `try` / `catch` / `finally`, `switch` labels, classes,
60
-
and methods.
56
+
- Use same-line opening braces for functions, control statements, `try` / `catch` / `finally`, `switch` labels, classes, and methods.
61
57
- Keep `elseif`, `else`, `catch`, and `finally` on the same line as the preceding closing brace.
62
58
- Keep closing braces on their own line.
63
59
- Prefer multi-line `param(...)`, hashtables, and long argument sets over overly long single lines.
Use this file when changing versioning, changelog handling, package metadata, publish workflows, or GitHub release
10
-
automation.
9
+
Use this file when changing versioning, changelog handling, package metadata, publish workflows, or GitHub release automation.
11
10
12
11
## Versioning rules
13
12
@@ -17,8 +16,7 @@ automation.
17
16
- Keep `## [Unreleased]` valid and readable.
18
17
- Use only the official Keep a Changelog section types in both files: `Added`, `Changed`, `Deprecated`, `Removed`,
19
18
`Fixed`, and `Security`.
20
-
- Do not add custom section headings such as `Documentation`; place documentation-related release notes under the
21
-
official type that best matches the real change.
19
+
- Do not add custom section headings such as `Documentation`; place documentation-related release notes under the official type that best matches the real change.
22
20
- If `RELEASE_NOTE.md` has no public API or workflow changes under `## [Unreleased]`, keep the exact placeholder under
23
21
`### Added`: `No public API or workflow changes in this release. Internal maintenance only.`
24
22
- If `RELEASE_NOTE.md` has real release-note entries, do not keep that placeholder.
0 commit comments