workspace-architect 1.8.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,15 @@
1
+ ISC License
2
+
3
+ Copyright (c) 2025 Adam Chubbuck
4
+
5
+ Permission to use, copy, modify, and/or distribute this software for any
6
+ purpose with or without fee is hereby granted, provided that the above
7
+ copyright notice and this permission notice appear in all copies.
8
+
9
+ THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10
+ WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11
+ MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12
+ ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13
+ WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14
+ ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15
+ OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
package/README.md CHANGED
@@ -1,12 +1,25 @@
1
1
  # Workspace Architect
2
2
 
3
3
  [![npm version](https://img.shields.io/npm/v/workspace-architect.svg)](https://www.npmjs.com/package/workspace-architect)
4
+ [![npm downloads](https://img.shields.io/npm/dm/workspace-architect.svg)](https://www.npmjs.com/package/workspace-architect)
4
5
  [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
6
+ [![GitHub stars](https://img.shields.io/github/stars/archubbuck/workspace-architect.svg)](https://github.com/archubbuck/workspace-architect/stargazers)
7
+ [![GitHub issues](https://img.shields.io/github/issues/archubbuck/workspace-architect.svg)](https://github.com/archubbuck/workspace-architect/issues)
5
8
 
6
9
  > A comprehensive library of specialized AI agents and personas for GitHub Copilot, ranging from architectural planning and specific tech stacks to advanced cognitive reasoning models.
7
10
 
8
11
  Workspace Architect is a zero-friction CLI tool that provides curated collections of specialized agents, instructions, and prompts to supercharge your GitHub Copilot experience.
9
12
 
13
+ ## Why Workspace Architect?
14
+
15
+ **Maximize GitHub Copilot's Potential** - GitHub Copilot is powerful, but it's even better with context. Workspace Architect provides 400+ expert-crafted agents, instructions, and prompts that give Copilot the specialized knowledge it needs for your specific tech stack and domain.
16
+
17
+ **Save Time, Start Faster** - Instead of crafting custom instructions from scratch, instantly download battle-tested configurations for React, Azure, DevOps, AI Engineering, and dozens of other domains. Get productive in seconds with `npx workspace-architect`.
18
+
19
+ **Stay Current** - Our collections are automatically synced from trusted upstream sources like GitHub's [awesome-copilot](https://github.com/github/awesome-copilot) and Anthropic's [skills repository](https://github.com/anthropics/skills), ensuring you always have access to the latest and greatest community contributions.
20
+
21
+ **Universal Compatibility** - Works with GitHub Copilot, Claude, and other AI assistants. Simple markdown files mean no vendor lock-in, no complex setup, and compatibility across your entire development workflow.
22
+
10
23
  ## Features
11
24
 
12
25
  - 🎯 **Specialized Agents**: Pre-built personas like "Azure Architect", "React Expert", and more
@@ -45,17 +58,17 @@ npx wsa list
45
58
  Download a collection for web development:
46
59
 
47
60
  ```bash
48
- npx workspace-architect download collections:web-frontend-development
61
+ npx workspace-architect download collections web-frontend-development
49
62
  # or
50
- npx wsa download collections:web-frontend-development
63
+ npx wsa download collections web-frontend-development
51
64
  ```
52
65
 
53
66
  Download a specific agent:
54
67
 
55
68
  ```bash
56
- npx workspace-architect download agents:azure-architect
69
+ npx workspace-architect download agents azure-architect
57
70
  # or
58
- npx wsa download agents:azure-architect
71
+ npx wsa download agents azure-architect
59
72
  ```
60
73
 
61
74
  ## Usage
@@ -82,22 +95,22 @@ npx wsa list collections
82
95
  Download assets to your project (default location: `.github/<type>/`):
83
96
 
84
97
  ```bash
85
- npx workspace-architect download <type>:<name>
98
+ npx workspace-architect download <type> <name>
86
99
  # or
87
- npx wsa download <type>:<name>
100
+ npx wsa download <type> <name>
88
101
  ```
89
102
 
90
103
  **Examples:**
91
104
 
92
105
  ```bash
93
106
  # Download an instruction
94
- npx wsa download instructions:reactjs
107
+ npx wsa download instructions reactjs
95
108
 
96
109
  # Download an agent
97
- npx wsa download agents:planner
110
+ npx wsa download agents planner
98
111
 
99
112
  # Download a complete collection
100
- npx wsa download collections:devops-essentials
113
+ npx wsa download collections devops-essentials
101
114
  ```
102
115
 
103
116
  ### CLI Options
@@ -132,7 +145,7 @@ Skills follow the [open Agent Skills specification](https://agentskills.io/) and
132
145
  **Example:**
133
146
  ```bash
134
147
  # Download a Skill
135
- npx workspace-architect download skills:example-planner
148
+ npx workspace-architect download skills example-planner
136
149
 
137
150
  # List all Skills
138
151
  npx workspace-architect list skills
@@ -260,3 +273,4 @@ ISC
260
273
  - [GitHub Repository](https://github.com/archubbuck/workspace-architect)
261
274
  - [Issue Tracker](https://github.com/archubbuck/workspace-architect/issues)
262
275
  - [Roadmap](ROADMAP.md)
276
+ - [Release Workflows](docs/release-workflows.md) - Documentation for maintainers on release and deployment
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "version": "1.1.0",
3
- "generatedAt": "2026-01-08T02:45:12.982Z",
3
+ "generatedAt": "2026-01-09T17:11:15.584Z",
4
4
  "assets": {
5
5
  "agents:4.1-Beast": {
6
6
  "path": "assets/agents/4.1-Beast.agent.md",
@@ -212,6 +212,12 @@
212
212
  "title": "demonstrate-understanding",
213
213
  "type": "agents"
214
214
  },
215
+ "agents:devops-expert": {
216
+ "path": "assets/agents/devops-expert.agent.md",
217
+ "description": "DevOps specialist following the infinity loop principle (Plan → Code → Build → Test → Release → Deploy → Operate → Monitor) with focus on automation, collaboration, and continuous improvement",
218
+ "title": "devops-expert",
219
+ "type": "agents"
220
+ },
215
221
  "agents:diffblue-cover": {
216
222
  "path": "assets/agents/diffblue-cover.agent.md",
217
223
  "description": "Expert agent for creating unit tests for java applications using Diffblue Cover.",
@@ -290,6 +296,12 @@
290
296
  "title": "gilfoyle",
291
297
  "type": "agents"
292
298
  },
299
+ "agents:github-actions-expert": {
300
+ "path": "assets/agents/github-actions-expert.agent.md",
301
+ "description": "GitHub Actions specialist focused on secure CI/CD workflows, action pinning, OIDC authentication, permissions least privilege, and supply-chain security",
302
+ "title": "github-actions-expert",
303
+ "type": "agents"
304
+ },
293
305
  "agents:go-mcp-expert": {
294
306
  "path": "assets/agents/go-mcp-expert.agent.md",
295
307
  "description": "Expert assistant for building Model Context Protocol (MCP) servers in Go using the official SDK.",
@@ -476,6 +488,12 @@
476
488
  "title": "planner",
477
489
  "type": "agents"
478
490
  },
491
+ "agents:platform-sre-kubernetes": {
492
+ "path": "assets/agents/platform-sre-kubernetes.agent.md",
493
+ "description": "SRE-focused Kubernetes specialist prioritizing reliability, safe rollouts/rollbacks, security defaults, and operational verification for production-grade deployments",
494
+ "title": "platform-sre-kubernetes",
495
+ "type": "agents"
496
+ },
479
497
  "agents:playwright-tester": {
480
498
  "path": "assets/agents/playwright-tester.agent.md",
481
499
  "description": "Testing mode for Playwright tests",
@@ -734,6 +752,12 @@
734
752
  "title": "terraform-azure-planning",
735
753
  "type": "agents"
736
754
  },
755
+ "agents:terraform-iac-reviewer": {
756
+ "path": "assets/agents/terraform-iac-reviewer.agent.md",
757
+ "description": "Terraform-focused agent that reviews and creates safer IaC changes with emphasis on state safety, least privilege, module patterns, drift detection, and plan/apply discipline",
758
+ "title": "terraform-iac-reviewer",
759
+ "type": "agents"
760
+ },
737
761
  "agents:terraform": {
738
762
  "path": "assets/agents/terraform.agent.md",
739
763
  "description": "Terraform infrastructure specialist with automated HCP Terraform workflows. Leverages Terraform MCP server for registry integration, workspace management, and run orchestration. Generates compliant code using latest provider/module versions, manages private registries, automates variable sets, and orchestrates infrastructure deployments with proper validation and security practices.",
@@ -1184,6 +1208,12 @@
1184
1208
  "title": "kubernetes-deployment-best-practices",
1185
1209
  "type": "instructions"
1186
1210
  },
1211
+ "instructions:kubernetes-manifests": {
1212
+ "path": "assets/instructions/kubernetes-manifests.instructions.md",
1213
+ "description": "Best practices for Kubernetes YAML manifests including labeling conventions, security contexts, pod security, resource management, probes, and validation commands",
1214
+ "title": "kubernetes-manifests",
1215
+ "type": "instructions"
1216
+ },
1187
1217
  "instructions:langchain-python": {
1188
1218
  "path": "assets/instructions/langchain-python.instructions.md",
1189
1219
  "description": "Instructions for using LangChain with Python",
@@ -1640,6 +1670,12 @@
1640
1670
  "title": "typescript-mcp-server",
1641
1671
  "type": "instructions"
1642
1672
  },
1673
+ "instructions:typespec-m365-copilot": {
1674
+ "path": "assets/instructions/typespec-m365-copilot.instructions.md",
1675
+ "description": "Guidelines and best practices for building TypeSpec-based declarative agents and API plugins for Microsoft 365 Copilot",
1676
+ "title": "typespec-m365-copilot",
1677
+ "type": "instructions"
1678
+ },
1643
1679
  "instructions:update-code-from-shorthand": {
1644
1680
  "path": "assets/instructions/update-code-from-shorthand.instructions.md",
1645
1681
  "description": "Shorthand code will be in the file provided from the prompt or raw data in the prompt, and will be used to update the code file when the prompt has the text `UPDATE CODE FROM SHORTHAND`.",
@@ -1958,6 +1994,12 @@
1958
1994
  "title": "declarative-agents",
1959
1995
  "type": "prompts"
1960
1996
  },
1997
+ "prompts:devops-rollout-plan": {
1998
+ "path": "assets/prompts/devops-rollout-plan.prompt.md",
1999
+ "description": "Generate comprehensive rollout plans with preflight checks, step-by-step deployment, verification signals, rollback procedures, and communication plans for infrastructure and application changes",
2000
+ "title": "devops-rollout-plan",
2001
+ "type": "prompts"
2002
+ },
1961
2003
  "prompts:documentation-writer": {
1962
2004
  "path": "assets/prompts/documentation-writer.prompt.md",
1963
2005
  "description": "Diátaxis Documentation Expert. An expert technical writer specializing in creating high-quality software documentation, guided by the principles and structure of the Diátaxis technical documentation authoring framework.",
@@ -2378,6 +2420,24 @@
2378
2420
  "title": "typescript-mcp-server-generator",
2379
2421
  "type": "prompts"
2380
2422
  },
2423
+ "prompts:typespec-api-operations": {
2424
+ "path": "assets/prompts/typespec-api-operations.prompt.md",
2425
+ "description": "Add GET, POST, PATCH, and DELETE operations to a TypeSpec API plugin with proper routing, parameters, and adaptive cards",
2426
+ "title": "typespec-api-operations",
2427
+ "type": "prompts"
2428
+ },
2429
+ "prompts:typespec-create-agent": {
2430
+ "path": "assets/prompts/typespec-create-agent.prompt.md",
2431
+ "description": "Generate a complete TypeSpec declarative agent with instructions, capabilities, and conversation starters for Microsoft 365 Copilot",
2432
+ "title": "typespec-create-agent",
2433
+ "type": "prompts"
2434
+ },
2435
+ "prompts:typespec-create-api-plugin": {
2436
+ "path": "assets/prompts/typespec-create-api-plugin.prompt.md",
2437
+ "description": "Generate a TypeSpec API plugin with REST operations, authentication, and Adaptive Cards for Microsoft 365 Copilot",
2438
+ "title": "typespec-create-api-plugin",
2439
+ "type": "prompts"
2440
+ },
2381
2441
  "prompts:update-avm-modules-in-bicep": {
2382
2442
  "path": "assets/prompts/update-avm-modules-in-bicep.prompt.md",
2383
2443
  "description": "Update Azure Verified Modules (AVM) to latest versions in Bicep files.",
package/bin/cli.js CHANGED
@@ -41,14 +41,33 @@ program
41
41
  });
42
42
 
43
43
  program
44
- .command('download <id>')
45
- .description('Download an asset (format: type:name)')
44
+ .command('download <type> [name]')
45
+ .description('Download an asset by type and name')
46
46
  .option('-d, --dry-run', 'Simulate the download without writing files')
47
47
  .option('-f, --force', 'Overwrite existing files without asking')
48
48
  .option('-o, --output <path>', 'Specify the output path')
49
- .action(async (id, options) => {
49
+ .action(async (type, name, options) => {
50
50
  try {
51
- await downloadAsset(id, options);
51
+ // Support both new format (type name) and legacy format (type:name)
52
+ if (!name && type.includes(':')) {
53
+ // Legacy format: type:name - warn user to use new format
54
+ const [assetType, assetName] = type.split(':');
55
+
56
+ // Detect which command was used (workspace-architect or wsa)
57
+ const scriptPath = process.argv[1] || '';
58
+ const commandName = scriptPath.includes('/wsa') || scriptPath.endsWith('wsa') ? 'wsa' : 'workspace-architect';
59
+
60
+ console.log(chalk.yellow(`⚠️ Deprecation Warning: The format '${type}' is deprecated.`));
61
+ console.log(chalk.yellow(` Please use: npx ${commandName} download ${assetType} ${assetName}`));
62
+ console.log('');
63
+ await downloadAsset(type, options);
64
+ } else if (name) {
65
+ // New format: type name
66
+ const id = `${type}:${name}`;
67
+ await downloadAsset(id, options);
68
+ } else {
69
+ throw new Error('Invalid format. Use: download <type> <name>');
70
+ }
52
71
  } catch (error) {
53
72
  console.error(chalk.red('Error downloading asset:'), error.message);
54
73
  process.exit(1);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "workspace-architect",
3
- "version": "1.8.0",
3
+ "version": "2.0.1",
4
4
  "description": "A comprehensive library of specialized AI agents and personas for GitHub Copilot, ranging from architectural planning and specific tech stacks to advanced cognitive reasoning models.",
5
5
  "bin": {
6
6
  "workspace-architect": "./bin/cli.js",
@@ -8,7 +8,7 @@
8
8
  },
9
9
  "scripts": {
10
10
  "start:registry": "verdaccio --config verdaccio/config.yaml",
11
- "test:local": "node bin/cli.js list && node bin/cli.js download instructions:basic-setup --dry-run",
11
+ "test:local": "node bin/cli.js list && node bin/cli.js download instructions a11y --dry-run",
12
12
  "analyze": "node scripts/analyze-collections.js",
13
13
  "generate-manifest": "node scripts/generate-manifest.js",
14
14
  "prepublishOnly": "npm run generate-manifest",
@@ -29,18 +29,31 @@
29
29
  "LICENSE"
30
30
  ],
31
31
  "keywords": [
32
- "copilot",
33
- "agents",
34
- "personas",
32
+ "github-copilot",
33
+ "copilot-agents",
34
+ "ai-agents",
35
+ "copilot-instructions",
36
+ "copilot-chat",
37
+ "chatmodes",
38
+ "ai-personas",
35
39
  "prompts",
40
+ "prompt-engineering",
41
+ "developer-tools",
42
+ "cli-tool",
43
+ "npx",
44
+ "code-assistant",
36
45
  "ai-assistant",
46
+ "agentic-workflow",
47
+ "llm",
48
+ "claude-skills",
49
+ "vscode",
37
50
  "architecture",
38
- "planning",
39
- "developer-tools",
40
- "workspace-architect",
51
+ "devops",
41
52
  "react",
42
53
  "azure",
43
- "agentic-workflow"
54
+ "typescript",
55
+ "code-generation",
56
+ "productivity"
44
57
  ],
45
58
  "repository": {
46
59
  "type": "git",
@@ -50,7 +63,7 @@
50
63
  "url": "https://github.com/archubbuck/workspace-architect/issues"
51
64
  },
52
65
  "homepage": "https://github.com/archubbuck/workspace-architect#readme",
53
- "author": "",
66
+ "author": "Adam Chubbuck <adam.chubbuck@gmail.com> (https://github.com/archubbuck)",
54
67
  "license": "ISC",
55
68
  "dependencies": {
56
69
  "chalk": "^5.3.0",