claude-autopm 2.7.0 → 2.8.2
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/README.md +307 -56
- package/autopm/.claude/.env +158 -0
- package/autopm/.claude/settings.local.json +9 -0
- package/bin/autopm.js +11 -2
- package/bin/commands/epic.js +23 -3
- package/bin/commands/plugin.js +395 -0
- package/bin/commands/team.js +184 -10
- package/install/install.js +223 -4
- package/lib/cli/commands/issue.js +360 -20
- package/lib/plugins/PluginManager.js +1328 -0
- package/lib/plugins/PluginManager.old.js +400 -0
- package/lib/providers/AzureDevOpsProvider.js +575 -0
- package/lib/providers/GitHubProvider.js +475 -0
- package/lib/services/EpicService.js +1092 -3
- package/lib/services/IssueService.js +991 -0
- package/package.json +9 -1
- package/scripts/publish-plugins.sh +166 -0
- package/autopm/.claude/agents/cloud/README.md +0 -55
- package/autopm/.claude/agents/cloud/aws-cloud-architect.md +0 -521
- package/autopm/.claude/agents/cloud/azure-cloud-architect.md +0 -436
- package/autopm/.claude/agents/cloud/gcp-cloud-architect.md +0 -385
- package/autopm/.claude/agents/cloud/gcp-cloud-functions-engineer.md +0 -306
- package/autopm/.claude/agents/cloud/gemini-api-expert.md +0 -880
- package/autopm/.claude/agents/cloud/kubernetes-orchestrator.md +0 -566
- package/autopm/.claude/agents/cloud/openai-python-expert.md +0 -1087
- package/autopm/.claude/agents/cloud/terraform-infrastructure-expert.md +0 -454
- package/autopm/.claude/agents/core/agent-manager.md +0 -296
- package/autopm/.claude/agents/core/code-analyzer.md +0 -131
- package/autopm/.claude/agents/core/file-analyzer.md +0 -162
- package/autopm/.claude/agents/core/test-runner.md +0 -200
- package/autopm/.claude/agents/data/airflow-orchestration-expert.md +0 -52
- package/autopm/.claude/agents/data/kedro-pipeline-expert.md +0 -50
- package/autopm/.claude/agents/data/langgraph-workflow-expert.md +0 -520
- package/autopm/.claude/agents/databases/README.md +0 -50
- package/autopm/.claude/agents/databases/bigquery-expert.md +0 -392
- package/autopm/.claude/agents/databases/cosmosdb-expert.md +0 -368
- package/autopm/.claude/agents/databases/mongodb-expert.md +0 -398
- package/autopm/.claude/agents/databases/postgresql-expert.md +0 -321
- package/autopm/.claude/agents/databases/redis-expert.md +0 -52
- package/autopm/.claude/agents/devops/README.md +0 -52
- package/autopm/.claude/agents/devops/azure-devops-specialist.md +0 -308
- package/autopm/.claude/agents/devops/docker-containerization-expert.md +0 -298
- package/autopm/.claude/agents/devops/github-operations-specialist.md +0 -335
- package/autopm/.claude/agents/devops/mcp-context-manager.md +0 -319
- package/autopm/.claude/agents/devops/observability-engineer.md +0 -574
- package/autopm/.claude/agents/devops/ssh-operations-expert.md +0 -1093
- package/autopm/.claude/agents/devops/traefik-proxy-expert.md +0 -444
- package/autopm/.claude/agents/frameworks/README.md +0 -64
- package/autopm/.claude/agents/frameworks/e2e-test-engineer.md +0 -360
- package/autopm/.claude/agents/frameworks/nats-messaging-expert.md +0 -254
- package/autopm/.claude/agents/frameworks/react-frontend-engineer.md +0 -217
- package/autopm/.claude/agents/frameworks/react-ui-expert.md +0 -226
- package/autopm/.claude/agents/frameworks/tailwindcss-expert.md +0 -770
- package/autopm/.claude/agents/frameworks/ux-design-expert.md +0 -244
- package/autopm/.claude/agents/integration/message-queue-engineer.md +0 -794
- package/autopm/.claude/agents/languages/README.md +0 -50
- package/autopm/.claude/agents/languages/bash-scripting-expert.md +0 -541
- package/autopm/.claude/agents/languages/javascript-frontend-engineer.md +0 -197
- package/autopm/.claude/agents/languages/nodejs-backend-engineer.md +0 -226
- package/autopm/.claude/agents/languages/python-backend-engineer.md +0 -214
- package/autopm/.claude/agents/languages/python-backend-expert.md +0 -289
- package/autopm/.claude/agents/testing/frontend-testing-engineer.md +0 -395
- package/autopm/.claude/commands/ai/langgraph-workflow.md +0 -65
- package/autopm/.claude/commands/ai/openai-chat.md +0 -65
- package/autopm/.claude/commands/azure/COMMANDS.md +0 -107
- package/autopm/.claude/commands/azure/COMMAND_MAPPING.md +0 -252
- package/autopm/.claude/commands/azure/INTEGRATION_FIX.md +0 -103
- package/autopm/.claude/commands/azure/README.md +0 -246
- package/autopm/.claude/commands/azure/active-work.md +0 -198
- package/autopm/.claude/commands/azure/aliases.md +0 -143
- package/autopm/.claude/commands/azure/blocked-items.md +0 -287
- package/autopm/.claude/commands/azure/clean.md +0 -93
- package/autopm/.claude/commands/azure/docs-query.md +0 -48
- package/autopm/.claude/commands/azure/feature-decompose.md +0 -380
- package/autopm/.claude/commands/azure/feature-list.md +0 -61
- package/autopm/.claude/commands/azure/feature-new.md +0 -115
- package/autopm/.claude/commands/azure/feature-show.md +0 -205
- package/autopm/.claude/commands/azure/feature-start.md +0 -130
- package/autopm/.claude/commands/azure/fix-integration-example.md +0 -93
- package/autopm/.claude/commands/azure/help.md +0 -150
- package/autopm/.claude/commands/azure/import-us.md +0 -269
- package/autopm/.claude/commands/azure/init.md +0 -211
- package/autopm/.claude/commands/azure/next-task.md +0 -262
- package/autopm/.claude/commands/azure/search.md +0 -160
- package/autopm/.claude/commands/azure/sprint-status.md +0 -235
- package/autopm/.claude/commands/azure/standup.md +0 -260
- package/autopm/.claude/commands/azure/sync-all.md +0 -99
- package/autopm/.claude/commands/azure/task-analyze.md +0 -186
- package/autopm/.claude/commands/azure/task-close.md +0 -329
- package/autopm/.claude/commands/azure/task-edit.md +0 -145
- package/autopm/.claude/commands/azure/task-list.md +0 -263
- package/autopm/.claude/commands/azure/task-new.md +0 -84
- package/autopm/.claude/commands/azure/task-reopen.md +0 -79
- package/autopm/.claude/commands/azure/task-show.md +0 -126
- package/autopm/.claude/commands/azure/task-start.md +0 -301
- package/autopm/.claude/commands/azure/task-status.md +0 -65
- package/autopm/.claude/commands/azure/task-sync.md +0 -67
- package/autopm/.claude/commands/azure/us-edit.md +0 -164
- package/autopm/.claude/commands/azure/us-list.md +0 -202
- package/autopm/.claude/commands/azure/us-new.md +0 -265
- package/autopm/.claude/commands/azure/us-parse.md +0 -253
- package/autopm/.claude/commands/azure/us-show.md +0 -188
- package/autopm/.claude/commands/azure/us-status.md +0 -320
- package/autopm/.claude/commands/azure/validate.md +0 -86
- package/autopm/.claude/commands/azure/work-item-sync.md +0 -47
- package/autopm/.claude/commands/cloud/infra-deploy.md +0 -38
- package/autopm/.claude/commands/github/workflow-create.md +0 -42
- package/autopm/.claude/commands/infrastructure/ssh-security.md +0 -65
- package/autopm/.claude/commands/infrastructure/traefik-setup.md +0 -65
- package/autopm/.claude/commands/kubernetes/deploy.md +0 -37
- package/autopm/.claude/commands/playwright/test-scaffold.md +0 -38
- package/autopm/.claude/commands/pm/blocked.md +0 -28
- package/autopm/.claude/commands/pm/clean.md +0 -119
- package/autopm/.claude/commands/pm/context-create.md +0 -136
- package/autopm/.claude/commands/pm/context-prime.md +0 -170
- package/autopm/.claude/commands/pm/context-update.md +0 -292
- package/autopm/.claude/commands/pm/context.md +0 -28
- package/autopm/.claude/commands/pm/epic-close.md +0 -86
- package/autopm/.claude/commands/pm/epic-decompose.md +0 -370
- package/autopm/.claude/commands/pm/epic-edit.md +0 -83
- package/autopm/.claude/commands/pm/epic-list.md +0 -30
- package/autopm/.claude/commands/pm/epic-merge.md +0 -222
- package/autopm/.claude/commands/pm/epic-oneshot.md +0 -119
- package/autopm/.claude/commands/pm/epic-refresh.md +0 -119
- package/autopm/.claude/commands/pm/epic-show.md +0 -28
- package/autopm/.claude/commands/pm/epic-split.md +0 -120
- package/autopm/.claude/commands/pm/epic-start.md +0 -195
- package/autopm/.claude/commands/pm/epic-status.md +0 -28
- package/autopm/.claude/commands/pm/epic-sync-modular.md +0 -338
- package/autopm/.claude/commands/pm/epic-sync-original.md +0 -473
- package/autopm/.claude/commands/pm/epic-sync.md +0 -486
- package/autopm/.claude/commands/pm/help.md +0 -28
- package/autopm/.claude/commands/pm/import.md +0 -115
- package/autopm/.claude/commands/pm/in-progress.md +0 -28
- package/autopm/.claude/commands/pm/init.md +0 -28
- package/autopm/.claude/commands/pm/issue-analyze.md +0 -202
- package/autopm/.claude/commands/pm/issue-close.md +0 -119
- package/autopm/.claude/commands/pm/issue-edit.md +0 -93
- package/autopm/.claude/commands/pm/issue-reopen.md +0 -87
- package/autopm/.claude/commands/pm/issue-show.md +0 -41
- package/autopm/.claude/commands/pm/issue-start.md +0 -234
- package/autopm/.claude/commands/pm/issue-status.md +0 -95
- package/autopm/.claude/commands/pm/issue-sync.md +0 -411
- package/autopm/.claude/commands/pm/next.md +0 -28
- package/autopm/.claude/commands/pm/prd-edit.md +0 -82
- package/autopm/.claude/commands/pm/prd-list.md +0 -28
- package/autopm/.claude/commands/pm/prd-new.md +0 -55
- package/autopm/.claude/commands/pm/prd-parse.md +0 -42
- package/autopm/.claude/commands/pm/prd-status.md +0 -28
- package/autopm/.claude/commands/pm/search.md +0 -28
- package/autopm/.claude/commands/pm/standup.md +0 -28
- package/autopm/.claude/commands/pm/status.md +0 -28
- package/autopm/.claude/commands/pm/sync.md +0 -99
- package/autopm/.claude/commands/pm/test-reference-update.md +0 -151
- package/autopm/.claude/commands/pm/validate.md +0 -28
- package/autopm/.claude/commands/pm/what-next.md +0 -28
- package/autopm/.claude/commands/python/api-scaffold.md +0 -50
- package/autopm/.claude/commands/python/docs-query.md +0 -48
- package/autopm/.claude/commands/react/app-scaffold.md +0 -50
- package/autopm/.claude/commands/testing/prime.md +0 -314
- package/autopm/.claude/commands/testing/run.md +0 -125
- package/autopm/.claude/commands/ui/bootstrap-scaffold.md +0 -65
- package/autopm/.claude/commands/ui/tailwind-system.md +0 -64
- package/autopm/.claude/rules/ai-integration-patterns.md +0 -219
- package/autopm/.claude/rules/ci-cd-kubernetes-strategy.md +0 -25
- package/autopm/.claude/rules/database-management-strategy.md +0 -17
- package/autopm/.claude/rules/database-pipeline.md +0 -94
- package/autopm/.claude/rules/devops-troubleshooting-playbook.md +0 -450
- package/autopm/.claude/rules/docker-first-development.md +0 -404
- package/autopm/.claude/rules/infrastructure-pipeline.md +0 -128
- package/autopm/.claude/rules/performance-guidelines.md +0 -403
- package/autopm/.claude/rules/ui-development-standards.md +0 -281
- package/autopm/.claude/rules/ui-framework-rules.md +0 -151
- package/autopm/.claude/rules/ux-design-rules.md +0 -209
- package/autopm/.claude/rules/visual-testing.md +0 -223
- package/autopm/.claude/scripts/azure/README.md +0 -192
- package/autopm/.claude/scripts/azure/active-work.js +0 -524
- package/autopm/.claude/scripts/azure/active-work.sh +0 -20
- package/autopm/.claude/scripts/azure/blocked.js +0 -520
- package/autopm/.claude/scripts/azure/blocked.sh +0 -20
- package/autopm/.claude/scripts/azure/daily.js +0 -533
- package/autopm/.claude/scripts/azure/daily.sh +0 -20
- package/autopm/.claude/scripts/azure/dashboard.js +0 -970
- package/autopm/.claude/scripts/azure/dashboard.sh +0 -20
- package/autopm/.claude/scripts/azure/feature-list.js +0 -254
- package/autopm/.claude/scripts/azure/feature-list.sh +0 -20
- package/autopm/.claude/scripts/azure/feature-show.js +0 -7
- package/autopm/.claude/scripts/azure/feature-show.sh +0 -20
- package/autopm/.claude/scripts/azure/feature-status.js +0 -604
- package/autopm/.claude/scripts/azure/feature-status.sh +0 -20
- package/autopm/.claude/scripts/azure/help.js +0 -342
- package/autopm/.claude/scripts/azure/help.sh +0 -20
- package/autopm/.claude/scripts/azure/next-task.js +0 -508
- package/autopm/.claude/scripts/azure/next-task.sh +0 -20
- package/autopm/.claude/scripts/azure/search.js +0 -469
- package/autopm/.claude/scripts/azure/search.sh +0 -20
- package/autopm/.claude/scripts/azure/setup.js +0 -745
- package/autopm/.claude/scripts/azure/setup.sh +0 -20
- package/autopm/.claude/scripts/azure/sprint-report.js +0 -1012
- package/autopm/.claude/scripts/azure/sprint-report.sh +0 -20
- package/autopm/.claude/scripts/azure/sync.js +0 -563
- package/autopm/.claude/scripts/azure/sync.sh +0 -20
- package/autopm/.claude/scripts/azure/us-list.js +0 -210
- package/autopm/.claude/scripts/azure/us-list.sh +0 -20
- package/autopm/.claude/scripts/azure/us-status.js +0 -238
- package/autopm/.claude/scripts/azure/us-status.sh +0 -20
- package/autopm/.claude/scripts/azure/validate.js +0 -626
- package/autopm/.claude/scripts/azure/validate.sh +0 -20
- package/autopm/.claude/scripts/azure/wrapper-template.sh +0 -20
- package/autopm/.claude/scripts/github/dependency-tracker.js +0 -554
- package/autopm/.claude/scripts/github/dependency-validator.js +0 -545
- package/autopm/.claude/scripts/github/dependency-visualizer.js +0 -477
- package/autopm/.claude/scripts/pm/analytics.js +0 -425
- package/autopm/.claude/scripts/pm/blocked.js +0 -164
- package/autopm/.claude/scripts/pm/blocked.sh +0 -78
- package/autopm/.claude/scripts/pm/clean.js +0 -464
- package/autopm/.claude/scripts/pm/context-create.js +0 -216
- package/autopm/.claude/scripts/pm/context-prime.js +0 -335
- package/autopm/.claude/scripts/pm/context-update.js +0 -344
- package/autopm/.claude/scripts/pm/context.js +0 -338
- package/autopm/.claude/scripts/pm/epic-close.js +0 -347
- package/autopm/.claude/scripts/pm/epic-edit.js +0 -382
- package/autopm/.claude/scripts/pm/epic-list.js +0 -273
- package/autopm/.claude/scripts/pm/epic-list.sh +0 -109
- package/autopm/.claude/scripts/pm/epic-show.js +0 -291
- package/autopm/.claude/scripts/pm/epic-show.sh +0 -105
- package/autopm/.claude/scripts/pm/epic-split.js +0 -522
- package/autopm/.claude/scripts/pm/epic-start/epic-start.js +0 -183
- package/autopm/.claude/scripts/pm/epic-start/epic-start.sh +0 -94
- package/autopm/.claude/scripts/pm/epic-status.js +0 -291
- package/autopm/.claude/scripts/pm/epic-status.sh +0 -104
- package/autopm/.claude/scripts/pm/epic-sync/README.md +0 -208
- package/autopm/.claude/scripts/pm/epic-sync/create-epic-issue.sh +0 -77
- package/autopm/.claude/scripts/pm/epic-sync/create-task-issues.sh +0 -86
- package/autopm/.claude/scripts/pm/epic-sync/update-epic-file.sh +0 -79
- package/autopm/.claude/scripts/pm/epic-sync/update-references.sh +0 -89
- package/autopm/.claude/scripts/pm/epic-sync.sh +0 -137
- package/autopm/.claude/scripts/pm/help.js +0 -92
- package/autopm/.claude/scripts/pm/help.sh +0 -90
- package/autopm/.claude/scripts/pm/in-progress.js +0 -178
- package/autopm/.claude/scripts/pm/in-progress.sh +0 -93
- package/autopm/.claude/scripts/pm/init.js +0 -321
- package/autopm/.claude/scripts/pm/init.sh +0 -178
- package/autopm/.claude/scripts/pm/issue-close.js +0 -232
- package/autopm/.claude/scripts/pm/issue-edit.js +0 -310
- package/autopm/.claude/scripts/pm/issue-show.js +0 -272
- package/autopm/.claude/scripts/pm/issue-start.js +0 -181
- package/autopm/.claude/scripts/pm/issue-sync/format-comment.sh +0 -468
- package/autopm/.claude/scripts/pm/issue-sync/gather-updates.sh +0 -460
- package/autopm/.claude/scripts/pm/issue-sync/post-comment.sh +0 -330
- package/autopm/.claude/scripts/pm/issue-sync/preflight-validation.sh +0 -348
- package/autopm/.claude/scripts/pm/issue-sync/update-frontmatter.sh +0 -387
- package/autopm/.claude/scripts/pm/lib/README.md +0 -85
- package/autopm/.claude/scripts/pm/lib/epic-discovery.js +0 -119
- package/autopm/.claude/scripts/pm/lib/logger.js +0 -78
- package/autopm/.claude/scripts/pm/next.js +0 -189
- package/autopm/.claude/scripts/pm/next.sh +0 -72
- package/autopm/.claude/scripts/pm/optimize.js +0 -407
- package/autopm/.claude/scripts/pm/pr-create.js +0 -337
- package/autopm/.claude/scripts/pm/pr-list.js +0 -257
- package/autopm/.claude/scripts/pm/prd-list.js +0 -242
- package/autopm/.claude/scripts/pm/prd-list.sh +0 -103
- package/autopm/.claude/scripts/pm/prd-new.js +0 -684
- package/autopm/.claude/scripts/pm/prd-parse.js +0 -547
- package/autopm/.claude/scripts/pm/prd-status.js +0 -152
- package/autopm/.claude/scripts/pm/prd-status.sh +0 -63
- package/autopm/.claude/scripts/pm/release.js +0 -460
- package/autopm/.claude/scripts/pm/search.js +0 -192
- package/autopm/.claude/scripts/pm/search.sh +0 -89
- package/autopm/.claude/scripts/pm/standup.js +0 -362
- package/autopm/.claude/scripts/pm/standup.sh +0 -95
- package/autopm/.claude/scripts/pm/status.js +0 -148
- package/autopm/.claude/scripts/pm/status.sh +0 -59
- package/autopm/.claude/scripts/pm/sync-batch.js +0 -337
- package/autopm/.claude/scripts/pm/sync.js +0 -343
- package/autopm/.claude/scripts/pm/template-list.js +0 -141
- package/autopm/.claude/scripts/pm/template-new.js +0 -366
- package/autopm/.claude/scripts/pm/validate.js +0 -274
- package/autopm/.claude/scripts/pm/validate.sh +0 -106
- package/autopm/.claude/scripts/pm/what-next.js +0 -660
- package/bin/node/azure-feature-show.js +0 -7
|
@@ -1,65 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: langgraph-workflow
|
|
3
|
-
type: ai-workflow
|
|
4
|
-
category: ai
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# LangGraph Workflow Command
|
|
8
|
-
|
|
9
|
-
Create complex AI workflows using LangGraph with state management and multi-agent collaboration.
|
|
10
|
-
|
|
11
|
-
## Command
|
|
12
|
-
```
|
|
13
|
-
/ai:langgraph-workflow
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Purpose
|
|
17
|
-
Use the langgraph-workflow-expert agent to create sophisticated AI workflows with graph-based orchestration, state management, and conditional routing.
|
|
18
|
-
|
|
19
|
-
## Parameters
|
|
20
|
-
- `workflow_type`: Type of workflow (conversational, data-processing, multi-agent, human-in-loop)
|
|
21
|
-
- `agents`: Number and types of agents in the workflow
|
|
22
|
-
- `state_management`: State persistence (memory, database, checkpoints)
|
|
23
|
-
- `routing`: Conditional routing logic (simple, complex, ml-based)
|
|
24
|
-
|
|
25
|
-
## Agent Usage
|
|
26
|
-
```
|
|
27
|
-
Use the langgraph-workflow-expert agent to create a comprehensive LangGraph workflow system.
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
## Expected Outcome
|
|
31
|
-
- Complete LangGraph workflow implementation
|
|
32
|
-
- State schema and management
|
|
33
|
-
- Multi-agent coordination patterns
|
|
34
|
-
- Conditional routing and decision trees
|
|
35
|
-
- Human-in-the-loop integration
|
|
36
|
-
- Error handling and recovery mechanisms
|
|
37
|
-
- Monitoring and debugging tools
|
|
38
|
-
|
|
39
|
-
## Example Usage
|
|
40
|
-
```
|
|
41
|
-
## Required Documentation Access
|
|
42
|
-
|
|
43
|
-
**MANDATORY:** Before AI integration and LLM workflows, query Context7 for best practices:
|
|
44
|
-
|
|
45
|
-
**Documentation Queries:**
|
|
46
|
-
- `mcp://context7/ai/llm-integration` - llm integration best practices
|
|
47
|
-
- `mcp://context7/ai/workflow-orchestration` - workflow orchestration best practices
|
|
48
|
-
- `mcp://context7/openai/api` - api best practices
|
|
49
|
-
- `mcp://context7/langchain/agents` - agents best practices
|
|
50
|
-
|
|
51
|
-
**Why This is Required:**
|
|
52
|
-
- Ensures adherence to current industry standards and best practices
|
|
53
|
-
- Prevents outdated or incorrect implementation patterns
|
|
54
|
-
- Provides access to latest framework/tool documentation
|
|
55
|
-
- Reduces errors from stale knowledge or assumptions
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
Task: Create multi-agent research workflow with coordinator, researcher, analyzer, and writer agents
|
|
59
|
-
Agent: langgraph-workflow-expert
|
|
60
|
-
Parameters: workflow_type=multi-agent, agents=4, state_management=checkpoints, routing=complex
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
## Related Agents
|
|
64
|
-
- openai-python-expert: For OpenAI model integration
|
|
65
|
-
- gemini-api-expert: For Google AI model integration
|
|
@@ -1,65 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: openai-chat-integration
|
|
3
|
-
type: ai-integration
|
|
4
|
-
category: ai
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# OpenAI Chat Integration Command
|
|
8
|
-
|
|
9
|
-
Create a complete chat application using OpenAI Python SDK with advanced features.
|
|
10
|
-
|
|
11
|
-
## Command
|
|
12
|
-
```
|
|
13
|
-
/ai:openai-chat
|
|
14
|
-
```
|
|
15
|
-
|
|
16
|
-
## Purpose
|
|
17
|
-
Use the openai-python-expert agent to create a production-ready chat application with OpenAI integration, including function calling, embeddings, and safety features.
|
|
18
|
-
|
|
19
|
-
## Parameters
|
|
20
|
-
- `model`: OpenAI model to use (gpt-4, gpt-3.5-turbo, gpt-4-vision-preview)
|
|
21
|
-
- `features`: Required features (streaming, function-calling, embeddings, vision)
|
|
22
|
-
- `safety`: Safety configuration (content-filtering, rate-limiting, moderation)
|
|
23
|
-
- `storage`: Conversation storage (memory, database, file)
|
|
24
|
-
|
|
25
|
-
## Agent Usage
|
|
26
|
-
```
|
|
27
|
-
Use the openai-python-expert agent to create a comprehensive chat application with OpenAI integration.
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
## Expected Outcome
|
|
31
|
-
- Complete chat application with OpenAI SDK integration
|
|
32
|
-
- Streaming response handling
|
|
33
|
-
- Function calling implementation
|
|
34
|
-
- Rate limiting and error handling
|
|
35
|
-
- Conversation persistence
|
|
36
|
-
- Content moderation and safety controls
|
|
37
|
-
- Production-ready configuration
|
|
38
|
-
|
|
39
|
-
## Example Usage
|
|
40
|
-
```
|
|
41
|
-
## Required Documentation Access
|
|
42
|
-
|
|
43
|
-
**MANDATORY:** Before AI integration and LLM workflows, query Context7 for best practices:
|
|
44
|
-
|
|
45
|
-
**Documentation Queries:**
|
|
46
|
-
- `mcp://context7/ai/llm-integration` - llm integration best practices
|
|
47
|
-
- `mcp://context7/ai/workflow-orchestration` - workflow orchestration best practices
|
|
48
|
-
- `mcp://context7/openai/api` - api best practices
|
|
49
|
-
- `mcp://context7/langchain/agents` - agents best practices
|
|
50
|
-
|
|
51
|
-
**Why This is Required:**
|
|
52
|
-
- Ensures adherence to current industry standards and best practices
|
|
53
|
-
- Prevents outdated or incorrect implementation patterns
|
|
54
|
-
- Provides access to latest framework/tool documentation
|
|
55
|
-
- Reduces errors from stale knowledge or assumptions
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
Task: Create chat application with GPT-4, streaming responses, function calling for web search, and conversation history
|
|
59
|
-
Agent: openai-python-expert
|
|
60
|
-
Parameters: model=gpt-4, features=streaming,function-calling,embeddings, safety=content-filtering,rate-limiting, storage=database
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
## Related Agents
|
|
64
|
-
- gemini-api-expert: For Google AI alternative
|
|
65
|
-
- langgraph-workflow-expert: For complex conversation workflows
|
|
@@ -1,107 +0,0 @@
|
|
|
1
|
-
# Azure DevOps Command Equivalents
|
|
2
|
-
|
|
3
|
-
## Complete PM → Azure Command Mapping
|
|
4
|
-
|
|
5
|
-
```bash
|
|
6
|
-
# PRD → User Story
|
|
7
|
-
/pm:prd-new → /azure:us-new
|
|
8
|
-
/pm:prd-list → /azure:us-list
|
|
9
|
-
/pm:prd-edit → /azure:us-edit
|
|
10
|
-
/pm:prd-parse → /azure:us-parse
|
|
11
|
-
/pm:prd-status → /azure:us-status
|
|
12
|
-
|
|
13
|
-
# Issue → Task
|
|
14
|
-
/pm:issue-start → /azure:task-start
|
|
15
|
-
/pm:issue-close → /azure:task-close
|
|
16
|
-
/pm:issue-edit → /azure:task-edit
|
|
17
|
-
/pm:issue-show → /azure:task-show
|
|
18
|
-
/pm:issue-status → /azure:task-status
|
|
19
|
-
/pm:issue-sync → /azure:task-sync
|
|
20
|
-
/pm:issue-reopen → /azure:task-reopen
|
|
21
|
-
/pm:issue-analyze → /azure:task-analyze
|
|
22
|
-
|
|
23
|
-
# Epic → Feature
|
|
24
|
-
/pm:epic-decompose → /azure:feature-decompose
|
|
25
|
-
/pm:epic-start → /azure:feature-start
|
|
26
|
-
/pm:epic-close → /azure:feature-close
|
|
27
|
-
/pm:epic-edit → /azure:feature-edit
|
|
28
|
-
/pm:epic-list → /azure:feature-list
|
|
29
|
-
/pm:epic-show → /azure:feature-show
|
|
30
|
-
/pm:epic-status → /azure:feature-status
|
|
31
|
-
/pm:epic-sync → /azure:feature-sync
|
|
32
|
-
/pm:epic-merge → /azure:feature-merge
|
|
33
|
-
/pm:epic-refresh → /azure:feature-refresh
|
|
34
|
-
/pm:epic-oneshot → /azure:feature-oneshot
|
|
35
|
-
|
|
36
|
-
# Workflow → Sprint/Board
|
|
37
|
-
/pm:status → /azure:sprint-status
|
|
38
|
-
/pm:standup → /azure:standup
|
|
39
|
-
/pm:next → /azure:next-task
|
|
40
|
-
/pm:in-progress → /azure:active-work
|
|
41
|
-
/pm:blocked → /azure:blocked-items
|
|
42
|
-
/pm:search → /azure:search
|
|
43
|
-
/pm:validate → /azure:validate
|
|
44
|
-
/pm:clean → /azure:clean
|
|
45
|
-
|
|
46
|
-
# System → Config
|
|
47
|
-
/pm:init → /azure:init
|
|
48
|
-
/pm:import → /azure:import
|
|
49
|
-
/pm:sync → /azure:sync-all
|
|
50
|
-
/pm:help → /azure:help
|
|
51
|
-
/pm:test-reference-update → /azure:test-sync
|
|
52
|
-
```
|
|
53
|
-
|
|
54
|
-
## Already Implemented ✅
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
/azure:us-new # ✅ Created
|
|
58
|
-
/azure:us-list # ✅ Created
|
|
59
|
-
/azure:us-parse # ✅ Created
|
|
60
|
-
/azure:us-status # ✅ Created
|
|
61
|
-
/azure:import-us # ✅ Created (maps to /pm:import)
|
|
62
|
-
/azure:task-start # ✅ Created
|
|
63
|
-
/azure:task-list # ✅ Created
|
|
64
|
-
/azure:task-close # ✅ Created
|
|
65
|
-
/azure:feature-decompose # ✅ Created
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
## Need to Create 🔧
|
|
69
|
-
|
|
70
|
-
```bash
|
|
71
|
-
# High Priority
|
|
72
|
-
/azure:us-edit
|
|
73
|
-
/azure:us-show
|
|
74
|
-
/azure:task-edit
|
|
75
|
-
/azure:task-show
|
|
76
|
-
/azure:task-status
|
|
77
|
-
/azure:sprint-status
|
|
78
|
-
/azure:standup
|
|
79
|
-
/azure:next-task
|
|
80
|
-
|
|
81
|
-
# Medium Priority
|
|
82
|
-
/azure:feature-new
|
|
83
|
-
/azure:feature-list
|
|
84
|
-
/azure:feature-start
|
|
85
|
-
/azure:feature-close
|
|
86
|
-
/azure:feature-status
|
|
87
|
-
/azure:active-work
|
|
88
|
-
/azure:blocked-items
|
|
89
|
-
|
|
90
|
-
# Low Priority
|
|
91
|
-
/azure:task-sync
|
|
92
|
-
/azure:task-reopen
|
|
93
|
-
/azure:task-analyze
|
|
94
|
-
/azure:feature-edit
|
|
95
|
-
/azure:feature-show
|
|
96
|
-
/azure:feature-sync
|
|
97
|
-
/azure:feature-merge
|
|
98
|
-
/azure:feature-refresh
|
|
99
|
-
/azure:feature-oneshot
|
|
100
|
-
/azure:search
|
|
101
|
-
/azure:validate
|
|
102
|
-
/azure:clean
|
|
103
|
-
/azure:init
|
|
104
|
-
/azure:sync-all
|
|
105
|
-
/azure:help
|
|
106
|
-
/azure:test-sync
|
|
107
|
-
```
|
|
@@ -1,252 +0,0 @@
|
|
|
1
|
-
# PM and Azure DevOps Command Mapping
|
|
2
|
-
|
|
3
|
-
## 🤝 Complementary Systems
|
|
4
|
-
|
|
5
|
-
**IMPORTANT**: The PM and Azure systems are designed to **coexist and complement** each other, not replace one another.
|
|
6
|
-
|
|
7
|
-
- **PM System** (`/pm:*`): Local, file-based, works offline, universal git platform support
|
|
8
|
-
- **Azure System** (`/azure:*`): Enterprise integration, team collaboration, metrics tracking
|
|
9
|
-
|
|
10
|
-
See [PM-AZURE-COEXISTENCE.md](../../docs/PM-AZURE-COEXISTENCE.md) for detailed strategy.
|
|
11
|
-
|
|
12
|
-
## Command Translation Table
|
|
13
|
-
|
|
14
|
-
Below is a mapping showing equivalent commands between systems. Use the system that best fits your current context.
|
|
15
|
-
|
|
16
|
-
### PRD Commands → User Story Commands
|
|
17
|
-
|
|
18
|
-
| PM Command | Azure DevOps Command | Status | Description |
|
|
19
|
-
|------------|---------------------|---------|-------------|
|
|
20
|
-
| `/pm:prd-new` | `/azure:us-new` | ✅ Created | Create new User Story |
|
|
21
|
-
| `/pm:prd-list` | `/azure:us-list` | ✅ Created | List User Stories |
|
|
22
|
-
| `/pm:prd-edit` | `/azure:us-edit` | ✅ Created | Edit User Story |
|
|
23
|
-
| `/pm:prd-parse` | `/azure:us-parse` | ✅ Created | Parse User Story into Tasks |
|
|
24
|
-
| `/pm:prd-status` | `/azure:us-status` | ✅ Created | User Story status dashboard |
|
|
25
|
-
|
|
26
|
-
### Issue Commands → Task Commands
|
|
27
|
-
|
|
28
|
-
| PM Command | Azure DevOps Command | Status | Description |
|
|
29
|
-
|------------|---------------------|---------|-------------|
|
|
30
|
-
| `/pm:issue-start` | `/azure:task-start` | ✅ Created | Start working on Task |
|
|
31
|
-
| `/pm:issue-close` | `/azure:task-close` | ✅ Created | Complete Task |
|
|
32
|
-
| `/pm:issue-edit` | `/azure:task-edit` | ✅ Created | Edit Task details |
|
|
33
|
-
| `/pm:issue-show` | `/azure:task-show` | ✅ Created | Show Task details |
|
|
34
|
-
| `/pm:issue-status` | `/azure:task-status` | ✅ Created | Task status |
|
|
35
|
-
| `/pm:issue-sync` | `/azure:task-sync` | ✅ Created | Sync Tasks |
|
|
36
|
-
| `/pm:issue-reopen` | `/azure:task-reopen` | ✅ Created | Reopen closed Task |
|
|
37
|
-
| `/pm:issue-analyze` | `/azure:task-analyze` | 🔧 TODO | Analyze Task patterns |
|
|
38
|
-
|
|
39
|
-
### Epic Commands → Feature Commands
|
|
40
|
-
|
|
41
|
-
| PM Command | Azure DevOps Command | Status | Description |
|
|
42
|
-
|------------|---------------------|---------|-------------|
|
|
43
|
-
| `/pm:epic-decompose` | `/azure:feature-decompose` | ✅ Created | Break down Feature into User Stories |
|
|
44
|
-
| `/pm:epic-start` | `/azure:feature-start` | ✅ Created | Start Feature development |
|
|
45
|
-
| `/pm:epic-close` | `/azure:feature-close` | 🔧 TODO | Complete Feature |
|
|
46
|
-
| `/pm:epic-edit` | `/azure:feature-edit` | 🔧 TODO | Edit Feature details |
|
|
47
|
-
| `/pm:epic-list` | `/azure:feature-list` | ✅ Created | List Features |
|
|
48
|
-
| `/pm:epic-show` | `/azure:feature-show` | 🔧 TODO | Show Feature details |
|
|
49
|
-
| `/pm:epic-status` | `/azure:feature-status` | 🔧 TODO | Feature progress dashboard |
|
|
50
|
-
| `/pm:epic-sync` | `/azure:feature-sync` | 🔧 TODO | Sync Features |
|
|
51
|
-
| `/pm:epic-merge` | `/azure:feature-merge` | 🔧 TODO | Merge Feature branches |
|
|
52
|
-
| `/pm:epic-refresh` | `/azure:feature-refresh` | 🔧 TODO | Refresh Feature from source |
|
|
53
|
-
| `/pm:epic-oneshot` | `/azure:feature-oneshot` | 🔧 TODO | Quick Feature creation |
|
|
54
|
-
|
|
55
|
-
### Workflow Commands → Sprint/Board Commands
|
|
56
|
-
|
|
57
|
-
| PM Command | Azure DevOps Command | Status | Description |
|
|
58
|
-
|------------|---------------------|---------|-------------|
|
|
59
|
-
| `/pm:status` | `/azure:sprint-status` | ✅ Created | Sprint overview dashboard |
|
|
60
|
-
| `/pm:standup` | `/azure:standup` | ✅ Created | Daily standup report |
|
|
61
|
-
| `/pm:next` | `/azure:next-task` | ✅ Created | Get next recommended task |
|
|
62
|
-
| `/pm:in-progress` | `/azure:active-work` | ✅ Created | Show all active work items |
|
|
63
|
-
| `/pm:blocked` | `/azure:blocked-items` | ✅ Created | List blocked work items |
|
|
64
|
-
| `/pm:search` | `/azure:search` | 🔧 TODO | Search work items |
|
|
65
|
-
| `/pm:validate` | `/azure:validate` | 🔧 TODO | Validate work item structure |
|
|
66
|
-
| `/pm:clean` | `/azure:clean` | 🔧 TODO | Clean up completed items |
|
|
67
|
-
|
|
68
|
-
### System Commands → Azure DevOps Config
|
|
69
|
-
|
|
70
|
-
| PM Command | Azure DevOps Command | Status | Description |
|
|
71
|
-
|------------|---------------------|---------|-------------|
|
|
72
|
-
| `/pm:init` | `/azure:init` | 🔧 TODO | Initialize Azure DevOps project |
|
|
73
|
-
| `/pm:import` | `/azure:import-us` | ✅ Created | Import from external source |
|
|
74
|
-
| `/pm:sync` | `/azure:sync-all` | 🔧 TODO | Full bi-directional sync |
|
|
75
|
-
| `/pm:help` | `/azure:help` | 🔧 TODO | Azure DevOps command help |
|
|
76
|
-
| `/pm:test-reference-update` | `/azure:test-sync` | 🔧 TODO | Sync test references |
|
|
77
|
-
|
|
78
|
-
## Implementation Priority
|
|
79
|
-
|
|
80
|
-
### 🎯 High Priority (Core Workflow)
|
|
81
|
-
1. `/azure:us-edit` - Edit User Stories
|
|
82
|
-
2. `/azure:task-edit` - Edit Tasks
|
|
83
|
-
3. `/azure:task-show` - View Task details
|
|
84
|
-
4. `/azure:sprint-status` - Sprint dashboard
|
|
85
|
-
5. `/azure:standup` - Daily standup
|
|
86
|
-
|
|
87
|
-
### 📊 Medium Priority (Management)
|
|
88
|
-
1. `/azure:feature-list` - List all Features
|
|
89
|
-
2. `/azure:feature-status` - Feature dashboard
|
|
90
|
-
3. `/azure:feature-start` - Start Feature work
|
|
91
|
-
4. `/azure:feature-close` - Complete Feature
|
|
92
|
-
5. `/azure:active-work` - Active items view
|
|
93
|
-
6. `/azure:blocked-items` - Blocked items
|
|
94
|
-
|
|
95
|
-
### 🔧 Low Priority (Advanced)
|
|
96
|
-
1. `/azure:feature-merge` - Merge Feature branches
|
|
97
|
-
2. `/azure:task-analyze` - Task analytics
|
|
98
|
-
4. `/azure:search` - Advanced search
|
|
99
|
-
5. `/azure:validate` - Validation tools
|
|
100
|
-
6. `/azure:clean` - Cleanup utilities
|
|
101
|
-
|
|
102
|
-
## Command Files to Create
|
|
103
|
-
|
|
104
|
-
### Next Batch (High Priority)
|
|
105
|
-
|
|
106
|
-
```bash
|
|
107
|
-
# User Story Management
|
|
108
|
-
.claude/commands/azure/us-edit.md
|
|
109
|
-
.claude/commands/azure/us-show.md
|
|
110
|
-
.claude/commands/azure/us-sync.md
|
|
111
|
-
.claude/commands/azure/us-close.md
|
|
112
|
-
|
|
113
|
-
# Task Management
|
|
114
|
-
.claude/commands/azure/task-edit.md
|
|
115
|
-
.claude/commands/azure/task-show.md
|
|
116
|
-
.claude/commands/azure/task-status.md
|
|
117
|
-
.claude/commands/azure/task-sync.md
|
|
118
|
-
.claude/commands/azure/task-reopen.md
|
|
119
|
-
.claude/commands/azure/task-analyze.md
|
|
120
|
-
.claude/commands/azure/task-new.md
|
|
121
|
-
|
|
122
|
-
# Feature Management
|
|
123
|
-
.claude/commands/azure/feature-new.md
|
|
124
|
-
.claude/commands/azure/feature-list.md
|
|
125
|
-
.claude/commands/azure/feature-show.md
|
|
126
|
-
.claude/commands/azure/feature-edit.md
|
|
127
|
-
.claude/commands/azure/feature-status.md
|
|
128
|
-
.claude/commands/azure/feature-start.md
|
|
129
|
-
.claude/commands/azure/feature-close.md
|
|
130
|
-
.claude/commands/azure/feature-sync.md
|
|
131
|
-
.claude/commands/azure/feature-merge.md
|
|
132
|
-
|
|
133
|
-
# Sprint/Workflow
|
|
134
|
-
.claude/commands/azure/sprint-status.md
|
|
135
|
-
.claude/commands/azure/sprint-plan.md
|
|
136
|
-
.claude/commands/azure/standup.md
|
|
137
|
-
.claude/commands/azure/next-task.md
|
|
138
|
-
.claude/commands/azure/active-work.md
|
|
139
|
-
.claude/commands/azure/blocked-items.md
|
|
140
|
-
|
|
141
|
-
# System
|
|
142
|
-
.claude/commands/azure/init.md
|
|
143
|
-
.claude/commands/azure/sync-all.md
|
|
144
|
-
.claude/commands/azure/search.md
|
|
145
|
-
.claude/commands/azure/validate.md
|
|
146
|
-
.claude/commands/azure/clean.md
|
|
147
|
-
.claude/commands/azure/help.md
|
|
148
|
-
```
|
|
149
|
-
|
|
150
|
-
## Azure DevOps Work Item Hierarchy
|
|
151
|
-
|
|
152
|
-
```
|
|
153
|
-
Feature/Epic
|
|
154
|
-
└── User Story
|
|
155
|
-
└── Task
|
|
156
|
-
└── Sub-task (optional)
|
|
157
|
-
```
|
|
158
|
-
|
|
159
|
-
## Field Mapping
|
|
160
|
-
|
|
161
|
-
### User Story Fields
|
|
162
|
-
- **Title** → System.Title
|
|
163
|
-
- **Description** → System.Description
|
|
164
|
-
- **Acceptance Criteria** → Microsoft.VSTS.Common.AcceptanceCriteria
|
|
165
|
-
- **Story Points** → Microsoft.VSTS.Scheduling.StoryPoints
|
|
166
|
-
- **Priority** → Microsoft.VSTS.Common.Priority
|
|
167
|
-
- **Sprint** → System.IterationPath
|
|
168
|
-
- **Area** → System.AreaPath
|
|
169
|
-
|
|
170
|
-
### Task Fields
|
|
171
|
-
- **Title** → System.Title
|
|
172
|
-
- **Description** → System.Description
|
|
173
|
-
- **Remaining Work** → Microsoft.VSTS.Scheduling.RemainingWork
|
|
174
|
-
- **Original Estimate** → Microsoft.VSTS.Scheduling.OriginalEstimate
|
|
175
|
-
- **Completed Work** → Microsoft.VSTS.Scheduling.CompletedWork
|
|
176
|
-
- **Activity** → Microsoft.VSTS.Common.Activity
|
|
177
|
-
|
|
178
|
-
### Feature Fields
|
|
179
|
-
- **Title** → System.Title
|
|
180
|
-
- **Description** → System.Description
|
|
181
|
-
- **Business Value** → Microsoft.VSTS.Common.BusinessValue
|
|
182
|
-
- **Time Criticality** → Microsoft.VSTS.Common.TimeCriticality
|
|
183
|
-
- **Effort** → Microsoft.VSTS.Scheduling.Effort
|
|
184
|
-
- **Target Date** → Microsoft.VSTS.Scheduling.TargetDate
|
|
185
|
-
|
|
186
|
-
## State Mappings
|
|
187
|
-
|
|
188
|
-
### User Story States
|
|
189
|
-
- `backlog` → New
|
|
190
|
-
- `ready` → Ready
|
|
191
|
-
- `active` → Active
|
|
192
|
-
- `resolved` → Resolved
|
|
193
|
-
- `closed` → Closed
|
|
194
|
-
- `removed` → Removed
|
|
195
|
-
|
|
196
|
-
### Task States
|
|
197
|
-
- `new` → To Do
|
|
198
|
-
- `active` → In Progress
|
|
199
|
-
- `resolved` → Done
|
|
200
|
-
- `closed` → Closed
|
|
201
|
-
- `removed` → Removed
|
|
202
|
-
|
|
203
|
-
### Feature States
|
|
204
|
-
- `new` → New
|
|
205
|
-
- `in_progress` → In Progress
|
|
206
|
-
- `testing` → Testing
|
|
207
|
-
- `done` → Done
|
|
208
|
-
- `closed` → Closed
|
|
209
|
-
|
|
210
|
-
## Quick Reference
|
|
211
|
-
|
|
212
|
-
### Most Used Commands
|
|
213
|
-
|
|
214
|
-
```bash
|
|
215
|
-
# Daily workflow
|
|
216
|
-
/azure:standup # Morning standup
|
|
217
|
-
/azure:task-start <id> # Start task
|
|
218
|
-
/azure:task-close <id> # Complete task
|
|
219
|
-
/azure:next-task # Get next task
|
|
220
|
-
|
|
221
|
-
# Planning
|
|
222
|
-
/azure:us-new <name> # Create User Story
|
|
223
|
-
/azure:us-parse <id> # Break into tasks
|
|
224
|
-
/azure:sprint-plan # Plan sprint
|
|
225
|
-
|
|
226
|
-
# Status
|
|
227
|
-
/azure:sprint-status # Sprint dashboard
|
|
228
|
-
/azure:us-status <id> # Story progress
|
|
229
|
-
/azure:blocked-items # Show blockers
|
|
230
|
-
```
|
|
231
|
-
|
|
232
|
-
## Integration Points
|
|
233
|
-
|
|
234
|
-
### Git Integration
|
|
235
|
-
- Branch naming: `task-{id}-{title}`
|
|
236
|
-
- PR templates included
|
|
237
|
-
- Auto-merge capabilities
|
|
238
|
-
|
|
239
|
-
### CI/CD Integration
|
|
240
|
-
- Pipeline status tracking
|
|
241
|
-
- Build associations
|
|
242
|
-
- Deployment tracking
|
|
243
|
-
|
|
244
|
-
### Time Tracking
|
|
245
|
-
- Automatic time logging
|
|
246
|
-
- Capacity planning
|
|
247
|
-
- Velocity calculations
|
|
248
|
-
|
|
249
|
-
### Notifications
|
|
250
|
-
- Status change alerts
|
|
251
|
-
- Assignment notifications
|
|
252
|
-
- Blocker escalations
|
|
@@ -1,103 +0,0 @@
|
|
|
1
|
-
# Azure DevOps Agent-Command Integration Fix
|
|
2
|
-
|
|
3
|
-
## Problem Identified
|
|
4
|
-
|
|
5
|
-
The Azure DevOps commands were **fundamentally broken** because they never actually invoked the `azure-devops-specialist` agent. Instead, they:
|
|
6
|
-
|
|
7
|
-
1. ✅ Documented how to use the agent (good documentation)
|
|
8
|
-
2. ❌ Never actually called the agent (broken execution)
|
|
9
|
-
3. ❌ Tried to handle Azure DevOps operations directly (ineffective)
|
|
10
|
-
|
|
11
|
-
## Root Cause
|
|
12
|
-
|
|
13
|
-
**Architectural mismatch**: Commands contained instructions *about* the agent but no mechanism to *invoke* the agent.
|
|
14
|
-
|
|
15
|
-
## Solution Implemented
|
|
16
|
-
|
|
17
|
-
### 1. Updated Command Structure
|
|
18
|
-
|
|
19
|
-
**Before** (broken):
|
|
20
|
-
```markdown
|
|
21
|
-
## Instructions
|
|
22
|
-
You are a Product Owner creating a User Story...
|
|
23
|
-
Use the azure-devops-specialist agent to:
|
|
24
|
-
1. Create work item
|
|
25
|
-
2. Set metadata
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
**After** (fixed):
|
|
29
|
-
```markdown
|
|
30
|
-
## Instructions
|
|
31
|
-
**CRITICAL**: This command MUST use the azure-devops-specialist agent.
|
|
32
|
-
|
|
33
|
-
### Command Execution Pattern
|
|
34
|
-
Task(subagent_type="azure-devops-specialist",
|
|
35
|
-
description="Create Azure DevOps User Story",
|
|
36
|
-
prompt="Detailed instructions...")
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
### 2. Files Updated
|
|
40
|
-
|
|
41
|
-
#### Commands Fixed:
|
|
42
|
-
- ✅ `us-new.md` - User Story creation
|
|
43
|
-
- ✅ `task-start.md` - Task activation
|
|
44
|
-
- ➡️ **Need to update remaining 38+ commands with same pattern**
|
|
45
|
-
|
|
46
|
-
#### Agent Enhanced:
|
|
47
|
-
- ✅ `azure-devops-specialist.md` - Added command workflow integration patterns
|
|
48
|
-
|
|
49
|
-
### 3. Integration Pattern
|
|
50
|
-
|
|
51
|
-
```bash
|
|
52
|
-
# CORRECT usage in commands
|
|
53
|
-
Task(subagent_type="azure-devops-specialist",
|
|
54
|
-
description="Brief operation description",
|
|
55
|
-
prompt="Complete workflow instructions including:
|
|
56
|
-
1. Environment validation
|
|
57
|
-
2. Azure DevOps API operations
|
|
58
|
-
3. Local documentation updates
|
|
59
|
-
4. Status reporting")
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
## What Commands Should Do
|
|
63
|
-
|
|
64
|
-
1. **Input validation** (task IDs, environment variables)
|
|
65
|
-
2. **Call azure-devops-specialist agent** via Task tool
|
|
66
|
-
3. **Provide complete instructions** to the agent
|
|
67
|
-
4. **Define expected output format**
|
|
68
|
-
|
|
69
|
-
## What Agent Should Do
|
|
70
|
-
|
|
71
|
-
1. **Environment setup** (PAT tokens, authentication)
|
|
72
|
-
2. **Azure DevOps API calls** (work items, status updates)
|
|
73
|
-
3. **Local file management** (`.claude/azure/` tracking)
|
|
74
|
-
4. **Structured reporting** (URLs, next steps)
|
|
75
|
-
|
|
76
|
-
## Testing the Fix
|
|
77
|
-
|
|
78
|
-
To verify the integration works:
|
|
79
|
-
|
|
80
|
-
```bash
|
|
81
|
-
# Test the fixed commands
|
|
82
|
-
/azure:us-new test-story
|
|
83
|
-
/azure:task-start 123
|
|
84
|
-
|
|
85
|
-
# Should now properly invoke azure-devops-specialist agent
|
|
86
|
-
# Instead of failing with direct Azure DevOps operations
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
## Remaining Work
|
|
90
|
-
|
|
91
|
-
1. **Update all 38+ Azure commands** with Task tool invocation pattern
|
|
92
|
-
2. **Test end-to-end workflows** with real Azure DevOps instance
|
|
93
|
-
3. **Validate error handling** when API calls fail
|
|
94
|
-
4. **Document success patterns** for other command integrations
|
|
95
|
-
|
|
96
|
-
## Key Learnings
|
|
97
|
-
|
|
98
|
-
- Commands must **invoke agents**, not just document them
|
|
99
|
-
- Use `Task(subagent_type="...", prompt="...")` for all agent calls
|
|
100
|
-
- Agent documentation should include **command integration patterns**
|
|
101
|
-
- **Test integration**, don't assume documentation equals implementation
|
|
102
|
-
|
|
103
|
-
This fix transforms the Azure DevOps system from **documented but broken** to **properly integrated and functional**.
|