v2: Forge Console + Open WebUI artifacts + Docker
- web/: Local chat UI (Express + WS → Codex bridge) - openwebui/: Preset, pipelines, knowledge manifest - Dockerfile + docker-compose.yml - Updated README with 3 frontend options - CLI-agnostic: works with Codex, Claude Code, Kiro, Gemini
This commit is contained in:
327
docs/agents/jira.md
Normal file
327
docs/agents/jira.md
Normal file
@@ -0,0 +1,327 @@
|
||||
---
|
||||
name: jira
|
||||
description: Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
|
||||
---
|
||||
|
||||
# Atlassian / JIRA Reference
|
||||
|
||||
## Domain
|
||||
`reltio.jira.com` — use for all browse links, e.g. `https://reltio.jira.com/browse/RP-XXXXX`
|
||||
|
||||
## Cloud ID
|
||||
`444c13e0-0faa-4055-b053-501700bae7b0`
|
||||
|
||||
## Current User (Brian Galura)
|
||||
- account_id: `712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b`
|
||||
- email: brian.galura@reltio.com
|
||||
|
||||
## Project
|
||||
- key: `RP` (Reltio Platform), id: `10041`
|
||||
- key: `ICR` (Infrastructure Change Request), id: `12890`
|
||||
|
||||
## Issue Types (RP project)
|
||||
| Name | ID | Hierarchy | Notes |
|
||||
|----------------|-------|-----------|------------------------------|
|
||||
| Epic | 5 | 1 | Parent of stories |
|
||||
| Story | 6 | 0 | Standard work item |
|
||||
| Rollout Story | 10535 | 0 | Feature enablement per env |
|
||||
| Task | 3 | 0 | |
|
||||
| Bug | 1 | 0 | |
|
||||
| Sub-Task | 9 | -1 | Child of other issue types |
|
||||
|
||||
## Required Fields by Issue Type
|
||||
|
||||
### Epic (required)
|
||||
| Field | Key | Type |
|
||||
|------------------------|--------------------|-------------------|
|
||||
| Assignee | `assignee` | user |
|
||||
| Type of Effort | `customfield_15815`| option (select) |
|
||||
|
||||
### Story (required)
|
||||
| Field | Key | Type |
|
||||
|------------------------|--------------------|-------------------|
|
||||
| Assignee | `assignee` | user |
|
||||
| Found/Requested By | `customfield_11922`| option (select) |
|
||||
| Affected Documentation | `customfield_12429`| array of options |
|
||||
| Acceptance Criteria | `customfield_15956`| **ADF** (rich text, must use Atlassian Document Format) |
|
||||
| Type of Effort | `customfield_15815`| option (select) |
|
||||
|
||||
### Task (required)
|
||||
| Field | Key | Type |
|
||||
|------------------------|--------------------|-------------------|
|
||||
| Assignee | `assignee` | user |
|
||||
| Components | `components` | array of component (`[{"id": "..."}]`) |
|
||||
| Found/Requested By | `customfield_11922`| option (select) |
|
||||
| Type of Effort | `customfield_15815`| option (select) |
|
||||
|
||||
### Rollout Story (required)
|
||||
| Field | Key | Type |
|
||||
|------------------------|--------------------|-------------------|
|
||||
| Assignee | `assignee` | user |
|
||||
| Found/Requested By | `customfield_11922`| option (select) |
|
||||
| Affected Documentation | `customfield_12429`| array of options |
|
||||
| Execution team | `customfield_13020`| option (select) |
|
||||
| Type of Effort | `customfield_15815`| option (select) |
|
||||
|
||||
### Change Request (ICR project, required)
|
||||
| Field | Key | Type |
|
||||
|------------------------|--------------------|-------------------|
|
||||
| Assignee | `assignee` | user (has default; still set explicitly when possible) |
|
||||
| Change Start Date/Time | `customfield_15856`| datetime (`YYYY-MM-DDTHH:mm:ss.SSS-0800`) |
|
||||
| Change End Date/Time | `customfield_15857`| datetime (`YYYY-MM-DDTHH:mm:ss.SSS-0800`) |
|
||||
| Manager/Peer Reviewer | `customfield_15862`| user |
|
||||
| Procedure | `customfield_15863`| option (select) |
|
||||
| Change Category | `customfield_15864`| option (select) |
|
||||
| Can it be rolled back? | `customfield_16072`| array of options (checkbox) |
|
||||
|
||||
## Common Custom Fields (optional but useful)
|
||||
| Field | Key | Type |
|
||||
|--------------------|--------------------|-----------------|
|
||||
| Fix Version | `fixVersions` | array of version|
|
||||
| Reporter | `reporter` | user (`{"accountId": "..."}`) |
|
||||
| Story Points | `customfield_10013`| number |
|
||||
| Confidence Level | `customfield_12520`| option (select) |
|
||||
| Product Lead | `customfield_15755`| user |
|
||||
| Engineering Lead | `customfield_15756`| user |
|
||||
| Start date | `customfield_15541`| date (YYYY-MM-DD) |
|
||||
| End date | `customfield_15535`| date (YYYY-MM-DD) |
|
||||
| Sprint | `customfield_10320`| sprint |
|
||||
| Aha! Reference | `customfield_11820`| string (URL) |
|
||||
| Security Review | `customfield_15826`| option (select) |
|
||||
|
||||
## Allowed Values for Required Select Fields
|
||||
|
||||
### Type of Effort (`customfield_15815`)
|
||||
| Value | ID |
|
||||
|-------------------------------------------|-------|
|
||||
| Customer Feature | 18153 |
|
||||
| Customer Support | 18156 |
|
||||
| Innovation | 19074 |
|
||||
| Platform Excellence | 18922 |
|
||||
| Security Issues / Tech Debt / Maintenance | 18155 |
|
||||
|
||||
### Found/Requested By (`customfield_11922`)
|
||||
| Value | ID |
|
||||
|----------------------|-------|
|
||||
| Alert | 18931 |
|
||||
| Customer Engineering | 13609 |
|
||||
| Engineering | 10114 |
|
||||
| FDE | 24812 |
|
||||
| Other | 17542 |
|
||||
| Product Management | 10115 |
|
||||
|
||||
### Affected Documentation (`customfield_12429`)
|
||||
| Value | ID |
|
||||
|-------------------|-------|
|
||||
| No | 16302 |
|
||||
| Deprecation Notice| 11710 |
|
||||
| Help Portal | 10438 |
|
||||
| Internal Only | 12912 |
|
||||
| Release Notes | 10437 |
|
||||
|
||||
### Execution team (`customfield_13020`) — partial list
|
||||
| Value | ID |
|
||||
|--------------------|-------|
|
||||
| Cloud Platform (Portugal) | 19040 |
|
||||
| DevOps | 16211 |
|
||||
| Documentation | 18367 |
|
||||
| Persistence | 16700 |
|
||||
| Performance | 17629 |
|
||||
| Data Unification | 12811 |
|
||||
| Match | 15400 |
|
||||
| IDP | 17906 |
|
||||
| Console | 17845 |
|
||||
| Architecture | 18930 |
|
||||
| CI | 17656 |
|
||||
|
||||
### Procedure (`customfield_15863`) — ICR Change Request
|
||||
| Value | ID |
|
||||
|-------------|-------|
|
||||
| Manual Step | 18226 |
|
||||
| Automated | 18227 |
|
||||
|
||||
### Change Category (`customfield_15864`) — ICR Change Request
|
||||
Default for ICR templates in this skill: `High Risk` (`18229`).
|
||||
|
||||
| Value | ID |
|
||||
|-----------|-------|
|
||||
| Low Risk | 18228 |
|
||||
| High Risk | 18229 |
|
||||
| Emergency | 18230 |
|
||||
|
||||
### Can it be rolled back? (`customfield_16072`) — ICR Change Request
|
||||
| Value | ID |
|
||||
|-------|-------|
|
||||
| Yes | 18678 |
|
||||
| No | 18679 |
|
||||
|
||||
### Risk Level (`customfield_16070`) — required when closing
|
||||
| Value | ID |
|
||||
|--------------------|-------|
|
||||
| High-Risk Changes | 18676 |
|
||||
| Low-Risk Changes | 18677 |
|
||||
| Not applicable | 19049 |
|
||||
|
||||
### Confidence Level (`customfield_12520`)
|
||||
| Value | ID |
|
||||
|--------|-------|
|
||||
| High | 10510 |
|
||||
|
||||
### Components (partial list)
|
||||
| Value | ID |
|
||||
|---------------|-------|
|
||||
| Documentation | 10222 |
|
||||
| QA | 11511 |
|
||||
| DevOps | 11111 |
|
||||
| DNS | 20020 |
|
||||
|
||||
## Fix Versions (known)
|
||||
| Version | ID | Release Date |
|
||||
|------------|-------|-------------|
|
||||
| 2026.1.0.0 | 28439 | 2026-03-23 |
|
||||
|
||||
## ADF (Atlassian Document Format) Templates
|
||||
|
||||
### Acceptance Criteria — ordered list
|
||||
```json
|
||||
{
|
||||
"type": "doc",
|
||||
"version": 1,
|
||||
"content": [
|
||||
{"type": "orderedList", "attrs": {"order": 1}, "content": [
|
||||
{"type": "listItem", "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Criteria item 1"}]}]},
|
||||
{"type": "listItem", "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Criteria item 2"}]}]}
|
||||
]}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Generic paragraph ADF (use for rich-text custom fields)
|
||||
```json
|
||||
{
|
||||
"type": "doc",
|
||||
"version": 1,
|
||||
"content": [
|
||||
{
|
||||
"type": "paragraph",
|
||||
"content": [
|
||||
{"type": "text", "text": "No expected customer impact."}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## Common Transitions
|
||||
| Name | ID | Target Status |
|
||||
|--------------------------|-----|----------------|
|
||||
| Selected for Development | 501 | Prioritized |
|
||||
| Start Progress | 11 | In Progress |
|
||||
| Resolve | 31 | Resolved |
|
||||
| In Design | 471 | In Design |
|
||||
| Close | 351 | Closed |
|
||||
|
||||
**Close transition requires:** `fixVersions` and `customfield_16070` (Risk Level).
|
||||
|
||||
### Example: Close a ticket
|
||||
```bash
|
||||
mcporter call atlassian.transitionJiraIssue --args '{
|
||||
"cloudId": "444c13e0-0faa-4055-b053-501700bae7b0",
|
||||
"issueIdOrKey": "RP-XXXXX",
|
||||
"transition": {"id": "351"},
|
||||
"fields": {
|
||||
"fixVersions": [{"id": "28439"}],
|
||||
"customfield_16070": {"id": "19049"}
|
||||
}
|
||||
}'
|
||||
```
|
||||
|
||||
## Example: Create an Epic
|
||||
```bash
|
||||
mcporter call atlassian.createJiraIssue --args '{
|
||||
"cloudId": "444c13e0-0faa-4055-b053-501700bae7b0",
|
||||
"projectKey": "RP",
|
||||
"issueTypeName": "Epic",
|
||||
"summary": "Epic Title",
|
||||
"description": "Markdown description",
|
||||
"assignee_account_id": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b",
|
||||
"additional_fields": {
|
||||
"reporter": {"accountId": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b"},
|
||||
"fixVersions": [{"id": "28439"}],
|
||||
"customfield_15815": {"id": "18153"}
|
||||
}
|
||||
}'
|
||||
```
|
||||
|
||||
## Example: Create a Task
|
||||
```bash
|
||||
mcporter call atlassian.createJiraIssue --args '{
|
||||
"cloudId": "444c13e0-0faa-4055-b053-501700bae7b0",
|
||||
"projectKey": "RP",
|
||||
"issueTypeName": "Task",
|
||||
"summary": "Task Title",
|
||||
"description": "Task description",
|
||||
"assignee_account_id": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b",
|
||||
"additional_fields": {
|
||||
"components": [{"id": "10222"}],
|
||||
"customfield_15815": {"id": "18922"},
|
||||
"customfield_11922": {"id": "10115"}
|
||||
}
|
||||
}'
|
||||
```
|
||||
|
||||
## Example: Create a Story under an Epic
|
||||
```bash
|
||||
mcporter call atlassian.createJiraIssue --args '{
|
||||
"cloudId": "444c13e0-0faa-4055-b053-501700bae7b0",
|
||||
"projectKey": "RP",
|
||||
"issueTypeName": "Story",
|
||||
"summary": "Story Title",
|
||||
"description": "Markdown description with ## Why / ## What / ## How",
|
||||
"assignee_account_id": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b",
|
||||
"parent": "RP-XXXXX",
|
||||
"additional_fields": {
|
||||
"reporter": {"accountId": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b"},
|
||||
"fixVersions": [{"id": "28439"}],
|
||||
"customfield_15815": {"id": "18153"},
|
||||
"customfield_11922": {"id": "10114"},
|
||||
"customfield_12429": [{"id": "16302"}],
|
||||
"customfield_15956": {"type":"doc","version":1,"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"type":"text","text":"AC item"}]}]}]}]}
|
||||
}
|
||||
}'
|
||||
```
|
||||
|
||||
## Example: Create an ICR Change Request
|
||||
```bash
|
||||
mcporter call atlassian.createJiraIssue --args '{
|
||||
"cloudId": "444c13e0-0faa-4055-b053-501700bae7b0",
|
||||
"projectKey": "ICR",
|
||||
"issueTypeName": "Change Request",
|
||||
"summary": "Re-add na11 IP 34.36.175.121 to na07 latency-based Cloud DNS records (na07-compute)",
|
||||
"description": "Implementation, verification, impact, and rollback details",
|
||||
"assignee_account_id": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b",
|
||||
"additional_fields": {
|
||||
"components": [{"id": "20020"}],
|
||||
"customfield_15856": "2026-02-26T17:00:00.000-0800",
|
||||
"customfield_15857": "2026-02-26T18:00:00.000-0800",
|
||||
"customfield_15862": {"accountId": "712020:f70452cf-df7e-4ee3-b65b-66c83566fc3b"},
|
||||
"customfield_15863": {"id": "18226"},
|
||||
"customfield_15864": {"id": "18229"},
|
||||
"customfield_16072": [{"id": "18678"}],
|
||||
"customfield_15858": {
|
||||
"type": "doc",
|
||||
"version": 1,
|
||||
"content": [
|
||||
{"type": "paragraph", "content": [{"type": "text", "text": "No expected customer impact."}]}
|
||||
]
|
||||
},
|
||||
"customfield_15859": {
|
||||
"type": "doc",
|
||||
"version": 1,
|
||||
"content": [
|
||||
{"type": "paragraph", "content": [{"type": "text", "text": "Remove na11 IP 34.36.175.121 from affected latency-based record sets."}]}
|
||||
]
|
||||
}
|
||||
}
|
||||
}'
|
||||
```
|
||||
Reference in New Issue
Block a user