A developer productivity toolkit for 4PS teams working with Azure DevOps.
Features
Instruction File Sync
Keep your team's Copilot instruction files in a central Azure DevOps repository. The extension automatically pulls them into every developer's workspace on startup, ensuring everyone works with the latest coding standards and guidelines.
- Syncs files on VS Code startup (configurable)
- Preserves the folder structure from the source repository
- Configurable file patterns and source paths
- Files are written to
.github/instructions/ where Copilot Chat picks them up as context
Pull Request Creation
Made improvements to an instruction file locally? Push your changes back to Azure DevOps as a pull request without leaving VS Code.
- Detects new and modified files automatically
- Creates a branch, commits changes, and opens a PR in one step
- Provides a direct link to review the PR in your browser
Persona-Based Extension Installer
Install a curated set of VS Code extensions and MCP servers based on your role. Select your persona from a list and the toolkit sets everything up for you.
| Persona |
Extensions |
MCP Servers |
| AL Developer |
BC Code Intelligence, BC Telemetry Buddy |
Serena, Microsoft Docs, Atlassian, Azure DevOps |
| App Developer |
— |
Microsoft Docs, Atlassian, Azure DevOps |
| Web Developer |
— |
Angular CLI, CSS, Microsoft Docs, Atlassian, Azure DevOps |
| QA Engineer |
Mermaid Preview, BC Code Intelligence |
Microsoft Docs, Atlassian, Azure DevOps |
MCP servers are configured in .vscode/mcp.json in your workspace, merging with any existing configuration.
Microsoft SSO Authentication
No Personal Access Tokens needed. The extension uses VS Code's built-in Microsoft authentication provider, so you sign in with your regular Azure/Microsoft account.
Getting Started
1. Install
Install the .vsix file in VS Code:
code --install-extension 4ps-dev-toolkit-1.0.0.vsix
Open VS Code Settings (Ctrl+,) and search for Instruction File Sync, or add to your settings.json:
{
"instructionFileSync.organization": "4ps",
"instructionFileSync.project": "YourProject",
"instructionFileSync.repository": "YourRepo"
}
The extension syncs automatically on startup. You'll be prompted to sign in with your Microsoft account on first use.
3. Use
Open the Command Palette (Ctrl+Shift+P):
| Command |
Description |
4PS: Sync Instruction Files from Azure DevOps |
Pull the latest instruction files |
4PS: Create Pull Request for Instruction Changes |
Push local changes back as a PR |
4PS: Install Extensions for Persona |
Install recommended extensions for your role |
Settings
| Setting |
Default |
Description |
instructionFileSync.organization |
"" |
Azure DevOps organization name |
instructionFileSync.project |
"" |
Azure DevOps project name |
instructionFileSync.repository |
"" |
Azure DevOps repository name |
instructionFileSync.branch |
"master" |
Branch to sync from |
instructionFileSync.sourcePath |
"/" |
Repo path to sync files from |
instructionFileSync.targetPath |
".github/instructions" |
Local workspace path to write files to |
instructionFileSync.syncOnActivation |
true |
Sync automatically when VS Code starts |
instructionFileSync.filePatterns |
["*.md"] |
Glob patterns for files to sync |
Requirements
- VS Code 1.99 or later
- Access to an Azure DevOps Git repository
- A Microsoft/Azure account with permissions to the target repository
License
MIT
