@codyswann/lisa 1.95.0 → 1.96.0
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/dist/cli/index.d.ts.map +1 -1
- package/dist/cli/index.js +41 -5
- package/dist/cli/index.js.map +1 -1
- package/dist/codex/agent-installer.d.ts +56 -0
- package/dist/codex/agent-installer.d.ts.map +1 -0
- package/dist/codex/agent-installer.js +201 -0
- package/dist/codex/agent-installer.js.map +1 -0
- package/dist/codex/agent-transformer.d.ts +53 -0
- package/dist/codex/agent-transformer.d.ts.map +1 -0
- package/dist/codex/agent-transformer.js +181 -0
- package/dist/codex/agent-transformer.js.map +1 -0
- package/dist/codex/agents-md-installer.d.ts +24 -0
- package/dist/codex/agents-md-installer.d.ts.map +1 -0
- package/dist/codex/agents-md-installer.js +63 -0
- package/dist/codex/agents-md-installer.js.map +1 -0
- package/dist/codex/hooks-installer.d.ts +24 -0
- package/dist/codex/hooks-installer.d.ts.map +1 -0
- package/dist/codex/hooks-installer.js +206 -0
- package/dist/codex/hooks-installer.js.map +1 -0
- package/dist/codex/hooks-merger.d.ts +82 -0
- package/dist/codex/hooks-merger.d.ts.map +1 -0
- package/dist/codex/hooks-merger.js +127 -0
- package/dist/codex/hooks-merger.js.map +1 -0
- package/dist/codex/manifest.d.ts +32 -0
- package/dist/codex/manifest.d.ts.map +1 -0
- package/dist/codex/manifest.js +86 -0
- package/dist/codex/manifest.js.map +1 -0
- package/dist/codex/settings-installer.d.ts +48 -0
- package/dist/codex/settings-installer.d.ts.map +1 -0
- package/dist/codex/settings-installer.js +276 -0
- package/dist/codex/settings-installer.js.map +1 -0
- package/dist/codex/skills-installer.d.ts +46 -0
- package/dist/codex/skills-installer.d.ts.map +1 -0
- package/dist/codex/skills-installer.js +344 -0
- package/dist/codex/skills-installer.js.map +1 -0
- package/dist/core/config.d.ts +19 -0
- package/dist/core/config.d.ts.map +1 -1
- package/dist/core/config.js +13 -0
- package/dist/core/config.js.map +1 -1
- package/dist/core/lisa.d.ts +12 -0
- package/dist/core/lisa.d.ts.map +1 -1
- package/dist/core/lisa.js +48 -0
- package/dist/core/lisa.js.map +1 -1
- package/dist/core/project-config.d.ts +49 -0
- package/dist/core/project-config.d.ts.map +1 -0
- package/dist/core/project-config.js +119 -0
- package/dist/core/project-config.js.map +1 -0
- package/package.json +3 -1
- package/plugins/lisa/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa/agents/jira-build-intake.md +58 -0
- package/plugins/lisa/agents/notion-prd-intake.md +57 -0
- package/plugins/lisa/commands/jira/build-intake.md +7 -0
- package/plugins/lisa/commands/jira/source-artifacts.md +6 -0
- package/plugins/lisa/commands/jira/validate-ticket.md +7 -0
- package/plugins/lisa/commands/notion-prd-intake.md +7 -0
- package/plugins/lisa/commands/prd-ticket-coverage.md +7 -0
- package/plugins/lisa/commands/product-walkthrough.md +7 -0
- package/plugins/lisa/skills/jira-build-intake/SKILL.md +134 -0
- package/plugins/lisa/skills/jira-create/SKILL.md +53 -30
- package/plugins/lisa/skills/jira-source-artifacts/SKILL.md +107 -0
- package/plugins/lisa/skills/jira-validate-ticket/SKILL.md +224 -0
- package/plugins/lisa/skills/jira-verify/SKILL.md +15 -91
- package/plugins/lisa/skills/jira-write-ticket/SKILL.md +20 -15
- package/plugins/lisa/skills/notion-prd-intake/SKILL.md +169 -0
- package/plugins/lisa/skills/notion-to-jira/SKILL.md +137 -95
- package/plugins/lisa/skills/prd-ticket-coverage/SKILL.md +137 -0
- package/plugins/lisa/skills/product-walkthrough/SKILL.md +129 -0
- package/plugins/lisa-cdk/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-expo/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-expo/skills/jira-create/SKILL.md +60 -28
- package/plugins/lisa-expo/skills/jira-verify/SKILL.md +14 -34
- package/plugins/lisa-nestjs/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-rails/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-rails/skills/jira-create/SKILL.md +59 -28
- package/plugins/lisa-rails/skills/jira-verify/SKILL.md +13 -16
- package/plugins/lisa-typescript/.claude-plugin/plugin.json +1 -1
- package/plugins/src/base/agents/jira-build-intake.md +58 -0
- package/plugins/src/base/agents/notion-prd-intake.md +57 -0
- package/plugins/src/base/commands/jira/build-intake.md +7 -0
- package/plugins/src/base/commands/jira/source-artifacts.md +6 -0
- package/plugins/src/base/commands/jira/validate-ticket.md +7 -0
- package/plugins/src/base/commands/notion-prd-intake.md +7 -0
- package/plugins/src/base/commands/prd-ticket-coverage.md +7 -0
- package/plugins/src/base/commands/product-walkthrough.md +7 -0
- package/plugins/src/base/skills/jira-build-intake/SKILL.md +134 -0
- package/plugins/src/base/skills/jira-create/SKILL.md +53 -30
- package/plugins/src/base/skills/jira-source-artifacts/SKILL.md +107 -0
- package/plugins/src/base/skills/jira-validate-ticket/SKILL.md +224 -0
- package/plugins/src/base/skills/jira-verify/SKILL.md +15 -91
- package/plugins/src/base/skills/jira-write-ticket/SKILL.md +20 -15
- package/plugins/src/base/skills/notion-prd-intake/SKILL.md +169 -0
- package/plugins/src/base/skills/notion-to-jira/SKILL.md +137 -95
- package/plugins/src/base/skills/prd-ticket-coverage/SKILL.md +137 -0
- package/plugins/src/base/skills/product-walkthrough/SKILL.md +129 -0
- package/plugins/src/expo/skills/jira-create/SKILL.md +60 -28
- package/plugins/src/expo/skills/jira-verify/SKILL.md +14 -34
- package/plugins/src/rails/skills/jira-create/SKILL.md +59 -28
- package/plugins/src/rails/skills/jira-verify/SKILL.md +13 -16
|
@@ -1,23 +1,27 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: jira-create
|
|
3
3
|
description: This skill should be used when creating JIRA epics, stories, and tasks from code files or descriptions. It analyzes the provided input, determines the appropriate issue hierarchy, and creates issues with comprehensive quality requirements including test-first development and documentation.
|
|
4
|
-
allowed-tools: ["Read", "Glob", "LS", "
|
|
4
|
+
allowed-tools: ["Read", "Glob", "LS", "Skill", "mcp__atlassian__getVisibleJiraProjects", "mcp__atlassian__getJiraProjectIssueTypesMetadata", "mcp__atlassian__getAccessibleAtlassianResources"]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Create JIRA Issues from $ARGUMENTS
|
|
8
8
|
|
|
9
|
-
Analyze the provided file(s) and
|
|
9
|
+
Analyze the provided file(s) and plan a JIRA hierarchy. **This skill plans structure only — every individual ticket write is delegated to `jira-write-ticket`.** Do not call `mcp__atlassian__createJiraIssue` from this skill; the necessary write tools are intentionally not in `allowed-tools`.
|
|
10
10
|
|
|
11
11
|
## Process
|
|
12
12
|
|
|
13
|
-
1. **Analyze**: Read $ARGUMENTS to understand scope
|
|
14
|
-
2. **
|
|
13
|
+
1. **Analyze**: Read $ARGUMENTS to understand scope.
|
|
14
|
+
2. **Extract source artifacts**: invoke the `jira-source-artifacts` skill, then enumerate every external URL, embed, attachment, or example payload and classify each by domain per its rules. Build the `artifacts` map. See "Source Artifacts" below.
|
|
15
|
+
3. **Walk the live product** (when applicable): if the work touches existing user-facing surfaces, invoke the `product-walkthrough` skill to capture current behavior, design-vs-product divergence, and reuse candidates. Especially load-bearing for Expo/React Native — a UI ticket without a current-product walkthrough is missing context the implementer needs. Skip only when the work is purely backend or affects a screen that does not yet exist. See "Live Product Walkthrough" below.
|
|
16
|
+
4. **Determine structure**:
|
|
15
17
|
- Epic needed if: multiple features, major changes, >3 related files
|
|
16
18
|
- Direct tasks if: bug fix, single file, minor change
|
|
17
|
-
|
|
18
|
-
```
|
|
19
|
+
5. **Plan hierarchy**:
|
|
20
|
+
```text
|
|
19
21
|
Epic → User Story → Tasks (test, implement, document, cleanup)
|
|
20
22
|
```
|
|
23
|
+
6. **Delegate every write to `jira-write-ticket`** in dependency order (epic first, then stories with the epic as parent, then sub-tasks with their story as parent). Pass the artifacts (filtered by domain per `jira-source-artifacts` inheritance rules), the walkthrough findings (under `## Current Product`), and — for UI tickets — the Validation Journey draft with `[SCREENSHOT: ...]` markers. See "Delegation to jira-write-ticket" below.
|
|
24
|
+
7. **Run the artifact preservation gate** (`jira-source-artifacts` §8): after all writes complete, build the preservation matrix and verify every extracted artifact is reachable from the created tickets. Fail loudly if anything was dropped.
|
|
21
25
|
|
|
22
26
|
## Mandatory for Every Code Issue
|
|
23
27
|
|
|
@@ -87,33 +91,19 @@ h3. Assertions
|
|
|
87
91
|
6. **Prerequisites include feature flags** — If the feature is behind a PostHog flag, name it explicitly
|
|
88
92
|
7. **Auth steps included when needed** — If the journey requires login, include the test credentials in Prerequisites
|
|
89
93
|
|
|
90
|
-
## Source
|
|
91
|
-
|
|
92
|
-
If $ARGUMENTS includes a PRD, design doc, Figma URL, Lovable prototype, or similar external artifact — or if a referenced file links out to one — those references MUST be preserved as remote links on the created tickets. Dropping source artifacts during ticket creation is the single most common quality failure in this pipeline, because developers picking up a ticket then lose the design/UX source of truth.
|
|
94
|
+
## Source Artifacts
|
|
93
95
|
|
|
94
|
-
|
|
96
|
+
If $ARGUMENTS includes (or references) any external artifact — PRD, design doc, Figma URL, Lovable prototype, Loom walkthrough, screenshot, example payload — those references MUST be preserved as remote links on the created tickets. Silent artifact loss is the single most common quality failure in this pipeline.
|
|
95
97
|
|
|
96
|
-
|
|
97
|
-
2. **Epic gets everything**: attach all extracted artifacts as remote links on the epic, regardless of domain.
|
|
98
|
-
3. **Stories inherit by domain**: frontend/Expo stories get `ui-design` + `ux-flow` + `reference`; backend gets `data` + `reference`; infra gets `ops` + `reference`. When ambiguous, err on the side of inclusion.
|
|
99
|
-
4. **Sub-tasks inherit via parent**: do not re-attach on every sub-task unless a specific artifact applies only to that sub-task.
|
|
100
|
-
5. **Verify before reporting**: before declaring done, confirm every extracted artifact is reachable from the tickets. If any are missing, fail loudly and surface the dropped list to the human — do not silently drop.
|
|
98
|
+
**Invoke the `jira-source-artifacts` skill** for the canonical rules: domains, per-tool classification (Figma `/proto/` vs design, Lovable, Loom, screenshots), source precedence, conflict handling under `## Open Questions`, inheritance from epic → story → sub-task, and the existing-component reuse expectation. Do not restate the rules here.
|
|
101
99
|
|
|
102
|
-
|
|
100
|
+
Expo-specific note: the existing-component reuse rule is especially load-bearing for React Native — the project has an established component library; pixel-matching a mock instead of reusing components is the most common drift mode.
|
|
103
101
|
|
|
104
|
-
|
|
105
|
-
- Figma URL with `/proto/` or `starting-point-node-id=` → `ux-flow`; plain design frame URL → `ui-design`.
|
|
106
|
-
- Lovable output → always `ux-flow` (its code/styling/logic is NOT authoritative).
|
|
107
|
-
- Loom / annotated screenshot with flow arrows → `ux-flow`; bare screenshot → `ui-design`.
|
|
102
|
+
When delegating writes to `jira-write-ticket`, pass the extracted artifact list so its Phase 4c step can attach them.
|
|
108
103
|
|
|
109
|
-
|
|
110
|
-
- Business rules (fields, validation, permissions, constraints) come from the **description / PRD body**.
|
|
111
|
-
- Visual treatment (layout, spacing, typography, color) comes from **mocks** (`ui-design`).
|
|
112
|
-
- Flow and interaction (navigation, transitions, state changes, empty/error/loading states) come from **prototypes** (`ux-flow`).
|
|
113
|
-
- API / data shape comes from **`data` artifacts**.
|
|
114
|
-
- Cross-axis conflicts are surfaced as `## Open Questions` BLOCKERs, never silently reconciled.
|
|
104
|
+
## Live Product Walkthrough
|
|
115
105
|
|
|
116
|
-
|
|
106
|
+
When the work touches existing user-facing surfaces, invoke the `product-walkthrough` skill before drafting tickets. Findings (current behavior, design-vs-product divergence, reuse candidates, behavioral surprises) become inputs to the ticket plan and surface under `## Current Product` on the resulting tickets, complementing the Validation Journey (which describes how to verify the *new* behavior, not what exists today). Skip only when the work is purely backend or affects a screen that does not yet exist.
|
|
117
107
|
|
|
118
108
|
## Issue Requirements
|
|
119
109
|
|
|
@@ -126,4 +116,46 @@ Each issue must clearly communicate to:
|
|
|
126
116
|
Default project: from jira-cli config (override via arguments)
|
|
127
117
|
Exclude unless requested: migration plans, performance tests
|
|
128
118
|
|
|
129
|
-
|
|
119
|
+
## Delegation to jira-write-ticket
|
|
120
|
+
|
|
121
|
+
**Mandatory.** Every ticket created by this skill MUST go through `jira-write-ticket`. This skill never calls `mcp__atlassian__createJiraIssue` itself — that tool is intentionally excluded from `allowed-tools` so the gate cannot be bypassed.
|
|
122
|
+
|
|
123
|
+
`jira-write-ticket` enforces things this skill does not, and which determine ticket quality:
|
|
124
|
+
- 3-audience description (Context / Technical Approach / Acceptance Criteria)
|
|
125
|
+
- Gherkin acceptance criteria
|
|
126
|
+
- Epic parent validation (non-bug, non-epic types)
|
|
127
|
+
- Explicit link discovery (`blocks` / `is blocked by` / `relates to` / `duplicates` / `clones`)
|
|
128
|
+
- Remote links (PRs, Confluence, dashboards)
|
|
129
|
+
- Single-repo scope check for Bug / Task / Sub-task
|
|
130
|
+
- Sign-in account and target environment recorded in description
|
|
131
|
+
- Post-create verification
|
|
132
|
+
|
|
133
|
+
### Invocation order
|
|
134
|
+
|
|
135
|
+
Tickets must be created in parent-before-child order so each child can be passed its parent key:
|
|
136
|
+
|
|
137
|
+
1. Invoke `jira-write-ticket` for the epic. Capture the returned key.
|
|
138
|
+
2. For each story, invoke `jira-write-ticket` with the epic key as the epic parent. Capture each story key.
|
|
139
|
+
3. For each sub-task, invoke `jira-write-ticket` with the parent story key.
|
|
140
|
+
|
|
141
|
+
### What to pass to each invocation
|
|
142
|
+
|
|
143
|
+
For every delegated write, pass:
|
|
144
|
+
- The summary, issue type, project key, and priority you decided
|
|
145
|
+
- The 3-section description body you drafted (Context / Technical Approach / Acceptance Criteria)
|
|
146
|
+
- Gherkin acceptance criteria
|
|
147
|
+
- Parent key (epic key for stories; story key for sub-tasks)
|
|
148
|
+
- The artifact list extracted in "Source Artifacts", filtered by domain per the inheritance rules — `jira-write-ticket` Phase 4c attaches them as remote links
|
|
149
|
+
- For UI-touching tickets: the Validation Journey draft (with `[SCREENSHOT: ...]` markers, viewports, and feature-flag prerequisites). If the journey is missing, instruct it to call `jira-add-journey` after create.
|
|
150
|
+
|
|
151
|
+
### What this skill is responsible for
|
|
152
|
+
|
|
153
|
+
This skill owns:
|
|
154
|
+
- Deciding the *shape* of the hierarchy (what's an epic vs. story vs. sub-task)
|
|
155
|
+
- Drafting the description body and acceptance criteria from the input
|
|
156
|
+
- Extracting and classifying source artifacts
|
|
157
|
+
- Threading parent keys through subsequent writes
|
|
158
|
+
- Drafting the Validation Journey for UI tickets (this is Expo-specific guidance the base skill doesn't have)
|
|
159
|
+
- Running the artifact preservation check after all writes complete
|
|
160
|
+
|
|
161
|
+
It does not own the actual JIRA write — that's `jira-write-ticket`'s job.
|
|
@@ -1,47 +1,27 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: jira-verify
|
|
3
|
-
description: This skill should be used when verifying that a JIRA ticket meets organizational standards for epic relationships and
|
|
4
|
-
allowed-tools: ["
|
|
3
|
+
description: This skill should be used when verifying that a JIRA ticket meets organizational standards for epic relationships, description quality, and (for UI tickets) Validation Journey presence. It fetches the live ticket and delegates the gate checks to jira-validate-ticket so the bar matches what jira-write-ticket enforces pre-write.
|
|
4
|
+
allowed-tools: ["Skill", "mcp__atlassian__getJiraIssue", "mcp__atlassian__getAccessibleAtlassianResources"]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Verify JIRA Ticket: $ARGUMENTS
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
Verify that the existing JIRA ticket `$ARGUMENTS` meets organizational standards. This skill is a thin post-write wrapper around `jira-validate-ticket`: it fetches the live ticket and asks `jira-validate-ticket` to run the gates against the fetched state.
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
This indirection exists so the gate definitions live in exactly one place (`jira-validate-ticket`). When the bar changes, change it there — `jira-verify`, `jira-write-ticket` (Phase 5.5 pre-write), and `notion-to-jira` (PRD dry-run) all pick it up.
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
## Process
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
1. Resolve cloud ID via `mcp__atlassian__getAccessibleAtlassianResources`.
|
|
16
|
+
2. Fetch the ticket via `mcp__atlassian__getJiraIssue` for `$ARGUMENTS`.
|
|
17
|
+
3. Invoke `jira-validate-ticket` and pass the ticket key. The validator runs every gate (Specification + Feasibility) against the live state, including the Validation Journey check (S11) which applies to any runtime-behavior change — UI tickets in Expo always qualify.
|
|
18
|
+
4. Surface the validator's report verbatim.
|
|
16
19
|
|
|
17
|
-
|
|
20
|
+
## Output
|
|
18
21
|
|
|
19
|
-
|
|
22
|
+
Pass through `jira-validate-ticket`'s structured output unchanged. Downstream callers parse the gate lines.
|
|
20
23
|
|
|
21
|
-
|
|
24
|
+
## Notes
|
|
22
25
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
**Stakeholders**: Business value, user impact, success metrics, summary
|
|
26
|
-
|
|
27
|
-
### 3. Validation Journey (Frontend Tickets)
|
|
28
|
-
|
|
29
|
-
**Rule**: Tickets that touch UI (components, labels, or description mentioning frontend, UI, modal, layout, responsive, screen, page, button, form) MUST include a Validation Journey section.
|
|
30
|
-
|
|
31
|
-
Check by running:
|
|
32
|
-
|
|
33
|
-
```bash
|
|
34
|
-
python3 .claude/skills/jira-journey/scripts/parse-plan.py <TICKET_ID> 2>&1
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
- If the parser returns steps: PASS
|
|
38
|
-
- If the parser fails with "No 'Validation Journey' section found": FAIL — recommend using `/jira-add-journey <TICKET_ID>` to add one
|
|
39
|
-
|
|
40
|
-
This check is skipped for:
|
|
41
|
-
- Pure backend/API tickets (no UI surface)
|
|
42
|
-
- Config-only tickets (env vars, feature flags, CI/CD)
|
|
43
|
-
- Epic-level tickets (journeys belong on child stories/tasks)
|
|
44
|
-
|
|
45
|
-
## Execute Verification
|
|
46
|
-
|
|
47
|
-
Retrieve ticket details, run all checks, and provide specific improvement recommendations for any failures.
|
|
26
|
+
- This skill is read-only. It never edits the ticket, posts comments, or changes status.
|
|
27
|
+
- For UI tickets that fail the Validation Journey gate, the validator's remediation will recommend `/jira-add-journey` — the Expo flavor of `jira-add-journey` produces the `[SCREENSHOT: ...]` + viewport block that the Playwright-based journey runner consumes.
|
|
@@ -1,23 +1,27 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: jira-create
|
|
3
3
|
description: This skill should be used when creating JIRA epics, stories, and tasks from code files or descriptions. It analyzes the provided input, determines the appropriate issue hierarchy, and creates issues with comprehensive quality requirements including test-first development and documentation.
|
|
4
|
-
allowed-tools: ["Read", "Glob", "LS", "
|
|
4
|
+
allowed-tools: ["Read", "Glob", "LS", "Skill", "mcp__atlassian__getVisibleJiraProjects", "mcp__atlassian__getJiraProjectIssueTypesMetadata", "mcp__atlassian__getAccessibleAtlassianResources"]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Create JIRA Issues from $ARGUMENTS
|
|
8
8
|
|
|
9
|
-
Analyze the provided file(s) and
|
|
9
|
+
Analyze the provided file(s) and plan a JIRA hierarchy. **This skill plans structure only — every individual ticket write is delegated to `jira-write-ticket`.** Do not call `mcp__atlassian__createJiraIssue` from this skill; the necessary write tools are intentionally not in `allowed-tools`.
|
|
10
10
|
|
|
11
11
|
## Process
|
|
12
12
|
|
|
13
|
-
1. **Analyze**: Read $ARGUMENTS to understand scope
|
|
14
|
-
2. **
|
|
13
|
+
1. **Analyze**: Read $ARGUMENTS to understand scope.
|
|
14
|
+
2. **Extract source artifacts**: invoke the `jira-source-artifacts` skill, then enumerate every external URL, embed, attachment, or example payload and classify each by domain per its rules. Build the `artifacts` map. See "Source Artifacts" below.
|
|
15
|
+
3. **Walk the live product** (when applicable): if the work touches existing user-facing surfaces, invoke the `product-walkthrough` skill to capture current behavior, design-vs-product divergence, and reuse candidates. Skip only when the work is purely backend or affects a screen that does not yet exist. See "Live Product Walkthrough" below.
|
|
16
|
+
4. **Determine structure**:
|
|
15
17
|
- Epic needed if: multiple features, major changes, >3 related files
|
|
16
18
|
- Direct tasks if: bug fix, single file, minor change
|
|
17
|
-
|
|
18
|
-
```
|
|
19
|
+
5. **Plan hierarchy**:
|
|
20
|
+
```text
|
|
19
21
|
Epic → User Story → Tasks (test, implement, document, cleanup)
|
|
20
22
|
```
|
|
23
|
+
6. **Delegate every write to `jira-write-ticket`** in dependency order (epic first, then stories with the epic as parent, then sub-tasks with their story as parent). Pass the artifacts (filtered by domain per `jira-source-artifacts` inheritance rules) and the walkthrough findings (under `## Current Product`). See "Delegation to jira-write-ticket" below.
|
|
24
|
+
7. **Run the artifact preservation gate** (`jira-source-artifacts` §8): after all writes complete, build the preservation matrix and verify every extracted artifact is reachable from the created tickets. Fail loudly if anything was dropped.
|
|
21
25
|
|
|
22
26
|
## Mandatory for Every Code Issue
|
|
23
27
|
|
|
@@ -27,33 +31,19 @@ Analyze the provided file(s) and create a comprehensive JIRA hierarchy with all
|
|
|
27
31
|
**Feature Flags**: All features behind flags with lifecycle plan
|
|
28
32
|
**Cleanup**: Remove temporary code, scripts, dev configs
|
|
29
33
|
|
|
30
|
-
## Source
|
|
31
|
-
|
|
32
|
-
If $ARGUMENTS includes a PRD, design doc, Figma URL, Lovable prototype, or similar external artifact — or if a referenced file links out to one — those references MUST be preserved as remote links on the created tickets. Dropping source artifacts during ticket creation is the single most common quality failure in this pipeline, because developers picking up a ticket then lose the design/UX source of truth.
|
|
34
|
+
## Source Artifacts
|
|
33
35
|
|
|
34
|
-
|
|
36
|
+
If $ARGUMENTS includes (or references) any external artifact — PRD, design doc, Figma URL, Lovable prototype, Loom walkthrough, screenshot, example payload — those references MUST be preserved as remote links on the created tickets. Silent artifact loss is the single most common quality failure in this pipeline.
|
|
35
37
|
|
|
36
|
-
|
|
37
|
-
2. **Epic gets everything**: attach all extracted artifacts as remote links on the epic, regardless of domain.
|
|
38
|
-
3. **Stories inherit by domain**: frontend/view stories get `ui-design` + `ux-flow` + `reference`; backend/model/controller stories get `data` + `reference`; infra stories get `ops` + `reference`. When ambiguous, err on the side of inclusion.
|
|
39
|
-
4. **Sub-tasks inherit via parent**: do not re-attach on every sub-task unless a specific artifact applies only to that sub-task.
|
|
40
|
-
5. **Verify before reporting**: before declaring done, confirm every extracted artifact is reachable from the tickets. If any are missing, fail loudly and surface the dropped list to the human — do not silently drop.
|
|
38
|
+
**Invoke the `jira-source-artifacts` skill** for the canonical rules: domains, per-tool classification (Figma `/proto/` vs design, Lovable, Loom, screenshots), source precedence, conflict handling under `## Open Questions`, inheritance from epic → story → sub-task, and the existing-component reuse expectation. Do not restate the rules here.
|
|
41
39
|
|
|
42
|
-
|
|
40
|
+
Rails-specific note: the existing-component reuse rule applies to view partials and ViewComponents — the closest existing partial/component is usually the right answer over pixel-matching a mock from scratch.
|
|
43
41
|
|
|
44
|
-
|
|
45
|
-
- Figma URL with `/proto/` or `starting-point-node-id=` → `ux-flow`; plain design frame URL → `ui-design`.
|
|
46
|
-
- Lovable output → always `ux-flow` (its code/styling/logic is NOT authoritative).
|
|
47
|
-
- Loom / annotated screenshot with flow arrows → `ux-flow`; bare screenshot → `ui-design`.
|
|
42
|
+
When delegating writes to `jira-write-ticket`, pass the extracted artifact list so its Phase 4c step can attach them.
|
|
48
43
|
|
|
49
|
-
|
|
50
|
-
- Business rules (fields, validation, permissions, constraints) come from the **description / PRD body**.
|
|
51
|
-
- Visual treatment (layout, spacing, typography, color) comes from **mocks** (`ui-design`).
|
|
52
|
-
- Flow and interaction (navigation, transitions, state changes, empty/error/loading states) come from **prototypes** (`ux-flow`).
|
|
53
|
-
- API / data shape comes from **`data` artifacts**.
|
|
54
|
-
- Cross-axis conflicts are surfaced as `## Open Questions` BLOCKERs, never silently reconciled.
|
|
44
|
+
## Live Product Walkthrough
|
|
55
45
|
|
|
56
|
-
|
|
46
|
+
When the work touches existing user-facing surfaces, invoke the `product-walkthrough` skill before drafting tickets. Findings (current behavior, design-vs-product divergence, reuse candidates, behavioral surprises) become inputs to the ticket plan and surface under `## Current Product` on the resulting tickets. Skip only when the work is purely backend or affects a screen that does not yet exist.
|
|
57
47
|
|
|
58
48
|
## Issue Requirements
|
|
59
49
|
|
|
@@ -66,4 +56,45 @@ Each issue must clearly communicate to:
|
|
|
66
56
|
Default project: SE (override via arguments)
|
|
67
57
|
Exclude unless requested: migration plans, performance tests
|
|
68
58
|
|
|
69
|
-
|
|
59
|
+
## Delegation to jira-write-ticket
|
|
60
|
+
|
|
61
|
+
**Mandatory.** Every ticket created by this skill MUST go through `jira-write-ticket`. This skill never calls `mcp__atlassian__createJiraIssue` itself — that tool is intentionally excluded from `allowed-tools` so the gate cannot be bypassed.
|
|
62
|
+
|
|
63
|
+
`jira-write-ticket` enforces things this skill does not, and which determine ticket quality:
|
|
64
|
+
- 3-audience description (Context / Technical Approach / Acceptance Criteria)
|
|
65
|
+
- Gherkin acceptance criteria
|
|
66
|
+
- Epic parent validation (non-bug, non-epic types)
|
|
67
|
+
- Explicit link discovery (`blocks` / `is blocked by` / `relates to` / `duplicates` / `clones`)
|
|
68
|
+
- Remote links (PRs, Confluence, dashboards)
|
|
69
|
+
- Single-repo scope check for Bug / Task / Sub-task
|
|
70
|
+
- Sign-in account and target environment recorded in description
|
|
71
|
+
- Post-create verification
|
|
72
|
+
|
|
73
|
+
### Invocation order
|
|
74
|
+
|
|
75
|
+
Tickets must be created in parent-before-child order so each child can be passed its parent key:
|
|
76
|
+
|
|
77
|
+
1. Invoke `jira-write-ticket` for the epic. Capture the returned key.
|
|
78
|
+
2. For each story, invoke `jira-write-ticket` with the epic key as the epic parent. Capture each story key.
|
|
79
|
+
3. For each sub-task, invoke `jira-write-ticket` with the parent story key.
|
|
80
|
+
|
|
81
|
+
### What to pass to each invocation
|
|
82
|
+
|
|
83
|
+
For every delegated write, pass:
|
|
84
|
+
- The summary, issue type, project key, and priority you decided
|
|
85
|
+
- The 3-section description body you drafted (Context / Technical Approach / Acceptance Criteria)
|
|
86
|
+
- Gherkin acceptance criteria
|
|
87
|
+
- Parent key (epic key for stories; story key for sub-tasks)
|
|
88
|
+
- The artifact list extracted in "Source Artifacts", filtered by domain per the inheritance rules — `jira-write-ticket` Phase 4c attaches them as remote links
|
|
89
|
+
- For tickets that change runtime behavior: the Validation Journey draft, or instruct it to call `jira-add-journey` after create
|
|
90
|
+
|
|
91
|
+
### What this skill is responsible for
|
|
92
|
+
|
|
93
|
+
This skill owns:
|
|
94
|
+
- Deciding the *shape* of the hierarchy (what's an epic vs. story vs. sub-task)
|
|
95
|
+
- Drafting the description body and acceptance criteria from the input
|
|
96
|
+
- Extracting and classifying source artifacts
|
|
97
|
+
- Threading parent keys through subsequent writes
|
|
98
|
+
- Running the artifact preservation check after all writes complete
|
|
99
|
+
|
|
100
|
+
It does not own the actual JIRA write — that's `jira-write-ticket`'s job.
|
|
@@ -1,29 +1,26 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: jira-verify
|
|
3
|
-
description: This skill should be used when verifying that a JIRA ticket meets organizational standards for epic relationships and description quality. It
|
|
4
|
-
allowed-tools: ["
|
|
3
|
+
description: This skill should be used when verifying that a JIRA ticket meets organizational standards for epic relationships and description quality. It fetches the live ticket and delegates the gate checks to jira-validate-ticket so the bar matches what jira-write-ticket enforces pre-write.
|
|
4
|
+
allowed-tools: ["Skill", "mcp__atlassian__getJiraIssue", "mcp__atlassian__getAccessibleAtlassianResources"]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Verify JIRA Ticket: $ARGUMENTS
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
Verify that the existing JIRA ticket `$ARGUMENTS` meets organizational standards. This skill is a thin post-write wrapper around `jira-validate-ticket`: it fetches the live ticket and asks `jira-validate-ticket` to run the gates against the fetched state.
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
This indirection exists so the gate definitions live in exactly one place (`jira-validate-ticket`). When the bar changes, change it there — `jira-verify`, `jira-write-ticket` (Phase 5.5 pre-write), and `notion-to-jira` (PRD dry-run) all pick it up.
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
## Process
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
1. Resolve cloud ID via `mcp__atlassian__getAccessibleAtlassianResources`.
|
|
16
|
+
2. Fetch the ticket via `mcp__atlassian__getJiraIssue` for `$ARGUMENTS`.
|
|
17
|
+
3. Invoke `jira-validate-ticket` and pass the ticket key. The validator runs every gate (Specification + Feasibility) against the live state.
|
|
18
|
+
4. Surface the validator's report verbatim.
|
|
16
19
|
|
|
17
|
-
|
|
20
|
+
## Output
|
|
18
21
|
|
|
19
|
-
|
|
22
|
+
Pass through `jira-validate-ticket`'s structured output unchanged. Downstream callers parse the gate lines.
|
|
20
23
|
|
|
21
|
-
|
|
24
|
+
## Notes
|
|
22
25
|
|
|
23
|
-
|
|
24
|
-
**Developers**: Technical context, integration points, testing, edge cases
|
|
25
|
-
**Stakeholders**: Business value, user impact, success metrics, summary
|
|
26
|
-
|
|
27
|
-
## Execute Verification
|
|
28
|
-
|
|
29
|
-
Retrieve ticket details, run both checks, and provide specific improvement recommendations for any failures.
|
|
26
|
+
- This skill is read-only. It never edits the ticket, posts comments, or changes status.
|