BranchesTags

Repository files navigation

GitHub Workflows and Copilot PM Automation

This repository is a solo developer project management toolkit for working across multiple GitHub repositories. It centralises reusable automation patterns, Copilot prompts and agents, and label governance so issue and PR curation stays consistent with less manual admin.

Purpose and Context

  • Keep cross-repo work visible so older repositories do not quietly go stale.
  • Keep the project board as the single pane of glass for committed work.
  • Use plan/LABEL_STRATEGY.md as the single source of truth for label names, colours, and board rules.
  • Use Copilot PM prompts and scripts to enforce consistency with minimal overhead.

For strategy and intent, start with plan/GOALS.md and plan/OPERATING_MODEL.md.

GitHub Actions Workflows

Files in .github/workflows/ (excluding trigger-* workflows):

FilePurpose
powershell-validate.ymlRuns PSScriptAnalyzer against scripts/ on pushes/PRs to main, plus manual dispatch support.

Reuse in other repositories

There are currently no workflow_call reusable workflows in this repository. Current reuse patterns are:

  • Copy or adapt workflow YAML into target repositories.
  • Use migration and audit scripts in scripts/ for repo fleet rollout where relevant.

Scripts

Files in scripts/:

FilePurpose
Convert-IssueLabels.ps1Converts deprecated labels on issues to the active label taxonomy from plan/LABEL_STRATEGY.md (-WhatIf supported).
Export-OssSuitabilityAudit.ps1Audits OSS-readiness assets for one repo or across eligible repos, including repo-local .github/FUNDING.yml baseline matching; exports CSV and optional Markdown.
Export-PatExists.ps1Audits repos for workflow references to PERSONAL_ACCESS_TOKEN and reports whether that secret exists.
Export-WorkflowAudit.ps1Audits repositories for expected vs legacy project-workflow files and exports results to CSV.
Import-Workflow.ps1Bulk-import helper that opens PRs to add the legacy project workflow trigger file where missing.
Install-CopilotAssets.ps1Installs agents, prompts, skills, and instructions into a target repo from one or more configured source repos.
Install-ProjectBootstrap.ps1Copies root project templates, then runs Install-CopilotAssets.ps1 for .github asset bootstrap.
Migrate-Workflows.ps1Batch migration helper driven by workflow audit CSV; can remove legacy files and open migration PRs.
Remove-DeprecatedLabels.ps1Deletes deprecated labels after issue relabelling is complete.
Remove-ProjectWorkflow.ps1Removes legacy add-to-personal-project.yml and deletes the PERSONAL_ACCESS_TOKEN Actions secret across repos.
Update-GitHubLabels.ps1Upserts repository labels from plan/LABEL_STRATEGY.md.
copilot-assets.example.jsonExample multi-source config for Install-CopilotAssets.ps1, including optional naming transforms.

Recommended label migration order

  1. ./scripts/Update-GitHubLabels.ps1 <owner/repo>
  2. ./scripts/Convert-IssueLabels.ps1 <owner/repo> -WhatIf
  3. ./scripts/Convert-IssueLabels.ps1 <owner/repo>
  4. Review issue updates in GitHub
  5. ./scripts/Remove-DeprecatedLabels.ps1 <owner/repo>

Copilot Tooling

Runtime Copilot assets live in .github/.

Prompts

Files in .github/prompts/:

FilePurpose
pm-assistant.prompt.mdEntry-point PM assistant that routes users to the right PM prompt path.
pm-backlog-review.prompt.mdWeekly cross-repo backlog review with board state checks and prioritised recommendations.
pm-create-story.prompt.mdCreates a well-formed story issue using the standard structure and labels.
pm-daily.prompt.mdDaily focus prompt showing board snapshot, stalled items, and top priorities.
pm-issue-triage.prompt.mdTriage flow for unlabelled issues and PRs in full participation repos.
pm-iteration-plan.prompt.mdIteration planning flow that resolves stalled work and curates Up Next.
pr-address-coding-review.prompt.mdProcess for addressing PR review threads, replying, and resolving each thread.
repo-update-docs.prompt.mdRegenerates README and supports Diataxis docs planning and updates.
repo-update-from-strategy.prompt.mdPropagates changes from plan/LABEL_STRATEGY.md across repo assets.
repo-update-pinned-models.prompt.mdUpdates model pinning references and policy wording across repository files.

Agents

Files in .github/agents/:

FilePurpose
pm-assistant.agent.mdConversational PM router that interviews the user and recommends prompt sequences.
pm-backlog-management.agent.mdExecution agent for daily, triage, backlog review, and iteration planning workflows.
repo-docs-writer.agent.mdDocumentation specialist for internal README work and public Diataxis docs.
repo-label-strategy-keeper.agent.mdConsistency validator for label references against plan/LABEL_STRATEGY.md.

Skills

Files in .github/skills/:

FilePurpose
.github/skills/documentation-writer/SKILL.mdDiataxis documentation guidance and writing workflow.
.github/skills/github-issue-management/SKILL.mdCore issue/PR triage and label governance workflow.
.github/skills/github-issue-management/assets/triage-workflow.mdVisual triage flow reference.
.github/skills/github-issue-management/references/CUSTOMISATION_GUIDE.mdHow to adapt the issue-management skill for other repositories.
.github/skills/github-issue-management/references/github-labels.mdLabel taxonomy reference and decision guide.
.github/skills/github-issue-management/references/project-setup.mdBoard setup, status model, and board behaviour rules.
.github/skills/github-issue-management/scripts/Set-IssueLabelExample.ps1Example script for applying labels via gh issue edit.

Instructions

Files in .github/instructions/:

FilePurpose
label-script-update.instructions.mdRules for keeping scripts/Update-GitHubLabels.ps1 in sync with plan/LABEL_STRATEGY.md.

Setup and Prerequisites

  • GitHub CLI installed and authenticated (gh auth status).
  • PowerShell (pwsh) available to run scripts.
  • Permission to read/write issues, PRs, labels, and (where needed) project board items via GitHub APIs.
  • Access to the project board: https://github.com/users/markheydon/projects/6.
  • For legacy workflow migration scripts, permission to manage Actions secrets (PERSONAL_ACCESS_TOKEN) in target repos.

Label Strategy

Label policy is defined in plan/LABEL_STRATEGY.md.

  • Core labels: epic, story, bug
  • Board inclusion: story and bug are board units of work; epic is excluded
  • Common modifiers: priority-high, blocked, not-started, out-of-scope, feedback-required, waiting-for-details
  • Dependabot PRs are treated as story-equivalent board work in PM Mode

If you change label strategy, run /repo-update-from-strategy to propagate updates.

Public Docs

Public GitHub Pages documentation is in docs/, structured using Diataxis (tutorials, how-to guides, reference, explanation).

License

MIT - see LICENSE.

Last updated: 2026-05-17

About

Some standard workflow stuff I use.

markheydon.me.uk/github-workflows/

Resources

Readme
MIT license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

1 star

Watchers

1 watching

Forks

0 forks
Report repository

Sponsor this project

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
BranchesTags
Repository files navigation
GitHub Workflows and Copilot PM Automation
This repository is a solo developer project management toolkit for working across multiple GitHub repositories. It centralises reusable automation patterns, Copilot prompts and agents, and label governance so issue and PR curation stays consistent with less manual admin.
Purpose and Context
  • Keep cross-repo work visible so older repositories do not quietly go stale.
  • Keep the project board as the single pane of glass for committed work.
  • Use plan/LABEL_STRATEGY.md as the single source of truth for label names, colours, and board rules.
  • Use Copilot PM prompts and scripts to enforce consistency with minimal overhead.
For strategy and intent, start with plan/GOALS.md and plan/OPERATING_MODEL.md.
GitHub Actions Workflows
Files in .github/workflows/ (excluding trigger-* workflows):
FilePurpose
powershell-validate.ymlRuns PSScriptAnalyzer against scripts/ on pushes/PRs to main, plus manual dispatch support.
Reuse in other repositories
There are currently no workflow_call reusable workflows in this repository. Current reuse patterns are:
  • Copy or adapt workflow YAML into target repositories.
  • Use migration and audit scripts in scripts/ for repo fleet rollout where relevant.
Scripts
Files in scripts/:
FilePurpose
Convert-IssueLabels.ps1Converts deprecated labels on issues to the active label taxonomy from plan/LABEL_STRATEGY.md (-WhatIf supported).
Export-OssSuitabilityAudit.ps1Audits OSS-readiness assets for one repo or across eligible repos, including repo-local .github/FUNDING.yml baseline matching; exports CSV and optional Markdown.
Export-PatExists.ps1Audits repos for workflow references to PERSONAL_ACCESS_TOKEN and reports whether that secret exists.
Export-WorkflowAudit.ps1Audits repositories for expected vs legacy project-workflow files and exports results to CSV.
Import-Workflow.ps1Bulk-import helper that opens PRs to add the legacy project workflow trigger file where missing.
Install-CopilotAssets.ps1Installs agents, prompts, skills, and instructions into a target repo from one or more configured source repos.
Install-ProjectBootstrap.ps1Copies root project templates, then runs Install-CopilotAssets.ps1 for .github asset bootstrap.
Migrate-Workflows.ps1Batch migration helper driven by workflow audit CSV; can remove legacy files and open migration PRs.
Remove-DeprecatedLabels.ps1Deletes deprecated labels after issue relabelling is complete.
Remove-ProjectWorkflow.ps1Removes legacy add-to-personal-project.yml and deletes the PERSONAL_ACCESS_TOKEN Actions secret across repos.
Update-GitHubLabels.ps1Upserts repository labels from plan/LABEL_STRATEGY.md.
copilot-assets.example.jsonExample multi-source config for Install-CopilotAssets.ps1, including optional naming transforms.
Recommended label migration order
  1. ./scripts/Update-GitHubLabels.ps1 <owner/repo>
  2. ./scripts/Convert-IssueLabels.ps1 <owner/repo> -WhatIf
  3. ./scripts/Convert-IssueLabels.ps1 <owner/repo>
  4. Review issue updates in GitHub
  5. ./scripts/Remove-DeprecatedLabels.ps1 <owner/repo>
Copilot Tooling
Runtime Copilot assets live in .github/.
Prompts
Files in .github/prompts/:
FilePurpose
pm-assistant.prompt.mdEntry-point PM assistant that routes users to the right PM prompt path.
pm-backlog-review.prompt.mdWeekly cross-repo backlog review with board state checks and prioritised recommendations.
pm-create-story.prompt.mdCreates a well-formed story issue using the standard structure and labels.
pm-daily.prompt.mdDaily focus prompt showing board snapshot, stalled items, and top priorities.
pm-issue-triage.prompt.mdTriage flow for unlabelled issues and PRs in full participation repos.
pm-iteration-plan.prompt.mdIteration planning flow that resolves stalled work and curates Up Next.
pr-address-coding-review.prompt.mdProcess for addressing PR review threads, replying, and resolving each thread.
repo-update-docs.prompt.mdRegenerates README and supports Diataxis docs planning and updates.
repo-update-from-strategy.prompt.mdPropagates changes from plan/LABEL_STRATEGY.md across repo assets.
repo-update-pinned-models.prompt.mdUpdates model pinning references and policy wording across repository files.
Agents
Files in .github/agents/:
FilePurpose
pm-assistant.agent.mdConversational PM router that interviews the user and recommends prompt sequences.
pm-backlog-management.agent.mdExecution agent for daily, triage, backlog review, and iteration planning workflows.
repo-docs-writer.agent.mdDocumentation specialist for internal README work and public Diataxis docs.
repo-label-strategy-keeper.agent.mdConsistency validator for label references against plan/LABEL_STRATEGY.md.
Skills
Files in .github/skills/:
FilePurpose
.github/skills/documentation-writer/SKILL.mdDiataxis documentation guidance and writing workflow.
.github/skills/github-issue-management/SKILL.mdCore issue/PR triage and label governance workflow.
.github/skills/github-issue-management/assets/triage-workflow.mdVisual triage flow reference.
.github/skills/github-issue-management/references/CUSTOMISATION_GUIDE.mdHow to adapt the issue-management skill for other repositories.
.github/skills/github-issue-management/references/github-labels.mdLabel taxonomy reference and decision guide.
.github/skills/github-issue-management/references/project-setup.mdBoard setup, status model, and board behaviour rules.
.github/skills/github-issue-management/scripts/Set-IssueLabelExample.ps1Example script for applying labels via gh issue edit.
Instructions
Files in .github/instructions/:
FilePurpose
label-script-update.instructions.mdRules for keeping scripts/Update-GitHubLabels.ps1 in sync with plan/LABEL_STRATEGY.md.
Setup and Prerequisites
  • GitHub CLI installed and authenticated (gh auth status).
  • PowerShell (pwsh) available to run scripts.
  • Permission to read/write issues, PRs, labels, and (where needed) project board items via GitHub APIs.
  • Access to the project board: https://github.com/users/markheydon/projects/6.
  • For legacy workflow migration scripts, permission to manage Actions secrets (PERSONAL_ACCESS_TOKEN) in target repos.
Label Strategy
Label policy is defined in plan/LABEL_STRATEGY.md.
  • Core labels: epic, story, bug
  • Board inclusion: story and bug are board units of work; epic is excluded
  • Common modifiers: priority-high, blocked, not-started, out-of-scope, feedback-required, waiting-for-details
  • Dependabot PRs are treated as story-equivalent board work in PM Mode
If you change label strategy, run /repo-update-from-strategy to propagate updates.
Public Docs
Public GitHub Pages documentation is in docs/, structured using Diataxis (tutorials, how-to guides, reference, explanation).
License
MIT - see LICENSE.
Last updated: 2026-05-17
About
Some standard workflow stuff I use.
markheydon.me.uk/github-workflows/
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Sponsor this project
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
GitHub Workflows and Copilot PM Automation
This repository is a solo developer project management toolkit for working across multiple GitHub repositories. It centralises reusable automation patterns, Copilot prompts and agents, and label governance so issue and PR curation stays consistent with less manual admin.
Purpose and Context
  • Keep cross-repo work visible so older repositories do not quietly go stale.
  • Keep the project board as the single pane of glass for committed work.
  • Use plan/LABEL_STRATEGY.md as the single source of truth for label names, colours, and board rules.
  • Use Copilot PM prompts and scripts to enforce consistency with minimal overhead.
For strategy and intent, start with plan/GOALS.md and plan/OPERATING_MODEL.md.
GitHub Actions Workflows
Files in .github/workflows/ (excluding trigger-* workflows):
FilePurpose
powershell-validate.ymlRuns PSScriptAnalyzer against scripts/ on pushes/PRs to main, plus manual dispatch support.
Reuse in other repositories
There are currently no workflow_call reusable workflows in this repository. Current reuse patterns are:
  • Copy or adapt workflow YAML into target repositories.
  • Use migration and audit scripts in scripts/ for repo fleet rollout where relevant.
Scripts
Files in scripts/:
FilePurpose
Convert-IssueLabels.ps1Converts deprecated labels on issues to the active label taxonomy from plan/LABEL_STRATEGY.md (-WhatIf supported).
Export-OssSuitabilityAudit.ps1Audits OSS-readiness assets for one repo or across eligible repos, including repo-local .github/FUNDING.yml baseline matching; exports CSV and optional Markdown.
Export-PatExists.ps1Audits repos for workflow references to PERSONAL_ACCESS_TOKEN and reports whether that secret exists.
Export-WorkflowAudit.ps1Audits repositories for expected vs legacy project-workflow files and exports results to CSV.
Import-Workflow.ps1Bulk-import helper that opens PRs to add the legacy project workflow trigger file where missing.
Install-CopilotAssets.ps1Installs agents, prompts, skills, and instructions into a target repo from one or more configured source repos.
Install-ProjectBootstrap.ps1Copies root project templates, then runs Install-CopilotAssets.ps1 for .github asset bootstrap.
Migrate-Workflows.ps1Batch migration helper driven by workflow audit CSV; can remove legacy files and open migration PRs.
Remove-DeprecatedLabels.ps1Deletes deprecated labels after issue relabelling is complete.
Remove-ProjectWorkflow.ps1Removes legacy add-to-personal-project.yml and deletes the PERSONAL_ACCESS_TOKEN Actions secret across repos.
Update-GitHubLabels.ps1Upserts repository labels from plan/LABEL_STRATEGY.md.
copilot-assets.example.jsonExample multi-source config for Install-CopilotAssets.ps1, including optional naming transforms.
Recommended label migration order
  1. ./scripts/Update-GitHubLabels.ps1 <owner/repo>
  2. ./scripts/Convert-IssueLabels.ps1 <owner/repo> -WhatIf
  3. ./scripts/Convert-IssueLabels.ps1 <owner/repo>
  4. Review issue updates in GitHub
  5. ./scripts/Remove-DeprecatedLabels.ps1 <owner/repo>
Copilot Tooling
Runtime Copilot assets live in .github/.
Prompts
Files in .github/prompts/:
FilePurpose
pm-assistant.prompt.mdEntry-point PM assistant that routes users to the right PM prompt path.
pm-backlog-review.prompt.mdWeekly cross-repo backlog review with board state checks and prioritised recommendations.
pm-create-story.prompt.mdCreates a well-formed story issue using the standard structure and labels.
pm-daily.prompt.mdDaily focus prompt showing board snapshot, stalled items, and top priorities.
pm-issue-triage.prompt.mdTriage flow for unlabelled issues and PRs in full participation repos.
pm-iteration-plan.prompt.mdIteration planning flow that resolves stalled work and curates Up Next.
pr-address-coding-review.prompt.mdProcess for addressing PR review threads, replying, and resolving each thread.
repo-update-docs.prompt.mdRegenerates README and supports Diataxis docs planning and updates.
repo-update-from-strategy.prompt.mdPropagates changes from plan/LABEL_STRATEGY.md across repo assets.
repo-update-pinned-models.prompt.mdUpdates model pinning references and policy wording across repository files.
Agents
Files in .github/agents/:
FilePurpose
pm-assistant.agent.mdConversational PM router that interviews the user and recommends prompt sequences.
pm-backlog-management.agent.mdExecution agent for daily, triage, backlog review, and iteration planning workflows.
repo-docs-writer.agent.mdDocumentation specialist for internal README work and public Diataxis docs.
repo-label-strategy-keeper.agent.mdConsistency validator for label references against plan/LABEL_STRATEGY.md.
Skills
Files in .github/skills/:
FilePurpose
.github/skills/documentation-writer/SKILL.mdDiataxis documentation guidance and writing workflow.
.github/skills/github-issue-management/SKILL.mdCore issue/PR triage and label governance workflow.
.github/skills/github-issue-management/assets/triage-workflow.mdVisual triage flow reference.
.github/skills/github-issue-management/references/CUSTOMISATION_GUIDE.mdHow to adapt the issue-management skill for other repositories.
.github/skills/github-issue-management/references/github-labels.mdLabel taxonomy reference and decision guide.
.github/skills/github-issue-management/references/project-setup.mdBoard setup, status model, and board behaviour rules.
.github/skills/github-issue-management/scripts/Set-IssueLabelExample.ps1Example script for applying labels via gh issue edit.
Instructions
Files in .github/instructions/:
FilePurpose
label-script-update.instructions.mdRules for keeping scripts/Update-GitHubLabels.ps1 in sync with plan/LABEL_STRATEGY.md.
Setup and Prerequisites
  • GitHub CLI installed and authenticated (gh auth status).
  • PowerShell (pwsh) available to run scripts.
  • Permission to read/write issues, PRs, labels, and (where needed) project board items via GitHub APIs.
  • Access to the project board: https://github.com/users/markheydon/projects/6.
  • For legacy workflow migration scripts, permission to manage Actions secrets (PERSONAL_ACCESS_TOKEN) in target repos.
Label Strategy
Label policy is defined in plan/LABEL_STRATEGY.md.
  • Core labels: epic, story, bug
  • Board inclusion: story and bug are board units of work; epic is excluded
  • Common modifiers: priority-high, blocked, not-started, out-of-scope, feedback-required, waiting-for-details
  • Dependabot PRs are treated as story-equivalent board work in PM Mode
If you change label strategy, run /repo-update-from-strategy to propagate updates.
Public Docs
Public GitHub Pages documentation is in docs/, structured using Diataxis (tutorials, how-to guides, reference, explanation).
License
MIT - see LICENSE.
Last updated: 2026-05-17
About
Some standard workflow stuff I use.
markheydon.me.uk/github-workflows/
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Sponsor this project
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
GitHub Workflows and Copilot PM Automation
This repository is a solo developer project management toolkit for working across multiple GitHub repositories. It centralises reusable automation patterns, Copilot prompts and agents, and label governance so issue and PR curation stays consistent with less manual admin.
Purpose and Context
  • Keep cross-repo work visible so older repositories do not quietly go stale.
  • Keep the project board as the single pane of glass for committed work.
  • Use plan/LABEL_STRATEGY.md as the single source of truth for label names, colours, and board rules.
  • Use Copilot PM prompts and scripts to enforce consistency with minimal overhead.
For strategy and intent, start with plan/GOALS.md and plan/OPERATING_MODEL.md.
GitHub Actions Workflows
Files in .github/workflows/ (excluding trigger-* workflows):
FilePurpose
powershell-validate.ymlRuns PSScriptAnalyzer against scripts/ on pushes/PRs to main, plus manual dispatch support.
Reuse in other repositories
There are currently no workflow_call reusable workflows in this repository. Current reuse patterns are:
  • Copy or adapt workflow YAML into target repositories.
  • Use migration and audit scripts in scripts/ for repo fleet rollout where relevant.
Scripts
Files in scripts/:
FilePurpose
Convert-IssueLabels.ps1Converts deprecated labels on issues to the active label taxonomy from plan/LABEL_STRATEGY.md (-WhatIf supported).
Export-OssSuitabilityAudit.ps1Audits OSS-readiness assets for one repo or across eligible repos, including repo-local .github/FUNDING.yml baseline matching; exports CSV and optional Markdown.
Export-PatExists.ps1Audits repos for workflow references to PERSONAL_ACCESS_TOKEN and reports whether that secret exists.
Export-WorkflowAudit.ps1Audits repositories for expected vs legacy project-workflow files and exports results to CSV.
Import-Workflow.ps1Bulk-import helper that opens PRs to add the legacy project workflow trigger file where missing.
Install-CopilotAssets.ps1Installs agents, prompts, skills, and instructions into a target repo from one or more configured source repos.
Install-ProjectBootstrap.ps1Copies root project templates, then runs Install-CopilotAssets.ps1 for .github asset bootstrap.
Migrate-Workflows.ps1Batch migration helper driven by workflow audit CSV; can remove legacy files and open migration PRs.
Remove-DeprecatedLabels.ps1Deletes deprecated labels after issue relabelling is complete.
Remove-ProjectWorkflow.ps1Removes legacy add-to-personal-project.yml and deletes the PERSONAL_ACCESS_TOKEN Actions secret across repos.
Update-GitHubLabels.ps1Upserts repository labels from plan/LABEL_STRATEGY.md.
copilot-assets.example.jsonExample multi-source config for Install-CopilotAssets.ps1, including optional naming transforms.
Recommended label migration order
  1. ./scripts/Update-GitHubLabels.ps1 <owner/repo>
  2. ./scripts/Convert-IssueLabels.ps1 <owner/repo> -WhatIf
  3. ./scripts/Convert-IssueLabels.ps1 <owner/repo>
  4. Review issue updates in GitHub
  5. ./scripts/Remove-DeprecatedLabels.ps1 <owner/repo>
Copilot Tooling
Runtime Copilot assets live in .github/.
Prompts
Files in .github/prompts/:
FilePurpose
pm-assistant.prompt.mdEntry-point PM assistant that routes users to the right PM prompt path.
pm-backlog-review.prompt.mdWeekly cross-repo backlog review with board state checks and prioritised recommendations.
pm-create-story.prompt.mdCreates a well-formed story issue using the standard structure and labels.
pm-daily.prompt.mdDaily focus prompt showing board snapshot, stalled items, and top priorities.
pm-issue-triage.prompt.mdTriage flow for unlabelled issues and PRs in full participation repos.
pm-iteration-plan.prompt.mdIteration planning flow that resolves stalled work and curates Up Next.
pr-address-coding-review.prompt.mdProcess for addressing PR review threads, replying, and resolving each thread.
repo-update-docs.prompt.mdRegenerates README and supports Diataxis docs planning and updates.
repo-update-from-strategy.prompt.mdPropagates changes from plan/LABEL_STRATEGY.md across repo assets.
repo-update-pinned-models.prompt.mdUpdates model pinning references and policy wording across repository files.
Agents
Files in .github/agents/:
FilePurpose
pm-assistant.agent.mdConversational PM router that interviews the user and recommends prompt sequences.
pm-backlog-management.agent.mdExecution agent for daily, triage, backlog review, and iteration planning workflows.
repo-docs-writer.agent.mdDocumentation specialist for internal README work and public Diataxis docs.
repo-label-strategy-keeper.agent.mdConsistency validator for label references against plan/LABEL_STRATEGY.md.
Skills
Files in .github/skills/:
FilePurpose
.github/skills/documentation-writer/SKILL.mdDiataxis documentation guidance and writing workflow.
.github/skills/github-issue-management/SKILL.mdCore issue/PR triage and label governance workflow.
.github/skills/github-issue-management/assets/triage-workflow.mdVisual triage flow reference.
.github/skills/github-issue-management/references/CUSTOMISATION_GUIDE.mdHow to adapt the issue-management skill for other repositories.
.github/skills/github-issue-management/references/github-labels.mdLabel taxonomy reference and decision guide.
.github/skills/github-issue-management/references/project-setup.mdBoard setup, status model, and board behaviour rules.
.github/skills/github-issue-management/scripts/Set-IssueLabelExample.ps1Example script for applying labels via gh issue edit.
Instructions
Files in .github/instructions/:
FilePurpose
label-script-update.instructions.mdRules for keeping scripts/Update-GitHubLabels.ps1 in sync with plan/LABEL_STRATEGY.md.
Setup and Prerequisites
  • GitHub CLI installed and authenticated (gh auth status).
  • PowerShell (pwsh) available to run scripts.
  • Permission to read/write issues, PRs, labels, and (where needed) project board items via GitHub APIs.
  • Access to the project board: https://github.com/users/markheydon/projects/6.
  • For legacy workflow migration scripts, permission to manage Actions secrets (PERSONAL_ACCESS_TOKEN) in target repos.
Label Strategy
Label policy is defined in plan/LABEL_STRATEGY.md.
  • Core labels: epic, story, bug
  • Board inclusion: story and bug are board units of work; epic is excluded
  • Common modifiers: priority-high, blocked, not-started, out-of-scope, feedback-required, waiting-for-details
  • Dependabot PRs are treated as story-equivalent board work in PM Mode
If you change label strategy, run /repo-update-from-strategy to propagate updates.
Public Docs
Public GitHub Pages documentation is in docs/, structured using Diataxis (tutorials, how-to guides, reference, explanation).
License
MIT - see LICENSE.
Last updated: 2026-05-17
About
Some standard workflow stuff I use.
markheydon.me.uk/github-workflows/
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Sponsor this project
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
BranchesTags
Repository files navigation
GitHub Workflows and Copilot PM Automation
This repository is a solo developer project management toolkit for working across multiple GitHub repositories. It centralises reusable automation patterns, Copilot prompts and agents, and label governance so issue and PR curation stays consistent with less manual admin.
Purpose and Context
  • Keep cross-repo work visible so older repositories do not quietly go stale.
  • Keep the project board as the single pane of glass for committed work.
  • Use plan/LABEL_STRATEGY.md as the single source of truth for label names, colours, and board rules.
  • Use Copilot PM prompts and scripts to enforce consistency with minimal overhead.
For strategy and intent, start with plan/GOALS.md and plan/OPERATING_MODEL.md.
GitHub Actions Workflows
Files in .github/workflows/ (excluding trigger-* workflows):
FilePurpose
powershell-validate.ymlRuns PSScriptAnalyzer against scripts/ on pushes/PRs to main, plus manual dispatch support.
Reuse in other repositories
There are currently no workflow_call reusable workflows in this repository. Current reuse patterns are:
  • Copy or adapt workflow YAML into target repositories.
  • Use migration and audit scripts in scripts/ for repo fleet rollout where relevant.
Scripts
Files in scripts/:
FilePurpose
Convert-IssueLabels.ps1Converts deprecated labels on issues to the active label taxonomy from plan/LABEL_STRATEGY.md (-WhatIf supported).
Export-OssSuitabilityAudit.ps1Audits OSS-readiness assets for one repo or across eligible repos, including repo-local .github/FUNDING.yml baseline matching; exports CSV and optional Markdown.
Export-PatExists.ps1Audits repos for workflow references to PERSONAL_ACCESS_TOKEN and reports whether that secret exists.
Export-WorkflowAudit.ps1Audits repositories for expected vs legacy project-workflow files and exports results to CSV.
Import-Workflow.ps1Bulk-import helper that opens PRs to add the legacy project workflow trigger file where missing.
Install-CopilotAssets.ps1Installs agents, prompts, skills, and instructions into a target repo from one or more configured source repos.
Install-ProjectBootstrap.ps1Copies root project templates, then runs Install-CopilotAssets.ps1 for .github asset bootstrap.
Migrate-Workflows.ps1Batch migration helper driven by workflow audit CSV; can remove legacy files and open migration PRs.
Remove-DeprecatedLabels.ps1Deletes deprecated labels after issue relabelling is complete.
Remove-ProjectWorkflow.ps1Removes legacy add-to-personal-project.yml and deletes the PERSONAL_ACCESS_TOKEN Actions secret across repos.
Update-GitHubLabels.ps1Upserts repository labels from plan/LABEL_STRATEGY.md.
copilot-assets.example.jsonExample multi-source config for Install-CopilotAssets.ps1, including optional naming transforms.
Recommended label migration order
  1. ./scripts/Update-GitHubLabels.ps1 <owner/repo>
  2. ./scripts/Convert-IssueLabels.ps1 <owner/repo> -WhatIf
  3. ./scripts/Convert-IssueLabels.ps1 <owner/repo>
  4. Review issue updates in GitHub
  5. ./scripts/Remove-DeprecatedLabels.ps1 <owner/repo>
Copilot Tooling
Runtime Copilot assets live in .github/.
Prompts
Files in .github/prompts/:
FilePurpose
pm-assistant.prompt.mdEntry-point PM assistant that routes users to the right PM prompt path.
pm-backlog-review.prompt.mdWeekly cross-repo backlog review with board state checks and prioritised recommendations.
pm-create-story.prompt.mdCreates a well-formed story issue using the standard structure and labels.
pm-daily.prompt.mdDaily focus prompt showing board snapshot, stalled items, and top priorities.
pm-issue-triage.prompt.mdTriage flow for unlabelled issues and PRs in full participation repos.
pm-iteration-plan.prompt.mdIteration planning flow that resolves stalled work and curates Up Next.
pr-address-coding-review.prompt.mdProcess for addressing PR review threads, replying, and resolving each thread.
repo-update-docs.prompt.mdRegenerates README and supports Diataxis docs planning and updates.
repo-update-from-strategy.prompt.mdPropagates changes from plan/LABEL_STRATEGY.md across repo assets.
repo-update-pinned-models.prompt.mdUpdates model pinning references and policy wording across repository files.
Agents
Files in .github/agents/:
FilePurpose
pm-assistant.agent.mdConversational PM router that interviews the user and recommends prompt sequences.
pm-backlog-management.agent.mdExecution agent for daily, triage, backlog review, and iteration planning workflows.
repo-docs-writer.agent.mdDocumentation specialist for internal README work and public Diataxis docs.
repo-label-strategy-keeper.agent.mdConsistency validator for label references against plan/LABEL_STRATEGY.md.
Skills
Files in .github/skills/:
FilePurpose
.github/skills/documentation-writer/SKILL.mdDiataxis documentation guidance and writing workflow.
.github/skills/github-issue-management/SKILL.mdCore issue/PR triage and label governance workflow.
.github/skills/github-issue-management/assets/triage-workflow.mdVisual triage flow reference.
.github/skills/github-issue-management/references/CUSTOMISATION_GUIDE.mdHow to adapt the issue-management skill for other repositories.
.github/skills/github-issue-management/references/github-labels.mdLabel taxonomy reference and decision guide.
.github/skills/github-issue-management/references/project-setup.mdBoard setup, status model, and board behaviour rules.
.github/skills/github-issue-management/scripts/Set-IssueLabelExample.ps1Example script for applying labels via gh issue edit.
Instructions
Files in .github/instructions/:
FilePurpose
label-script-update.instructions.mdRules for keeping scripts/Update-GitHubLabels.ps1 in sync with plan/LABEL_STRATEGY.md.
Setup and Prerequisites
  • GitHub CLI installed and authenticated (gh auth status).
  • PowerShell (pwsh) available to run scripts.
  • Permission to read/write issues, PRs, labels, and (where needed) project board items via GitHub APIs.
  • Access to the project board: https://github.com/users/markheydon/projects/6.
  • For legacy workflow migration scripts, permission to manage Actions secrets (PERSONAL_ACCESS_TOKEN) in target repos.
Label Strategy
Label policy is defined in plan/LABEL_STRATEGY.md.
  • Core labels: epic, story, bug
  • Board inclusion: story and bug are board units of work; epic is excluded
  • Common modifiers: priority-high, blocked, not-started, out-of-scope, feedback-required, waiting-for-details
  • Dependabot PRs are treated as story-equivalent board work in PM Mode
If you change label strategy, run /repo-update-from-strategy to propagate updates.
Public Docs
Public GitHub Pages documentation is in docs/, structured using Diataxis (tutorials, how-to guides, reference, explanation).
License
MIT - see LICENSE.
Last updated: 2026-05-17
About
Some standard workflow stuff I use.
markheydon.me.uk/github-workflows/
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Sponsor this project
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
GitHub Workflows and Copilot PM Automation
This repository is a solo developer project management toolkit for working across multiple GitHub repositories. It centralises reusable automation patterns, Copilot prompts and agents, and label governance so issue and PR curation stays consistent with less manual admin.
Purpose and Context
  • Keep cross-repo work visible so older repositories do not quietly go stale.
  • Keep the project board as the single pane of glass for committed work.
  • Use plan/LABEL_STRATEGY.md as the single source of truth for label names, colours, and board rules.
  • Use Copilot PM prompts and scripts to enforce consistency with minimal overhead.
For strategy and intent, start with plan/GOALS.md and plan/OPERATING_MODEL.md.
GitHub Actions Workflows
Files in .github/workflows/ (excluding trigger-* workflows):
FilePurpose
powershell-validate.ymlRuns PSScriptAnalyzer against scripts/ on pushes/PRs to main, plus manual dispatch support.
Reuse in other repositories
There are currently no workflow_call reusable workflows in this repository. Current reuse patterns are:
  • Copy or adapt workflow YAML into target repositories.
  • Use migration and audit scripts in scripts/ for repo fleet rollout where relevant.
Scripts
Files in scripts/:
FilePurpose
Convert-IssueLabels.ps1Converts deprecated labels on issues to the active label taxonomy from plan/LABEL_STRATEGY.md (-WhatIf supported).
Export-OssSuitabilityAudit.ps1Audits OSS-readiness assets for one repo or across eligible repos, including repo-local .github/FUNDING.yml baseline matching; exports CSV and optional Markdown.
Export-PatExists.ps1Audits repos for workflow references to PERSONAL_ACCESS_TOKEN and reports whether that secret exists.
Export-WorkflowAudit.ps1Audits repositories for expected vs legacy project-workflow files and exports results to CSV.
Import-Workflow.ps1Bulk-import helper that opens PRs to add the legacy project workflow trigger file where missing.
Install-CopilotAssets.ps1Installs agents, prompts, skills, and instructions into a target repo from one or more configured source repos.
Install-ProjectBootstrap.ps1Copies root project templates, then runs Install-CopilotAssets.ps1 for .github asset bootstrap.
Migrate-Workflows.ps1Batch migration helper driven by workflow audit CSV; can remove legacy files and open migration PRs.
Remove-DeprecatedLabels.ps1Deletes deprecated labels after issue relabelling is complete.
Remove-ProjectWorkflow.ps1Removes legacy add-to-personal-project.yml and deletes the PERSONAL_ACCESS_TOKEN Actions secret across repos.
Update-GitHubLabels.ps1Upserts repository labels from plan/LABEL_STRATEGY.md.
copilot-assets.example.jsonExample multi-source config for Install-CopilotAssets.ps1, including optional naming transforms.
Recommended label migration order
  1. ./scripts/Update-GitHubLabels.ps1 <owner/repo>
  2. ./scripts/Convert-IssueLabels.ps1 <owner/repo> -WhatIf
  3. ./scripts/Convert-IssueLabels.ps1 <owner/repo>
  4. Review issue updates in GitHub
  5. ./scripts/Remove-DeprecatedLabels.ps1 <owner/repo>
Copilot Tooling
Runtime Copilot assets live in .github/.
Prompts
Files in .github/prompts/:
FilePurpose
pm-assistant.prompt.mdEntry-point PM assistant that routes users to the right PM prompt path.
pm-backlog-review.prompt.mdWeekly cross-repo backlog review with board state checks and prioritised recommendations.
pm-create-story.prompt.mdCreates a well-formed story issue using the standard structure and labels.
pm-daily.prompt.mdDaily focus prompt showing board snapshot, stalled items, and top priorities.
pm-issue-triage.prompt.mdTriage flow for unlabelled issues and PRs in full participation repos.
pm-iteration-plan.prompt.mdIteration planning flow that resolves stalled work and curates Up Next.
pr-address-coding-review.prompt.mdProcess for addressing PR review threads, replying, and resolving each thread.
repo-update-docs.prompt.mdRegenerates README and supports Diataxis docs planning and updates.
repo-update-from-strategy.prompt.mdPropagates changes from plan/LABEL_STRATEGY.md across repo assets.
repo-update-pinned-models.prompt.mdUpdates model pinning references and policy wording across repository files.
Agents
Files in .github/agents/:
FilePurpose
pm-assistant.agent.mdConversational PM router that interviews the user and recommends prompt sequences.
pm-backlog-management.agent.mdExecution agent for daily, triage, backlog review, and iteration planning workflows.
repo-docs-writer.agent.mdDocumentation specialist for internal README work and public Diataxis docs.
repo-label-strategy-keeper.agent.mdConsistency validator for label references against plan/LABEL_STRATEGY.md.
Skills
Files in .github/skills/:
FilePurpose
.github/skills/documentation-writer/SKILL.mdDiataxis documentation guidance and writing workflow.
.github/skills/github-issue-management/SKILL.mdCore issue/PR triage and label governance workflow.
.github/skills/github-issue-management/assets/triage-workflow.mdVisual triage flow reference.
.github/skills/github-issue-management/references/CUSTOMISATION_GUIDE.mdHow to adapt the issue-management skill for other repositories.
.github/skills/github-issue-management/references/github-labels.mdLabel taxonomy reference and decision guide.
.github/skills/github-issue-management/references/project-setup.mdBoard setup, status model, and board behaviour rules.
.github/skills/github-issue-management/scripts/Set-IssueLabelExample.ps1Example script for applying labels via gh issue edit.
Instructions
Files in .github/instructions/:
FilePurpose
label-script-update.instructions.mdRules for keeping scripts/Update-GitHubLabels.ps1 in sync with plan/LABEL_STRATEGY.md.
Setup and Prerequisites
  • GitHub CLI installed and authenticated (gh auth status).
  • PowerShell (pwsh) available to run scripts.
  • Permission to read/write issues, PRs, labels, and (where needed) project board items via GitHub APIs.
  • Access to the project board: https://github.com/users/markheydon/projects/6.
  • For legacy workflow migration scripts, permission to manage Actions secrets (PERSONAL_ACCESS_TOKEN) in target repos.
Label Strategy
Label policy is defined in plan/LABEL_STRATEGY.md.
  • Core labels: epic, story, bug
  • Board inclusion: story and bug are board units of work; epic is excluded
  • Common modifiers: priority-high, blocked, not-started, out-of-scope, feedback-required, waiting-for-details
  • Dependabot PRs are treated as story-equivalent board work in PM Mode
If you change label strategy, run /repo-update-from-strategy to propagate updates.
Public Docs
Public GitHub Pages documentation is in docs/, structured using Diataxis (tutorials, how-to guides, reference, explanation).
License
MIT - see LICENSE.
Last updated: 2026-05-17
About
Some standard workflow stuff I use.
markheydon.me.uk/github-workflows/
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Sponsor this project
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
BranchesTags
Repository files navigation
GitHub Workflows and Copilot PM Automation
This repository is a solo developer project management toolkit for working across multiple GitHub repositories. It centralises reusable automation patterns, Copilot prompts and agents, and label governance so issue and PR curation stays consistent with less manual admin.
Purpose and Context
  • Keep cross-repo work visible so older repositories do not quietly go stale.
  • Keep the project board as the single pane of glass for committed work.
  • Use plan/LABEL_STRATEGY.md as the single source of truth for label names, colours, and board rules.
  • Use Copilot PM prompts and scripts to enforce consistency with minimal overhead.
For strategy and intent, start with plan/GOALS.md and plan/OPERATING_MODEL.md.
GitHub Actions Workflows
Files in .github/workflows/ (excluding trigger-* workflows):
FilePurpose
powershell-validate.ymlRuns PSScriptAnalyzer against scripts/ on pushes/PRs to main, plus manual dispatch support.
Reuse in other repositories
There are currently no workflow_call reusable workflows in this repository. Current reuse patterns are:
  • Copy or adapt workflow YAML into target repositories.
  • Use migration and audit scripts in scripts/ for repo fleet rollout where relevant.
Scripts
Files in scripts/:
FilePurpose
Convert-IssueLabels.ps1Converts deprecated labels on issues to the active label taxonomy from plan/LABEL_STRATEGY.md (-WhatIf supported).
Export-OssSuitabilityAudit.ps1Audits OSS-readiness assets for one repo or across eligible repos, including repo-local .github/FUNDING.yml baseline matching; exports CSV and optional Markdown.
Export-PatExists.ps1Audits repos for workflow references to PERSONAL_ACCESS_TOKEN and reports whether that secret exists.
Export-WorkflowAudit.ps1Audits repositories for expected vs legacy project-workflow files and exports results to CSV.
Import-Workflow.ps1Bulk-import helper that opens PRs to add the legacy project workflow trigger file where missing.
Install-CopilotAssets.ps1Installs agents, prompts, skills, and instructions into a target repo from one or more configured source repos.
Install-ProjectBootstrap.ps1Copies root project templates, then runs Install-CopilotAssets.ps1 for .github asset bootstrap.
Migrate-Workflows.ps1Batch migration helper driven by workflow audit CSV; can remove legacy files and open migration PRs.
Remove-DeprecatedLabels.ps1Deletes deprecated labels after issue relabelling is complete.
Remove-ProjectWorkflow.ps1Removes legacy add-to-personal-project.yml and deletes the PERSONAL_ACCESS_TOKEN Actions secret across repos.
Update-GitHubLabels.ps1Upserts repository labels from plan/LABEL_STRATEGY.md.
copilot-assets.example.jsonExample multi-source config for Install-CopilotAssets.ps1, including optional naming transforms.
Recommended label migration order
  1. ./scripts/Update-GitHubLabels.ps1 <owner/repo>
  2. ./scripts/Convert-IssueLabels.ps1 <owner/repo> -WhatIf
  3. ./scripts/Convert-IssueLabels.ps1 <owner/repo>
  4. Review issue updates in GitHub
  5. ./scripts/Remove-DeprecatedLabels.ps1 <owner/repo>
Copilot Tooling
Runtime Copilot assets live in .github/.
Prompts
Files in .github/prompts/:
FilePurpose
pm-assistant.prompt.mdEntry-point PM assistant that routes users to the right PM prompt path.
pm-backlog-review.prompt.mdWeekly cross-repo backlog review with board state checks and prioritised recommendations.
pm-create-story.prompt.mdCreates a well-formed story issue using the standard structure and labels.
pm-daily.prompt.mdDaily focus prompt showing board snapshot, stalled items, and top priorities.
pm-issue-triage.prompt.mdTriage flow for unlabelled issues and PRs in full participation repos.
pm-iteration-plan.prompt.mdIteration planning flow that resolves stalled work and curates Up Next.
pr-address-coding-review.prompt.mdProcess for addressing PR review threads, replying, and resolving each thread.
repo-update-docs.prompt.mdRegenerates README and supports Diataxis docs planning and updates.
repo-update-from-strategy.prompt.mdPropagates changes from plan/LABEL_STRATEGY.md across repo assets.
repo-update-pinned-models.prompt.mdUpdates model pinning references and policy wording across repository files.
Agents
Files in .github/agents/:
FilePurpose
pm-assistant.agent.mdConversational PM router that interviews the user and recommends prompt sequences.
pm-backlog-management.agent.mdExecution agent for daily, triage, backlog review, and iteration planning workflows.
repo-docs-writer.agent.mdDocumentation specialist for internal README work and public Diataxis docs.
repo-label-strategy-keeper.agent.mdConsistency validator for label references against plan/LABEL_STRATEGY.md.
Skills
Files in .github/skills/:
FilePurpose
.github/skills/documentation-writer/SKILL.mdDiataxis documentation guidance and writing workflow.
.github/skills/github-issue-management/SKILL.mdCore issue/PR triage and label governance workflow.
.github/skills/github-issue-management/assets/triage-workflow.mdVisual triage flow reference.
.github/skills/github-issue-management/references/CUSTOMISATION_GUIDE.mdHow to adapt the issue-management skill for other repositories.
.github/skills/github-issue-management/references/github-labels.mdLabel taxonomy reference and decision guide.
.github/skills/github-issue-management/references/project-setup.mdBoard setup, status model, and board behaviour rules.
.github/skills/github-issue-management/scripts/Set-IssueLabelExample.ps1Example script for applying labels via gh issue edit.
Instructions
Files in .github/instructions/:
FilePurpose
label-script-update.instructions.mdRules for keeping scripts/Update-GitHubLabels.ps1 in sync with plan/LABEL_STRATEGY.md.
Setup and Prerequisites
  • GitHub CLI installed and authenticated (gh auth status).
  • PowerShell (pwsh) available to run scripts.
  • Permission to read/write issues, PRs, labels, and (where needed) project board items via GitHub APIs.
  • Access to the project board: https://github.com/users/markheydon/projects/6.
  • For legacy workflow migration scripts, permission to manage Actions secrets (PERSONAL_ACCESS_TOKEN) in target repos.
Label Strategy
Label policy is defined in plan/LABEL_STRATEGY.md.
  • Core labels: epic, story, bug
  • Board inclusion: story and bug are board units of work; epic is excluded
  • Common modifiers: priority-high, blocked, not-started, out-of-scope, feedback-required, waiting-for-details
  • Dependabot PRs are treated as story-equivalent board work in PM Mode
If you change label strategy, run /repo-update-from-strategy to propagate updates.
Public Docs
Public GitHub Pages documentation is in docs/, structured using Diataxis (tutorials, how-to guides, reference, explanation).
License
MIT - see LICENSE.
Last updated: 2026-05-17
About
Some standard workflow stuff I use.
markheydon.me.uk/github-workflows/
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Sponsor this project
Used by
Contributors
Languages

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Universal Dark Mode - works on any site
(function() {
var enabled = true;
function applyDarkMode() {
if (!enabled) return;
// Create style element if it doesn't exist
var style = document.getElementById('universal-dark-mode-style');
if (!style) {
style = document.createElement('style');
style.id = 'universal-dark-mode-style';
document.head.appendChild(style);
}
// Dark mode CSS - inverts colors but preserves images/video
style.textContent = '
/* Invert everything except media */
html {
filter: invert(1) hue-rotate(180deg) !important;
background: #1a1a2e !important;
}
/* Restore images, videos, iframes, canvas */
img, video, iframe, canvas, svg, picture, [style*="background-image"] {
filter: invert(1) hue-rotate(180deg) !important;
}
/* Preserve specific elements that should not be inverted */
.no-dark-mode, .no-dark-mode *,
[data-theme="light"], [data-theme="light"],
.ace_editor, .ace_editor *,
.CodeMirror, .CodeMirror *,
.monaco-editor, .monaco-editor *,
.markdown-body pre, .markdown-body pre *,
.highlight, .highlight *,
pre code, pre code * {
filter: none !important;
}
/* Fix common UI elements */
.modal, .popup, .dropdown-menu, .tooltip, .popover {
filter: invert(1) hue-rotate(180deg) !important;
background: #2d2d44 !important;
border-color: #444 !important;
}
/* Scrollbars */
::-webkit-scrollbar { background: #1a1a2e !important; }
::-webkit-scrollbar-thumb { background: #444 !important; }
::-webkit-scrollbar-thumb:hover { background: #555 !important; }
/* Selection */
::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
';
}
function removeDarkMode() {
var style = document.getElementById('universal-dark-mode-style');
if (style) style.remove();
}
// Toggle with Alt+Shift+D
document.addEventListener('keydown', function(e) {
if (e.altKey && e.shiftKey && e.key === 'D') {
e.preventDefault();
enabled = !enabled;
if (enabled) {
applyDarkMode();
console.log('[Universal Dark Mode] Enabled');
} else {
removeDarkMode();
console.log('[Universal Dark Mode] Disabled');
}
}
});
// Apply on load
applyDarkMode();
// Re-apply on dynamic content
var observer = new MutationObserver(function(mutations) {
if (enabled && !document.getElementById('universal-dark-mode-style')) {
applyDarkMode();
}
});
observer.observe(document.head, { childList: true });
console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');
})();
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
BranchesTags
Repository files navigation
GitHub Workflows and Copilot PM Automation
This repository is a solo developer project management toolkit for working across multiple GitHub repositories. It centralises reusable automation patterns, Copilot prompts and agents, and label governance so issue and PR curation stays consistent with less manual admin.
Purpose and Context
  • Keep cross-repo work visible so older repositories do not quietly go stale.
  • Keep the project board as the single pane of glass for committed work.
  • Use plan/LABEL_STRATEGY.md as the single source of truth for label names, colours, and board rules.
  • Use Copilot PM prompts and scripts to enforce consistency with minimal overhead.
For strategy and intent, start with plan/GOALS.md and plan/OPERATING_MODEL.md.
GitHub Actions Workflows
Files in .github/workflows/ (excluding trigger-* workflows):
FilePurpose
powershell-validate.ymlRuns PSScriptAnalyzer against scripts/ on pushes/PRs to main, plus manual dispatch support.
Reuse in other repositories
There are currently no workflow_call reusable workflows in this repository. Current reuse patterns are:
  • Copy or adapt workflow YAML into target repositories.
  • Use migration and audit scripts in scripts/ for repo fleet rollout where relevant.
Scripts
Files in scripts/:
FilePurpose
Convert-IssueLabels.ps1Converts deprecated labels on issues to the active label taxonomy from plan/LABEL_STRATEGY.md (-WhatIf supported).
Export-OssSuitabilityAudit.ps1Audits OSS-readiness assets for one repo or across eligible repos, including repo-local .github/FUNDING.yml baseline matching; exports CSV and optional Markdown.
Export-PatExists.ps1Audits repos for workflow references to PERSONAL_ACCESS_TOKEN and reports whether that secret exists.
Export-WorkflowAudit.ps1Audits repositories for expected vs legacy project-workflow files and exports results to CSV.
Import-Workflow.ps1Bulk-import helper that opens PRs to add the legacy project workflow trigger file where missing.
Install-CopilotAssets.ps1Installs agents, prompts, skills, and instructions into a target repo from one or more configured source repos.
Install-ProjectBootstrap.ps1Copies root project templates, then runs Install-CopilotAssets.ps1 for .github asset bootstrap.
Migrate-Workflows.ps1Batch migration helper driven by workflow audit CSV; can remove legacy files and open migration PRs.
Remove-DeprecatedLabels.ps1Deletes deprecated labels after issue relabelling is complete.
Remove-ProjectWorkflow.ps1Removes legacy add-to-personal-project.yml and deletes the PERSONAL_ACCESS_TOKEN Actions secret across repos.
Update-GitHubLabels.ps1Upserts repository labels from plan/LABEL_STRATEGY.md.
copilot-assets.example.jsonExample multi-source config for Install-CopilotAssets.ps1, including optional naming transforms.
Recommended label migration order
  1. ./scripts/Update-GitHubLabels.ps1 <owner/repo>
  2. ./scripts/Convert-IssueLabels.ps1 <owner/repo> -WhatIf
  3. ./scripts/Convert-IssueLabels.ps1 <owner/repo>
  4. Review issue updates in GitHub
  5. ./scripts/Remove-DeprecatedLabels.ps1 <owner/repo>
Copilot Tooling
Runtime Copilot assets live in .github/.
Prompts
Files in .github/prompts/:
FilePurpose
pm-assistant.prompt.mdEntry-point PM assistant that routes users to the right PM prompt path.
pm-backlog-review.prompt.mdWeekly cross-repo backlog review with board state checks and prioritised recommendations.
pm-create-story.prompt.mdCreates a well-formed story issue using the standard structure and labels.
pm-daily.prompt.mdDaily focus prompt showing board snapshot, stalled items, and top priorities.
pm-issue-triage.prompt.mdTriage flow for unlabelled issues and PRs in full participation repos.
pm-iteration-plan.prompt.mdIteration planning flow that resolves stalled work and curates Up Next.
pr-address-coding-review.prompt.mdProcess for addressing PR review threads, replying, and resolving each thread.
repo-update-docs.prompt.mdRegenerates README and supports Diataxis docs planning and updates.
repo-update-from-strategy.prompt.mdPropagates changes from plan/LABEL_STRATEGY.md across repo assets.
repo-update-pinned-models.prompt.mdUpdates model pinning references and policy wording across repository files.
Agents
Files in .github/agents/:
FilePurpose
pm-assistant.agent.mdConversational PM router that interviews the user and recommends prompt sequences.
pm-backlog-management.agent.mdExecution agent for daily, triage, backlog review, and iteration planning workflows.
repo-docs-writer.agent.mdDocumentation specialist for internal README work and public Diataxis docs.
repo-label-strategy-keeper.agent.mdConsistency validator for label references against plan/LABEL_STRATEGY.md.
Skills
Files in .github/skills/:
FilePurpose
.github/skills/documentation-writer/SKILL.mdDiataxis documentation guidance and writing workflow.
.github/skills/github-issue-management/SKILL.mdCore issue/PR triage and label governance workflow.
.github/skills/github-issue-management/assets/triage-workflow.mdVisual triage flow reference.
.github/skills/github-issue-management/references/CUSTOMISATION_GUIDE.mdHow to adapt the issue-management skill for other repositories.
.github/skills/github-issue-management/references/github-labels.mdLabel taxonomy reference and decision guide.
.github/skills/github-issue-management/references/project-setup.mdBoard setup, status model, and board behaviour rules.
.github/skills/github-issue-management/scripts/Set-IssueLabelExample.ps1Example script for applying labels via gh issue edit.
Instructions
Files in .github/instructions/:
FilePurpose
label-script-update.instructions.mdRules for keeping scripts/Update-GitHubLabels.ps1 in sync with plan/LABEL_STRATEGY.md.
Setup and Prerequisites
  • GitHub CLI installed and authenticated (gh auth status).
  • PowerShell (pwsh) available to run scripts.
  • Permission to read/write issues, PRs, labels, and (where needed) project board items via GitHub APIs.
  • Access to the project board: https://github.com/users/markheydon/projects/6.
  • For legacy workflow migration scripts, permission to manage Actions secrets (PERSONAL_ACCESS_TOKEN) in target repos.
Label Strategy
Label policy is defined in plan/LABEL_STRATEGY.md.
  • Core labels: epic, story, bug
  • Board inclusion: story and bug are board units of work; epic is excluded
  • Common modifiers: priority-high, blocked, not-started, out-of-scope, feedback-required, waiting-for-details
  • Dependabot PRs are treated as story-equivalent board work in PM Mode
If you change label strategy, run /repo-update-from-strategy to propagate updates.
Public Docs
Public GitHub Pages documentation is in docs/, structured using Diataxis (tutorials, how-to guides, reference, explanation).
License
MIT - see LICENSE.
Last updated: 2026-05-17
About
Some standard workflow stuff I use.
markheydon.me.uk/github-workflows/
Resources
Readme
MIT license
Code of conduct
Code of conduct
Contributing
Contributing
Security policy
Security policy
Activity
Stars
1 star
Watchers
1 watching
Forks
0 forks
Report repository
Sponsor this project
Used by
Contributors
Languages