# Attach Session To Jira

> Attach the current AI session context to a Jira issue as a formatted comment. Useful for investigation, audit trail, handoff, debugging. Use when user says "attach session to Jira", "document on Jira", or "export context to AAP-XXXXX". Use when this capability is needed.

- Skill: `tomevault-io/attach-session-to-jira` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/attach-session-to-jira`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/attach-session-to-jira/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/attach-session-to-jira

---


# Attach Session to Jira

Exports AI session context and attaches it to a Jira issue. Includes session metadata, summary stats, key actions, related issue keys, and optional full transcript.

## Inputs

| Input | Type | Default | Purpose |
|-------|------|---------|---------|
| `issue_key` | string | required | Jira issue key (e.g., AAP-12345) |
| `session_id` | string | "" | Session ID to export. Empty = active session |
| `include_transcript` | bool | false | Include full conversation transcript (collapsible) |

## Workflow

### 1. Validate Issue Key
- Format: `^[A-Z]+-\d+$` (e.g., AAP-12345)
- If invalid: raise error with expected format

### 2. Get Session Info
- `session_info(session_id=session_id)` — Get current/requested session
- If "No Active Session" or "Session Not Found": raise error "Call session_start() first"
- Extract session_id from output if present

### 3. Attach to Jira
- `jira_attach_session(issue_key=validated_issue_key, session_id=session_id, include_transcript=include_transcript)`

### 4. Log
- `memory_session_log(action="Attached session context to {issue_key}", details="Include transcript: {include_transcript}")`

## Output Format

```markdown
{attach_result}

---

## Next Steps
1. **View on Jira:** [AAP-12345](https://issues.redhat.com/browse/AAP-12345)
2. **Export locally:** session_export_context() for markdown/JSON
3. **Share with team:** Link the Jira issue in Slack or email
```

## Error Handling

| Pattern | Message |
|---------|---------|
| Invalid issue key | Expected AAP-12345 format. Got: {input} |
| No active session | Run session_start() first |
| Failed to add comment | Check JIRA_JPAT, issue exists, VPN. Try jira_view_issue() |

## Key MCP Tools

- `session_info`, `jira_attach_session`, `memory_session_log`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/dmzoneill) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->