From 39aad9aa50133e574cfc002a93e0fc7ab5f6bc74 Mon Sep 17 00:00:00 2001 From: agentman3334 Date: Wed, 29 Jul 2026 15:17:20 +0300 Subject: [PATCH] feat(sdlc-pipeline): add Postman MCP, auto-select Newman, update onboarding - mcp-settings.json: add Postman HTTP MCP entry (https://mcp.postman.com/mcp) - config-reference.md: add Postman + terraform to MCP table - service-onboarding.md: update Postman MCP config note, expand table with Postman install and Newman cloud collection steps - multi-tool-selection-plan.md: add Postman->Newman auto-select rule (post-processing), update Q3 option descriptions, remove soft warning --- .../references/config-reference.md | 2 ++ .../references/setup/multi-tool-selection-plan.md | 7 ++++--- .../references/setup/service-onboarding.md | 6 +++++- .../references/templates/mcp-settings.json | 11 ++++++++++- 4 files changed, 21 insertions(+), 5 deletions(-) diff --git a/skills/sdlc-agentic-pipeline/references/config-reference.md b/skills/sdlc-agentic-pipeline/references/config-reference.md index 86c494b..5027aa9 100644 --- a/skills/sdlc-agentic-pipeline/references/config-reference.md +++ b/skills/sdlc-agentic-pipeline/references/config-reference.md @@ -57,6 +57,8 @@ Ready-to-fill templates are in `references/templates/`: | `github` | Repos, branches, PRs, reviews, workflow dispatch | Bearer PAT | `GITHUB_OWNER`, `GITHUB_REPO` | | `sonarqube` | Quality gate, issues, coverage, hotspots | Bearer token | `SONAR_PROJECT_KEY` | | `semgrep` | Local static analysis, security scanning | App token env | — | +| `terraform` | Infrastructure as Code (ECS provisioning, Option B) | — | — | +| `postman` | API testing, collection runs | Bearer API key (HTTP) | — | JFrog is configured as a service (REST API) in `/.env` + GitHub Actions secrets/variables, not as an MCP server. ECS config is also in `/.env`. \ No newline at end of file diff --git a/skills/sdlc-agentic-pipeline/references/setup/multi-tool-selection-plan.md b/skills/sdlc-agentic-pipeline/references/setup/multi-tool-selection-plan.md index 614a7c3..343b7ae 100644 --- a/skills/sdlc-agentic-pipeline/references/setup/multi-tool-selection-plan.md +++ b/skills/sdlc-agentic-pipeline/references/setup/multi-tool-selection-plan.md @@ -36,7 +36,7 @@ File: `.codeartsdoer/tool-selections.json` **Q1 — MCP Servers & Services**: GitHub, Jira, SonarCloud, Semgrep, JFrog Artifactory, Huawei Cloud ECS, None **Q2 — SDD**: SDD Toolkit (Huawei Built-in), OpenSpec (coming soon), None -**Q3 — TDD**: Playwright CLI (E2E), Postman (API), Newman (API), Jest (Unit JS/TS), Pytest (Unit Python), JUnit (Unit Java), Vitest (Unit JS/TS Vite), None +**Q3 — TDD**: Playwright CLI (E2E browser testing), Postman (Interactive API testing via MCP), Newman (CLI collection runner for CI/CD — auto-selected with Postman), Jest (Unit testing JS/TS), Pytest (Unit testing Python), JUnit (Unit testing Java), Vitest (Unit testing JS/TS Vite), None (Skip TDD) **Q4 — DDD**: Context Mapper, EventStorming, Structurizr, None ### Selection Rules @@ -45,9 +45,10 @@ File: `.codeartsdoer/tool-selections.json` 3. Non-contiguous selection valid 4. "None" takes precedence if selected alongside other items 5. Built-in utility skills never mentioned +6. **Auto-select (post-processing)**: After Q3 returns, if Postman is selected but Newman is NOT, the PM Agent automatically adds Newman to the selections before writing `tool-selections.json`. Newman's option label is "(auto-selected with Postman)" so users know it will be included. The user sees Newman in the post-selection summary as "(auto-selected via Postman)" and can confirm or reject. ### Post-Selection Summary -Print selected/skipped items, pipeline impact, and dependency warnings. Ask: "Proceed with these selections?" (Yes/No). +Print selected/skipped items (including auto-selected Newman if Postman chosen), pipeline impact, and dependency warnings. Ask: "Proceed with these selections?" (Yes/No). --- @@ -60,7 +61,7 @@ Print selected/skipped items, pipeline impact, and dependency warnings. Ask: "Pr | JFrog | Huawei ECS | Deployment has no image source | | Huawei ECS | JFrog | No Docker image to deploy | | Playwright | GitHub | E2E tests run against local working directory only | -| Postman | Newman | Postman monitors can't reach localhost APIs | + | DDD tools | SDD | Domain model used directly without formal spec | | Any TDD tool | GitHub | Tests not version-controlled via PRs | diff --git a/skills/sdlc-agentic-pipeline/references/setup/service-onboarding.md b/skills/sdlc-agentic-pipeline/references/setup/service-onboarding.md index 3d5994d..047a851 100644 --- a/skills/sdlc-agentic-pipeline/references/setup/service-onboarding.md +++ b/skills/sdlc-agentic-pipeline/references/setup/service-onboarding.md @@ -141,7 +141,7 @@ For each selected methodology tool, verify/install/connect/smoke-test: |------|--------|---------|------------| | SDD Toolkit | N/A (built-in) | N/A | N/A | | OpenSpec | `openspec --version` | `npm install -g @fission-ai/openspec@latest` | `openspec list` | -| Postman | N/A (MCP) | N/A | `postman MCP list workspaces` | +| Postman | N/A (MCP) | Copy `references/templates/SKILL.md` to `.codeartsdoer/skills/postman/SKILL.md` | `postman MCP list workspaces` | | Newman | `newman --version` | `npm install -g newman` | `newman run --version` | | Jest | `npx jest --version` | `npm i -D jest` | `npx jest --listTests` | | Pytest | `pytest --version` | `pip install pytest` | `pytest --collect-only` | @@ -151,6 +151,10 @@ For each selected methodology tool, verify/install/connect/smoke-test: | EventStorming | N/A | N/A | N/A | | Structurizr | N/A | N/A | N/A | +**Postman MCP config** (`mcp_settings.json`): HTTP type, URL `https://mcp.postman.com/mcp`, headers `Authorization: Bearer ` (PMAK from Settings -> API Keys). + +**Newman cloud collections**: `newman run "https://api.getpostman.com/collections/?apikey=$POSTMAN_API_KEY"` (API key via env var only). + **Failure rule:** If a tool fails its smoke test, report to user, skip that tool, and continue with remaining tools. After install, run `apply-tool-selections.ps1` (Windows) or `apply-tool-selections.sh` (macOS/Linux) to update agent frontmatter permissions based on `tool-selections.json` + `skill-registry.json`. diff --git a/skills/sdlc-agentic-pipeline/references/templates/mcp-settings.json b/skills/sdlc-agentic-pipeline/references/templates/mcp-settings.json index c4b6e7a..ff6e77f 100644 --- a/skills/sdlc-agentic-pipeline/references/templates/mcp-settings.json +++ b/skills/sdlc-agentic-pipeline/references/templates/mcp-settings.json @@ -6,7 +6,8 @@ "github": "github (item 1)", "sonarqube": "sonarcloud (item 3)", "semgrep": "semgrep (item 4)", - "terraform": "huawei-ecs (item 6, Option B only)" + "terraform": "huawei-ecs (item 6, Option B only)", + "postman": "postman (item 3, TDD Q3)" } }, "mcpServers": { @@ -55,6 +56,14 @@ "args": ["stdio"], "disabled": false, "timeout": 120000 + }, + "postman": { + "type": "http", + "url": "https://mcp.postman.com/mcp", + "headers": { + "Authorization": "Bearer " + }, + "disabled": false } } } \ No newline at end of file