# Changelog — @cleepi/atlassian

All notable changes to this package are documented here.

Format: [Keep a Changelog 1.1.0](https://keepachangelog.com/en/1.1.0/).
Versioning: [SemVer](https://semver.org/spec/v2.0.0.html). Pre-`1.0.0`, minor
bumps may include breaking changes.

## [Unreleased]

## [0.2.0] — 2026-06-02

First release that actually exposes the skill + prompt promised by
the original 0.1.0 scaffold. `0.1.0` shipped to npm with `SPEC.md`,
`README.md`, `CHANGELOG.md`, and `mcp.example.json` only — no
runnable surface. `0.2.0` ships the runnable surface.

### Added
- `skills/atlassian/SKILL.md` — field-to-spec-section map,
  ignore-list, honest-degradation guidance. Per
  [DRAFT-004](../../docs/DRAFT-004-natural-language-ticket-flow/spec.md).
- `prompts/spec-from-ticket.md` — `/spec-from-ticket <KEY|URL>`
  flow with self-tiering (easy → `/spec`, hard →
  `/spec-with-crew`) and `--with-crew` / `--simple` overrides.
  Soft-aware of `@cleepi/sdd` and `@cleepi/crew`. Per
  [DRAFT-004](../../docs/DRAFT-004-natural-language-ticket-flow/spec.md).

### Changed
- `SPEC.md` status flipped `draft → accepted` now that the
  promised skill and prompt actually exist. Added a `## Decision`
  section summarising ADRs 0005 and 0006 plus the new
  self-tiering decision from DRAFT-004 (per @cleepi/sdd v0.2.0+).

[0.2.0]: https://github.com/honzanemecek/cleepi/releases/tag/%40cleepi%2Fatlassian%400.2.0

## [0.1.0] — 2026-05-24

### Added
- Initial package scaffold per
  [spec 0003](../../docs/specs/0003-cleepi-atlassian-v0.1.0-mcp.md),
  amended by [ADR 0006](../../docs/adr/0006-allow-writes-in-atlassian-v0.1.0.md).
- `mcp.example.json` — copy/paste MCP server config for the Atlassian
  Rovo MCP server, with OAuth and a curated `directTools` allowlist
  covering reads (`getJiraIssue`, `searchJiraIssuesUsingJql`,
  `getConfluencePage`, …) plus the useful Jira writes
  (`createJiraIssue`, `editJiraIssue`, `transitionJiraIssue`,
  `addCommentToJiraIssue`) and the metadata helpers needed to use
  them. The pi-mcp-adapter `mcp` proxy is enabled for exploration.
  Per ADR 0006, write safety is enforced upstream by the org admin's
  permission-group toggles in *Atlassian Administration → Rovo MCP
  server*, not by this snippet.
- `SPEC.md`, `README.md`, `CHANGELOG.md`.

### Pending (delivered in 0.2.0)
- `skills/atlassian/SKILL.md` — see 0.2.0.
- `prompts/spec-from-ticket.md` — see 0.2.0.

[0.1.0]: https://github.com/honzanemecek/cleepi/releases/tag/%40cleepi%2Fatlassian%400.1.0

### Notes
- No `0.1.0` tag yet — skill and prompt content are still pending.
  Spec status flips to `shipped` when both land and `/spec-from-ticket`
  has been smoke-tested against a real Cleevio ticket.

[Unreleased]: https://github.com/cleevio/cleepi/compare/atlassian-v0.0.0...HEAD