@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.
Files changed (98) hide show
  1. package/dist/cli/index.d.ts.map +1 -1
  2. package/dist/cli/index.js +41 -5
  3. package/dist/cli/index.js.map +1 -1
  4. package/dist/codex/agent-installer.d.ts +56 -0
  5. package/dist/codex/agent-installer.d.ts.map +1 -0
  6. package/dist/codex/agent-installer.js +201 -0
  7. package/dist/codex/agent-installer.js.map +1 -0
  8. package/dist/codex/agent-transformer.d.ts +53 -0
  9. package/dist/codex/agent-transformer.d.ts.map +1 -0
  10. package/dist/codex/agent-transformer.js +181 -0
  11. package/dist/codex/agent-transformer.js.map +1 -0
  12. package/dist/codex/agents-md-installer.d.ts +24 -0
  13. package/dist/codex/agents-md-installer.d.ts.map +1 -0
  14. package/dist/codex/agents-md-installer.js +63 -0
  15. package/dist/codex/agents-md-installer.js.map +1 -0
  16. package/dist/codex/hooks-installer.d.ts +24 -0
  17. package/dist/codex/hooks-installer.d.ts.map +1 -0
  18. package/dist/codex/hooks-installer.js +206 -0
  19. package/dist/codex/hooks-installer.js.map +1 -0
  20. package/dist/codex/hooks-merger.d.ts +82 -0
  21. package/dist/codex/hooks-merger.d.ts.map +1 -0
  22. package/dist/codex/hooks-merger.js +127 -0
  23. package/dist/codex/hooks-merger.js.map +1 -0
  24. package/dist/codex/manifest.d.ts +32 -0
  25. package/dist/codex/manifest.d.ts.map +1 -0
  26. package/dist/codex/manifest.js +86 -0
  27. package/dist/codex/manifest.js.map +1 -0
  28. package/dist/codex/settings-installer.d.ts +48 -0
  29. package/dist/codex/settings-installer.d.ts.map +1 -0
  30. package/dist/codex/settings-installer.js +276 -0
  31. package/dist/codex/settings-installer.js.map +1 -0
  32. package/dist/codex/skills-installer.d.ts +46 -0
  33. package/dist/codex/skills-installer.d.ts.map +1 -0
  34. package/dist/codex/skills-installer.js +344 -0
  35. package/dist/codex/skills-installer.js.map +1 -0
  36. package/dist/core/config.d.ts +19 -0
  37. package/dist/core/config.d.ts.map +1 -1
  38. package/dist/core/config.js +13 -0
  39. package/dist/core/config.js.map +1 -1
  40. package/dist/core/lisa.d.ts +12 -0
  41. package/dist/core/lisa.d.ts.map +1 -1
  42. package/dist/core/lisa.js +48 -0
  43. package/dist/core/lisa.js.map +1 -1
  44. package/dist/core/project-config.d.ts +49 -0
  45. package/dist/core/project-config.d.ts.map +1 -0
  46. package/dist/core/project-config.js +119 -0
  47. package/dist/core/project-config.js.map +1 -0
  48. package/package.json +3 -1
  49. package/plugins/lisa/.claude-plugin/plugin.json +1 -1
  50. package/plugins/lisa/agents/jira-build-intake.md +58 -0
  51. package/plugins/lisa/agents/notion-prd-intake.md +57 -0
  52. package/plugins/lisa/commands/jira/build-intake.md +7 -0
  53. package/plugins/lisa/commands/jira/source-artifacts.md +6 -0
  54. package/plugins/lisa/commands/jira/validate-ticket.md +7 -0
  55. package/plugins/lisa/commands/notion-prd-intake.md +7 -0
  56. package/plugins/lisa/commands/prd-ticket-coverage.md +7 -0
  57. package/plugins/lisa/commands/product-walkthrough.md +7 -0
  58. package/plugins/lisa/skills/jira-build-intake/SKILL.md +134 -0
  59. package/plugins/lisa/skills/jira-create/SKILL.md +53 -30
  60. package/plugins/lisa/skills/jira-source-artifacts/SKILL.md +107 -0
  61. package/plugins/lisa/skills/jira-validate-ticket/SKILL.md +224 -0
  62. package/plugins/lisa/skills/jira-verify/SKILL.md +15 -91
  63. package/plugins/lisa/skills/jira-write-ticket/SKILL.md +20 -15
  64. package/plugins/lisa/skills/notion-prd-intake/SKILL.md +169 -0
  65. package/plugins/lisa/skills/notion-to-jira/SKILL.md +137 -95
  66. package/plugins/lisa/skills/prd-ticket-coverage/SKILL.md +137 -0
  67. package/plugins/lisa/skills/product-walkthrough/SKILL.md +129 -0
  68. package/plugins/lisa-cdk/.claude-plugin/plugin.json +1 -1
  69. package/plugins/lisa-expo/.claude-plugin/plugin.json +1 -1
  70. package/plugins/lisa-expo/skills/jira-create/SKILL.md +60 -28
  71. package/plugins/lisa-expo/skills/jira-verify/SKILL.md +14 -34
  72. package/plugins/lisa-nestjs/.claude-plugin/plugin.json +1 -1
  73. package/plugins/lisa-rails/.claude-plugin/plugin.json +1 -1
  74. package/plugins/lisa-rails/skills/jira-create/SKILL.md +59 -28
  75. package/plugins/lisa-rails/skills/jira-verify/SKILL.md +13 -16
  76. package/plugins/lisa-typescript/.claude-plugin/plugin.json +1 -1
  77. package/plugins/src/base/agents/jira-build-intake.md +58 -0
  78. package/plugins/src/base/agents/notion-prd-intake.md +57 -0
  79. package/plugins/src/base/commands/jira/build-intake.md +7 -0
  80. package/plugins/src/base/commands/jira/source-artifacts.md +6 -0
  81. package/plugins/src/base/commands/jira/validate-ticket.md +7 -0
  82. package/plugins/src/base/commands/notion-prd-intake.md +7 -0
  83. package/plugins/src/base/commands/prd-ticket-coverage.md +7 -0
  84. package/plugins/src/base/commands/product-walkthrough.md +7 -0
  85. package/plugins/src/base/skills/jira-build-intake/SKILL.md +134 -0
  86. package/plugins/src/base/skills/jira-create/SKILL.md +53 -30
  87. package/plugins/src/base/skills/jira-source-artifacts/SKILL.md +107 -0
  88. package/plugins/src/base/skills/jira-validate-ticket/SKILL.md +224 -0
  89. package/plugins/src/base/skills/jira-verify/SKILL.md +15 -91
  90. package/plugins/src/base/skills/jira-write-ticket/SKILL.md +20 -15
  91. package/plugins/src/base/skills/notion-prd-intake/SKILL.md +169 -0
  92. package/plugins/src/base/skills/notion-to-jira/SKILL.md +137 -95
  93. package/plugins/src/base/skills/prd-ticket-coverage/SKILL.md +137 -0
  94. package/plugins/src/base/skills/product-walkthrough/SKILL.md +129 -0
  95. package/plugins/src/expo/skills/jira-create/SKILL.md +60 -28
  96. package/plugins/src/expo/skills/jira-verify/SKILL.md +14 -34
  97. package/plugins/src/rails/skills/jira-create/SKILL.md +59 -28
  98. 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", "mcp__atlassian__createJiraIssue", "mcp__atlassian__getVisibleJiraProjects", "mcp__atlassian__getJiraProjectIssueTypesMetadata", "mcp__atlassian__getAccessibleAtlassianResources"]
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 create a comprehensive JIRA hierarchy with all mandatory quality gates.
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. **Determine Structure**:
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
- 3. **Create Issues** with hierarchy:
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 Artifact Preservation
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
- Rules:
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
- 1. **Extract before creating**: enumerate every external URL, embed, attachment, or example payload in the input. Classify by domain (`ui-design`, `ux-flow`, `data`, `ops`, `reference`) see `notion-to-jira` Phase 1.5 for the canonical taxonomy.
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
- When delegating actual writes to `jira-write-ticket`, pass the extracted artifact list so its Phase 4c (Remote Links) step can attach them.
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
- **Classification disambiguation** (applied during extraction):
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
- **Source precedence** (must be recorded on every ticket carrying design artifacts):
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
- **Existing-component reuse** (applies to every UI-touching ticket especially relevant for Expo/React Native with its established component library): the story description must instruct the implementer to locate the closest existing component in the codebase and prefer reuse over pixel-matching a mock. Design-vs-code divergence is raised on the ticket, not resolved by the implementer alone.
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
- Execute the analysis and create the complete JIRA structure with proper parent-child relationships.
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 description quality. It checks epic parent relationships and validates description completeness for coding assistants, developers, and stakeholders.
4
- allowed-tools: ["mcp__atlassian__getJiraIssue", "mcp__atlassian__searchJiraIssuesUsingJql", "mcp__atlassian__getAccessibleAtlassianResources"]
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
- Fetch ticket $ARGUMENTS and verify it meets organizational standards.
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
- ## Verification Checks
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
- ### 1. Epic Parent Relationship
13
+ ## Process
14
14
 
15
- **Rule**: Non-bug, non-epic tickets MUST have an epic parent
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
- - If missing: Search filter 10089 (Epic Backlog) and suggest appropriate epics
20
+ ## Output
18
21
 
19
- ### 2. Description Quality
22
+ Pass through `jira-validate-ticket`'s structured output unchanged. Downstream callers parse the gate lines.
20
23
 
21
- Verify description adequately addresses:
24
+ ## Notes
22
25
 
23
- **Coding Assistants**: Acceptance criteria, requirements, constraints, I/O
24
- **Developers**: Technical context, integration points, testing, edge cases
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", "mcp__atlassian__createJiraIssue", "mcp__atlassian__getVisibleJiraProjects", "mcp__atlassian__getJiraProjectIssueTypesMetadata", "mcp__atlassian__getAccessibleAtlassianResources"]
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 create a comprehensive JIRA hierarchy with all mandatory quality gates.
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. **Determine Structure**:
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
- 3. **Create Issues** with hierarchy:
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 Artifact Preservation
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
- Rules:
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
- 1. **Extract before creating**: enumerate every external URL, embed, attachment, or example payload in the input. Classify by domain (`ui-design`, `ux-flow`, `data`, `ops`, `reference`) see `notion-to-jira` Phase 1.5 for the canonical taxonomy.
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
- When delegating actual writes to `jira-write-ticket`, pass the extracted artifact list so its Phase 4c (Remote Links) step can attach them.
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
- **Classification disambiguation** (applied during extraction):
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
- **Source precedence** (must be recorded on every ticket carrying design artifacts):
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
- **Existing-component reuse** (applies to every view/partial-touching ticket): the story description must instruct the implementer to locate the closest existing view partial or ViewComponent in the codebase and prefer reuse over pixel-matching a mock. Design-vs-code divergence is raised on the ticket, not resolved by the implementer alone.
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
- Execute the analysis and create the complete JIRA structure with proper parent-child relationships.
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 checks epic parent relationships and validates description completeness for coding assistants, developers, and stakeholders.
4
- allowed-tools: ["mcp__atlassian__getJiraIssue", "mcp__atlassian__searchJiraIssuesUsingJql", "mcp__atlassian__getAccessibleAtlassianResources"]
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
- Fetch ticket $ARGUMENTS and verify it meets organizational standards.
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
- ## Verification Checks
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
- ### 1. Epic Parent Relationship
13
+ ## Process
14
14
 
15
- **Rule**: Non-bug, non-epic tickets MUST have an epic parent
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
- - If missing: Search filter 10089 (Epic Backlog) and suggest appropriate epics
20
+ ## Output
18
21
 
19
- ### 2. Description Quality
22
+ Pass through `jira-validate-ticket`'s structured output unchanged. Downstream callers parse the gate lines.
20
23
 
21
- Verify description adequately addresses:
24
+ ## Notes
22
25
 
23
- **Coding Assistants**: Acceptance criteria, requirements, constraints, I/O
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.