@codyswann/lisa 2.7.0 → 2.8.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/package.json +1 -1
- package/plugins/lisa/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa/agents/confluence-prd-intake.md +5 -5
- package/plugins/lisa/agents/github-agent.md +141 -0
- package/plugins/lisa/agents/github-build-intake.md +62 -0
- package/plugins/lisa/agents/github-prd-intake.md +64 -0
- package/plugins/lisa/agents/linear-prd-intake.md +5 -5
- package/plugins/lisa/agents/notion-prd-intake.md +5 -5
- package/plugins/lisa/commands/intake.md +2 -2
- package/plugins/lisa/commands/plan.md +2 -2
- package/plugins/lisa/rules/intent-routing.md +16 -11
- package/plugins/lisa/rules/tracker-resolution.md +76 -0
- package/plugins/lisa/skills/confluence-prd-intake/SKILL.md +11 -11
- package/plugins/lisa/skills/{confluence-to-jira → confluence-to-tracker}/SKILL.md +31 -31
- package/plugins/lisa/skills/github-add-journey/SKILL.md +114 -0
- package/plugins/lisa/skills/github-build-intake/SKILL.md +188 -0
- package/plugins/lisa/skills/github-create/SKILL.md +101 -0
- package/plugins/lisa/skills/github-evidence/SKILL.md +116 -0
- package/plugins/lisa/skills/github-journey/SKILL.md +121 -0
- package/plugins/lisa/skills/github-prd-intake/SKILL.md +286 -0
- package/plugins/lisa/skills/github-read-issue/SKILL.md +248 -0
- package/plugins/lisa/skills/github-sync/SKILL.md +73 -0
- package/plugins/lisa/skills/github-to-tracker/SKILL.md +312 -0
- package/plugins/lisa/skills/github-validate-issue/SKILL.md +288 -0
- package/plugins/lisa/skills/github-verify/SKILL.md +29 -0
- package/plugins/lisa/skills/github-write-issue/SKILL.md +304 -0
- package/plugins/lisa/skills/implement/SKILL.md +4 -4
- package/plugins/lisa/skills/intake/SKILL.md +14 -4
- package/plugins/lisa/skills/jira-source-artifacts/SKILL.md +1 -1
- package/plugins/lisa/skills/jira-validate-ticket/SKILL.md +3 -3
- package/plugins/lisa/skills/jira-verify/SKILL.md +1 -1
- package/plugins/lisa/skills/jira-write-ticket/SKILL.md +3 -3
- package/plugins/lisa/skills/linear-prd-intake/SKILL.md +10 -10
- package/plugins/lisa/skills/{linear-to-jira → linear-to-tracker}/SKILL.md +30 -31
- package/plugins/lisa/skills/notion-prd-intake/SKILL.md +11 -11
- package/plugins/{src/base/skills/notion-to-jira → lisa/skills/notion-to-tracker}/SKILL.md +34 -34
- package/plugins/lisa/skills/plan/SKILL.md +8 -6
- package/plugins/lisa/skills/prd-ticket-coverage/SKILL.md +22 -12
- package/plugins/lisa/skills/product-walkthrough/SKILL.md +1 -1
- package/plugins/lisa/skills/spec-conformance/SKILL.md +2 -3
- package/plugins/lisa/skills/ticket-triage/SKILL.md +7 -7
- package/plugins/lisa/skills/tracker-add-journey/SKILL.md +24 -0
- package/plugins/lisa/skills/tracker-build-intake/SKILL.md +25 -0
- package/plugins/lisa/skills/tracker-create/SKILL.md +24 -0
- package/plugins/lisa/skills/tracker-evidence/SKILL.md +24 -0
- package/plugins/lisa/skills/tracker-journey/SKILL.md +24 -0
- package/plugins/lisa/skills/tracker-read/SKILL.md +25 -0
- package/plugins/lisa/skills/tracker-sync/SKILL.md +26 -0
- package/plugins/lisa/skills/tracker-validate/SKILL.md +35 -0
- package/plugins/lisa/skills/tracker-verify/SKILL.md +25 -0
- package/plugins/lisa/skills/tracker-write/SKILL.md +43 -0
- package/plugins/lisa/skills/verify/SKILL.md +1 -1
- 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-verify/SKILL.md +1 -1
- 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-verify/SKILL.md +1 -1
- package/plugins/lisa-typescript/.claude-plugin/plugin.json +1 -1
- package/plugins/src/base/agents/confluence-prd-intake.md +5 -5
- package/plugins/src/base/agents/github-agent.md +141 -0
- package/plugins/src/base/agents/github-build-intake.md +62 -0
- package/plugins/src/base/agents/github-prd-intake.md +64 -0
- package/plugins/src/base/agents/linear-prd-intake.md +5 -5
- package/plugins/src/base/agents/notion-prd-intake.md +5 -5
- package/plugins/src/base/commands/intake.md +2 -2
- package/plugins/src/base/commands/plan.md +2 -2
- package/plugins/src/base/rules/intent-routing.md +16 -11
- package/plugins/src/base/rules/tracker-resolution.md +76 -0
- package/plugins/src/base/skills/confluence-prd-intake/SKILL.md +11 -11
- package/plugins/src/base/skills/{confluence-to-jira → confluence-to-tracker}/SKILL.md +31 -31
- package/plugins/src/base/skills/github-add-journey/SKILL.md +114 -0
- package/plugins/src/base/skills/github-build-intake/SKILL.md +188 -0
- package/plugins/src/base/skills/github-create/SKILL.md +101 -0
- package/plugins/src/base/skills/github-evidence/SKILL.md +116 -0
- package/plugins/src/base/skills/github-journey/SKILL.md +121 -0
- package/plugins/src/base/skills/github-prd-intake/SKILL.md +286 -0
- package/plugins/src/base/skills/github-read-issue/SKILL.md +248 -0
- package/plugins/src/base/skills/github-sync/SKILL.md +73 -0
- package/plugins/src/base/skills/github-to-tracker/SKILL.md +312 -0
- package/plugins/src/base/skills/github-validate-issue/SKILL.md +288 -0
- package/plugins/src/base/skills/github-verify/SKILL.md +29 -0
- package/plugins/src/base/skills/github-write-issue/SKILL.md +304 -0
- package/plugins/src/base/skills/implement/SKILL.md +4 -4
- package/plugins/src/base/skills/intake/SKILL.md +14 -4
- package/plugins/src/base/skills/jira-source-artifacts/SKILL.md +1 -1
- package/plugins/src/base/skills/jira-validate-ticket/SKILL.md +3 -3
- package/plugins/src/base/skills/jira-verify/SKILL.md +1 -1
- package/plugins/src/base/skills/jira-write-ticket/SKILL.md +3 -3
- package/plugins/src/base/skills/linear-prd-intake/SKILL.md +10 -10
- package/plugins/src/base/skills/{linear-to-jira → linear-to-tracker}/SKILL.md +30 -31
- package/plugins/src/base/skills/notion-prd-intake/SKILL.md +11 -11
- package/plugins/{lisa/skills/notion-to-jira → src/base/skills/notion-to-tracker}/SKILL.md +34 -34
- package/plugins/src/base/skills/plan/SKILL.md +8 -6
- package/plugins/src/base/skills/prd-ticket-coverage/SKILL.md +22 -12
- package/plugins/src/base/skills/product-walkthrough/SKILL.md +1 -1
- package/plugins/src/base/skills/spec-conformance/SKILL.md +2 -3
- package/plugins/src/base/skills/ticket-triage/SKILL.md +7 -7
- package/plugins/src/base/skills/tracker-add-journey/SKILL.md +24 -0
- package/plugins/src/base/skills/tracker-build-intake/SKILL.md +25 -0
- package/plugins/src/base/skills/tracker-create/SKILL.md +24 -0
- package/plugins/src/base/skills/tracker-evidence/SKILL.md +24 -0
- package/plugins/src/base/skills/tracker-journey/SKILL.md +24 -0
- package/plugins/src/base/skills/tracker-read/SKILL.md +25 -0
- package/plugins/src/base/skills/tracker-sync/SKILL.md +26 -0
- package/plugins/src/base/skills/tracker-validate/SKILL.md +35 -0
- package/plugins/src/base/skills/tracker-verify/SKILL.md +25 -0
- package/plugins/src/base/skills/tracker-write/SKILL.md +43 -0
- package/plugins/src/base/skills/verify/SKILL.md +1 -1
- package/plugins/src/expo/skills/jira-verify/SKILL.md +1 -1
- package/plugins/src/rails/skills/jira-verify/SKILL.md +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: intake
|
|
3
|
-
description: "Vendor-agnostic batch scanner for Ready queues. Given a Notion PRD database URL → finds Ready PRDs and runs lisa:plan per item. Given a Confluence space or parent page URL → finds prd-ready PRDs and runs lisa:plan per item. Given a Linear workspace URL or team key → finds prd-ready Linear projects and runs lisa:plan per item. Given a JIRA project key or JQL filter → finds Ready tickets and runs lisa:implement per item. Designed as the cron target for /schedule — one cycle per invocation, processes everything currently Ready, exits cleanly on empty. Symmetric counterpart to the single-item lisa:plan and lisa:implement skills."
|
|
3
|
+
description: "Vendor-agnostic batch scanner for Ready queues. Given a Notion PRD database URL → finds Ready PRDs and runs lisa:plan per item. Given a Confluence space or parent page URL → finds prd-ready PRDs and runs lisa:plan per item. Given a Linear workspace URL or team key → finds prd-ready Linear projects and runs lisa:plan per item. Given a GitHub repo URL or `org/repo` token → finds prd-ready GitHub issues and runs lisa:plan per item. Given a JIRA project key or JQL filter → finds Ready tickets and runs lisa:implement per item. Given a GitHub repo URL or `org/repo` token when `tracker = github` → finds `status:ready` issues and runs lisa:implement per item. Designed as the cron target for /schedule — one cycle per invocation, processes everything currently Ready, exits cleanly on empty. Symmetric counterpart to the single-item lisa:plan and lisa:implement skills."
|
|
4
4
|
allowed-tools: ["Skill", "Bash", "mcp__claude_ai_Notion__notion-fetch", "mcp__claude_ai_Notion__notion-search", "mcp__atlassian__getConfluencePage", "mcp__atlassian__getConfluenceSpaces", "mcp__atlassian__searchConfluenceUsingCql", "mcp__atlassian__getAccessibleAtlassianResources", "mcp__atlassian__searchJiraIssuesUsingJql", "mcp__atlassian__getJiraIssue", "mcp__linear-server__list_projects", "mcp__linear-server__list_teams", "mcp__linear-server__list_project_labels"]
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -47,7 +47,9 @@ Detect the queue type from `$ARGUMENTS` and route:
|
|
|
47
47
|
| The literal token `linear` | PRD queue (Linear, default workspace) | Invoke `lisa:linear-prd-intake linear` — only valid if `LINEAR_WORKSPACE` is configured |
|
|
48
48
|
| A JIRA project key (e.g. `SE`) | Work queue (JIRA) | Invoke `lisa:jira-build-intake` (which scans the project for Status=Ready, claims each via In Progress, runs `lisa:implement` per ticket, transitions to On Dev on success) |
|
|
49
49
|
| A full JQL filter (e.g. `project = SE AND component = "frontend"`) | Work queue (JIRA, narrowed) | Invoke `lisa:jira-build-intake` with the JQL |
|
|
50
|
-
| A GitHub
|
|
50
|
+
| A GitHub **repository** URL or `org/repo` token (e.g. `https://github.com/acme/product-prds` or `acme/product-prds`) when used for **PRDs** | PRD queue (GitHub) | Invoke `lisa:github-prd-intake` (which queries `gh issue list --label prd-ready`, claims each by relabeling to `prd-in-review`, runs the dry-run validate → branch → write pipeline). PRD discovery is independent of the destination tracker — the resulting tickets land wherever `.lisa.config.json` `tracker` says. |
|
|
51
|
+
| A GitHub **repository** URL or `org/repo` token when `tracker = github` is configured (build-queue mode) | Work queue (GitHub) | Invoke `lisa:tracker-build-intake` which dispatches to `lisa:github-build-intake` (which queries `gh issue list --label status:ready`, claims via `status:in-progress`, runs `lisa:implement` per issue, relabels to `status:on-dev` on success). |
|
|
52
|
+
| The literal token `github` | Defaults to `.lisa.config.json` `github.org` / `github.repo`. Routes by **the `intake_mode` flag** in `$ARGUMENTS` (`prd` or `build`); if the flag is absent, prefer the PRD queue when both label namespaces are present, otherwise pick whichever exists. | Invoke the matching skill (`lisa:github-prd-intake` or `lisa:tracker-build-intake`). |
|
|
51
53
|
|
|
52
54
|
Disambiguation rules:
|
|
53
55
|
|
|
@@ -56,10 +58,13 @@ Disambiguation rules:
|
|
|
56
58
|
- An Atlassian Confluence URL containing `/wiki/spaces/<KEY>/pages/<ID>/...` → Confluence parent-page queue (the page is the parent whose descendants are PRDs). If the user actually meant "this single page is a PRD, plan it", route to `lisa:plan` instead — this skill is batch-only.
|
|
57
59
|
- A `linear.app` URL → Linear queue. If the path is `/<workspace>` only or `/<workspace>/team/<KEY>/...`, route here. If the path includes `/project/<slug>-<id>` it's a single-PRD URL — direct the caller to `lisa:plan` instead, this skill is batch-only.
|
|
58
60
|
- The literal token `linear` (case-insensitive) → Linear queue, default workspace from `LINEAR_WORKSPACE`.
|
|
59
|
-
- A
|
|
61
|
+
- A `github.com` URL or an `<org>/<repo>` token → GitHub queue. The PRD-vs-build dispatch is determined by which label namespace the repo currently uses: PRD-side (`prd-ready`) → `lisa:github-prd-intake`; build-side (`status:ready` and `tracker = github` in `.lisa.config.json`) → `lisa:tracker-build-intake`. If both namespaces are present, prefer the PRD queue unless `$ARGUMENTS` includes `intake_mode=build`. If the URL points at a single issue (`https://github.com/<org>/<repo>/issues/<n>`), this skill is batch-only — direct the caller to `lisa:plan` (for a single PRD issue) or `lisa:implement` (for a single build issue).
|
|
62
|
+
- The literal token `github` (case-insensitive) → GitHub queue, default repo from `.lisa.config.json` `github.org` / `github.repo`.
|
|
63
|
+
- A bare alphanumeric token that matches the configured `JIRA_PROJECT` regex (uppercase letters / digits / hyphen, ≤10 chars) is treated as a JIRA project key by default. A token that does not match the regex is treated as a Confluence space key. If it does not resolve as a Confluence space key either, attempt to resolve as a Linear team key via `mcp__linear-server__list_teams({query})` before giving up. The only time to stop and ask is when the token resolves to more than one of {JIRA project, Confluence space, Linear team, GitHub `org/repo`} simultaneously — in that overlap the user must disambiguate which queue to scan.
|
|
64
|
+
- An `<org>/<repo>` token (slash-separated, both halves are GitHub-name-shaped) → GitHub queue.
|
|
60
65
|
- A string starting with `project = ` or containing JQL operators (`AND`, `OR`, `=`, `!=`, `~`, etc.) → JQL filter.
|
|
61
66
|
|
|
62
|
-
The single-item skills (`lisa:plan`, `lisa:implement`) and the per-vendor batch skills (`lisa:notion-prd-intake`, `lisa:confluence-prd-intake`, `lisa:linear-prd-intake`, `lisa:jira-build-intake`) are internal — Intake is the public entry point. Developers schedule `/lisa:intake <queue>`; the rest is composition.
|
|
67
|
+
The single-item skills (`lisa:plan`, `lisa:implement`) and the per-vendor batch skills (`lisa:notion-prd-intake`, `lisa:confluence-prd-intake`, `lisa:linear-prd-intake`, `lisa:github-prd-intake`, `lisa:jira-build-intake`, `lisa:github-build-intake`) are internal — Intake is the public entry point. Developers schedule `/lisa:intake <queue>`; the rest is composition.
|
|
63
68
|
|
|
64
69
|
## Cycle behavior
|
|
65
70
|
|
|
@@ -70,7 +75,9 @@ The single-item skills (`lisa:plan`, `lisa:implement`) and the per-vendor batch
|
|
|
70
75
|
- Notion PRDs → `lisa:notion-prd-intake` handles per-item: claim (Status=In Review), dry-run validate, branch to Blocked or Ticketed, coverage audit
|
|
71
76
|
- Confluence PRDs → `lisa:confluence-prd-intake` handles per-item: claim (relabel to `prd-in-review`), dry-run validate, branch to `prd-blocked` or `prd-ticketed`, coverage audit
|
|
72
77
|
- Linear PRDs → `lisa:linear-prd-intake` handles per-item: claim (relabel project to `prd-in-review`), dry-run validate, branch to `prd-blocked` or `prd-ticketed` (with a sentinel feedback issue under each project hosting clarifying-question comments), coverage audit
|
|
78
|
+
- GitHub PRDs → `lisa:github-prd-intake` handles per-item: claim (relabel issue to `prd-in-review`), dry-run validate, branch to `prd-blocked` or `prd-ticketed` (with clarifying-question comments posted directly on the PRD issue), coverage audit
|
|
73
79
|
- JIRA tickets → `lisa:jira-build-intake` handles per-item: claim, dispatch to `lisa:jira-agent`, transition to On Dev on success
|
|
80
|
+
- GitHub build issues (when `tracker = github`) → `lisa:tracker-build-intake` → `lisa:github-build-intake` handles per-item: claim (relabel to `status:in-progress`), dispatch to `lisa:github-agent`, relabel to `status:on-dev` on success
|
|
74
81
|
5. **Failure isolation** — one item failing does not stop the cycle; record under "Errors" and continue.
|
|
75
82
|
6. **Summary report** — per-item outcomes, total processed, total errors.
|
|
76
83
|
|
|
@@ -81,7 +88,10 @@ The single-item skills (`lisa:plan`, `lisa:implement`) and the per-vendor batch
|
|
|
81
88
|
/schedule "every 30 minutes" /lisa:intake https://acme.atlassian.net/wiki/spaces/PRD
|
|
82
89
|
/schedule "every 30 minutes" /lisa:intake https://linear.app/acme
|
|
83
90
|
/schedule "every 30 minutes" /lisa:intake https://linear.app/acme/team/ENG/projects
|
|
91
|
+
/schedule "every 30 minutes" /lisa:intake https://github.com/acme/product-prds
|
|
92
|
+
/schedule "every 30 minutes" /lisa:intake acme/product-prds
|
|
84
93
|
/schedule "every 30 minutes" /lisa:intake SE
|
|
94
|
+
/schedule "every 30 minutes" /lisa:intake acme/frontend-v2 intake_mode=build
|
|
85
95
|
/schedule "every hour" /lisa:intake "project = SE AND component = 'frontend'"
|
|
86
96
|
```
|
|
87
97
|
|
|
@@ -8,7 +8,7 @@ allowed-tools: []
|
|
|
8
8
|
|
|
9
9
|
This skill is doctrine, not action — it defines the rules. Skills that need to extract, classify, attach, or reason about external artifacts (design files, prototypes, recordings, data samples) invoke this skill to load the taxonomy and apply it.
|
|
10
10
|
|
|
11
|
-
The reason this lives in one place: silent drift across skills is the failure mode this body of rules exists to prevent. If the rules differ between `lisa:notion-to-
|
|
11
|
+
The reason this lives in one place: silent drift across skills is the failure mode this body of rules exists to prevent. If the rules differ between `lisa:notion-to-tracker`, `lisa:jira-create`, and `lisa:jira-write-ticket`, agents will silently route artifacts wrong and developers will lose source of truth. Edit here, propagate everywhere.
|
|
12
12
|
|
|
13
13
|
## 1. Domains
|
|
14
14
|
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: jira-validate-ticket
|
|
3
|
-
description: "Validates a proposed JIRA ticket spec (or an existing ticket) against the organizational quality gates without writing anything. Returns a structured PASS/FAIL report per gate with concrete remediation. This is the single source of truth for what makes a valid ticket — both the write path (jira-write-ticket runs it pre-write) and the dry-run path (notion-to-
|
|
3
|
+
description: "Validates a proposed JIRA ticket spec (or an existing ticket) against the organizational quality gates without writing anything. Returns a structured PASS/FAIL report per gate with concrete remediation. This is the single source of truth for what makes a valid ticket — both the write path (jira-write-ticket runs it pre-write) and the dry-run path (notion-to-tracker runs it during PRD intake) call this skill so the bar can never drift."
|
|
4
4
|
allowed-tools: ["Bash", "mcp__atlassian__getJiraIssue", "mcp__atlassian__searchJiraIssuesUsingJql", "mcp__atlassian__getIssueLinkTypes", "mcp__atlassian__getJiraProjectIssueTypesMetadata", "mcp__atlassian__getVisibleJiraProjects", "mcp__atlassian__getAccessibleAtlassianResources"]
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# Validate JIRA Ticket: $ARGUMENTS
|
|
8
8
|
|
|
9
|
-
Run all organizational quality gates against a ticket spec OR an existing ticket. **This skill is read-only — it never writes to JIRA.** The output is a structured report consumed by callers (`lisa:jira-write-ticket` for pre-write gating, `lisa:notion-to-
|
|
9
|
+
Run all organizational quality gates against a ticket spec OR an existing ticket. **This skill is read-only — it never writes to JIRA.** The output is a structured report consumed by callers (`lisa:jira-write-ticket` for pre-write gating, `lisa:notion-to-tracker` for PRD dry-run, `lisa:jira-verify` for post-write checks).
|
|
10
10
|
|
|
11
11
|
## Input
|
|
12
12
|
|
|
@@ -166,7 +166,7 @@ When `runtime_behavior_change = true`, description must contain `h2. Validation
|
|
|
166
166
|
|
|
167
167
|
The caller controls the strictness by passing `journey_followup: "auto"` or `journey_followup: "none"` in the spec:
|
|
168
168
|
- `auto` (default): if the section is absent, return `FAIL` with remediation `"Invoke lisa:jira-add-journey to append the section after create"`. Callers like `lisa:jira-write-ticket` know to chain `lisa:jira-add-journey` automatically, so this counts as a fixable failure they can resolve in-line — they re-run validation after appending.
|
|
169
|
-
- `none`: missing section is a `FAIL` that the caller will not auto-fix, so the verdict gates progress (used by dry-run paths like `lisa:notion-to-
|
|
169
|
+
- `none`: missing section is a `FAIL` that the caller will not auto-fix, so the verdict gates progress (used by dry-run paths like `lisa:notion-to-tracker` PRD intake, where there's no agent standing by to add the journey).
|
|
170
170
|
|
|
171
171
|
Either way the gate emits `FAIL`, not a third state. Strictness is the caller's policy, not the validator's.
|
|
172
172
|
|
|
@@ -8,7 +8,7 @@ allowed-tools: ["Skill", "mcp__atlassian__getJiraIssue", "mcp__atlassian__getAcc
|
|
|
8
8
|
|
|
9
9
|
Verify that the existing JIRA ticket `$ARGUMENTS` meets organizational standards. This skill is a thin post-write wrapper around `lisa:jira-validate-ticket`: it fetches the live ticket and asks `lisa:jira-validate-ticket` to run the gates against the fetched state.
|
|
10
10
|
|
|
11
|
-
This indirection exists so the gate definitions live in exactly one place (`lisa:jira-validate-ticket`). When the bar changes, change it there — `lisa:jira-verify`, `lisa:jira-write-ticket` (Phase 5.5 pre-write), and `lisa:notion-to-
|
|
11
|
+
This indirection exists so the gate definitions live in exactly one place (`lisa:jira-validate-ticket`). When the bar changes, change it there — `lisa:jira-verify`, `lisa:jira-write-ticket` (Phase 5.5 pre-write), and `lisa:notion-to-tracker` (PRD dry-run) all pick it up.
|
|
12
12
|
|
|
13
13
|
## Process
|
|
14
14
|
|
|
@@ -172,7 +172,7 @@ Identify and attach:
|
|
|
172
172
|
- Incident tickets (PagerDuty, Statuspage)
|
|
173
173
|
- **Source artifacts from the originating PRD / parent epic**: classify and inherit per the rules in `lisa:jira-source-artifacts` (invoke that skill if you haven't loaded the rules in this session). The short version: enumerate the parent epic's remote links and inherit the ones whose domain matches this ticket's scope (UI → `ui-design` + `ux-flow`; backend → `data`; infra → `ops`; always inherit `reference`). Never assume a developer will walk up to the epic to find design context — attach it here.
|
|
174
174
|
|
|
175
|
-
If the ticket was generated from a PRD (by `lisa:notion-to-
|
|
175
|
+
If the ticket was generated from a PRD (by `lisa:notion-to-tracker` or similar) and the parent epic has no source artifacts, surface that as a smell and ask whether artifacts were missed during extraction before proceeding.
|
|
176
176
|
|
|
177
177
|
### 4d. Source Precedence (must appear on the ticket)
|
|
178
178
|
|
|
@@ -182,7 +182,7 @@ For UI-touching tickets, include the existing-component reuse expectation per `l
|
|
|
182
182
|
|
|
183
183
|
### 4e. Live Product Walkthrough Findings (UI-touching tickets)
|
|
184
184
|
|
|
185
|
-
If the ticket modifies an existing user-facing surface, a `lisa:product-walkthrough` should already have been run upstream (by `lisa:notion-to-
|
|
185
|
+
If the ticket modifies an existing user-facing surface, a `lisa:product-walkthrough` should already have been run upstream (by `lisa:notion-to-tracker` Phase 2b or `lisa:jira-create`). Inherit its findings under a `## Current Product` subsection in the ticket description so the implementer sees what's shipped today before changing it. If the upstream skill skipped the walkthrough but this ticket clearly modifies an existing surface, invoke `lisa:product-walkthrough` here before proceeding.
|
|
186
186
|
|
|
187
187
|
Use Jira's web UI or `mcp__atlassian__editJiraIssue` to set the `Development` field / remote links where supported.
|
|
188
188
|
|
|
@@ -202,7 +202,7 @@ Before create/update, verify each field is populated where applicable:
|
|
|
202
202
|
|
|
203
203
|
Before any write, invoke `lisa:jira-validate-ticket` with the full proposed spec assembled from Phases 2 / 3 / 4 / 5. Pass it as a YAML block per the `lisa:jira-validate-ticket` schema, including `runtime_behavior_change`, `authenticated_surface`, and `artifacts_attached` flags so the right gates run.
|
|
204
204
|
|
|
205
|
-
The validator is the **single source of truth** for what makes a valid ticket. The same gates are used by `lisa:notion-to-
|
|
205
|
+
The validator is the **single source of truth** for what makes a valid ticket. The same gates are used by `lisa:notion-to-tracker` dry-run, by `lisa:jira-verify` post-write, and here. Do not re-implement gate logic in this skill — if a gate needs to change, change `lisa:jira-validate-ticket` so every caller benefits.
|
|
206
206
|
|
|
207
207
|
If the validator reports `FAIL`:
|
|
208
208
|
- Surface the failure list and the per-gate remediation to the user.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: linear-prd-intake
|
|
3
|
-
description: "Scans a Linear workspace (or a specific team) for projects labelled `prd-ready` and runs each one through the dry-run validation pipeline. Projects that pass every gate get tickets written and the label flipped to `prd-ticketed`; projects that fail get clarifying-question comments (on a sentinel feedback issue under the project) and the label flipped to `prd-blocked`. Linear counterpart of `lisa:notion-prd-intake` and `lisa:confluence-prd-intake` — the workflow is identical; only the source-of-truth tools differ. Composes existing skills (linear-to-
|
|
3
|
+
description: "Scans a Linear workspace (or a specific team) for projects labelled `prd-ready` and runs each one through the dry-run validation pipeline. Projects that pass every gate get tickets written and the label flipped to `prd-ticketed`; projects that fail get clarifying-question comments (on a sentinel feedback issue under the project) and the label flipped to `prd-blocked`. Linear counterpart of `lisa:notion-prd-intake` and `lisa:confluence-prd-intake` — the workflow is identical; only the source-of-truth tools differ. Composes existing skills (linear-to-tracker, tracker-validate, jira-source-artifacts, product-walkthrough)."
|
|
4
4
|
allowed-tools: ["Skill", "Bash", "mcp__linear-server__list_projects", "mcp__linear-server__get_project", "mcp__linear-server__save_project", "mcp__linear-server__list_project_labels", "mcp__linear-server__list_issues", "mcp__linear-server__get_issue", "mcp__linear-server__save_issue", "mcp__linear-server__list_comments", "mcp__linear-server__save_comment", "mcp__linear-server__list_issue_labels", "mcp__linear-server__create_issue_label", "mcp__linear-server__list_documents", "mcp__linear-server__get_document", "mcp__linear-server__list_teams"]
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -100,19 +100,19 @@ The `save_project` call must preserve all other project fields (description, sta
|
|
|
100
100
|
|
|
101
101
|
#### 3b. Dry-run validation
|
|
102
102
|
|
|
103
|
-
Invoke the `lisa:linear-to-
|
|
103
|
+
Invoke the `lisa:linear-to-tracker` skill with `dry_run: true` and the project's URL. The skill returns a structured report containing:
|
|
104
104
|
- The planned ticket hierarchy
|
|
105
105
|
- Per-ticket validation verdicts and remediation
|
|
106
106
|
- An overall PASS / FAIL verdict
|
|
107
107
|
- A failure count
|
|
108
108
|
|
|
109
|
-
This call also indirectly invokes `lisa:jira-source-artifacts` (artifact extraction + classification) and `lisa:product-walkthrough` (when the PRD touches existing user-facing surfaces). All gate logic lives in `lisa:
|
|
109
|
+
This call also indirectly invokes `lisa:jira-source-artifacts` (artifact extraction + classification) and `lisa:product-walkthrough` (when the PRD touches existing user-facing surfaces). All gate logic lives in `lisa:tracker-validate`, which `lisa:linear-to-tracker` calls per ticket.
|
|
110
110
|
|
|
111
111
|
#### 3c. Branch on the verdict
|
|
112
112
|
|
|
113
113
|
**If `PASS`** (every planned ticket passed every applicable gate):
|
|
114
114
|
|
|
115
|
-
1. Re-invoke `lisa:linear-to-
|
|
115
|
+
1. Re-invoke `lisa:linear-to-tracker` with `dry_run: false` to actually write the tickets. This re-runs Phases 1-5 and runs the preservation gate (Phase 5.5).
|
|
116
116
|
2. Capture the created ticket keys from the skill's output.
|
|
117
117
|
3. Ensure the project has a sentinel feedback issue (see "Sentinel feedback issue" below for the helper). Post a comment on it via `mcp__linear-server__save_comment` listing the created tickets (epic, stories, sub-tasks) with their JIRA URLs. Lead with: `"Ticketed by Claude. Created N JIRA issues — see below. Add the prd-shipped label to the Linear project after the work is delivered."`
|
|
118
118
|
4. Transition labels: remove `prd-in-review`, add `prd-ticketed` via `save_project`.
|
|
@@ -169,7 +169,7 @@ Use these exact badge labels — they are the validator's category values transl
|
|
|
169
169
|
|
|
170
170
|
- Gate IDs (`S4`, `F2`, etc.). Never appear in a comment body.
|
|
171
171
|
- JIRA terminology that has no product meaning (e.g. "Gherkin", "epic parent", "issue link", "validation journey", "sub-task hierarchy"). Paraphrase before posting.
|
|
172
|
-
- Internal skill names (`lisa:
|
|
172
|
+
- Internal skill names (`lisa:tracker-validate`, `linear-to-tracker`).
|
|
173
173
|
- Engineering shorthand (`AC`, `OOS`, `repo`, `env var`).
|
|
174
174
|
- "Clarify this" / "Please specify" without candidate resolutions. The validator is required to provide candidates; if `recommendation` is empty or vague, treat the failure as an Error and surface internally rather than posting a useless comment.
|
|
175
175
|
|
|
@@ -195,7 +195,7 @@ Per-ticket gates prove each ticket is well-formed; they do NOT prove the *set* o
|
|
|
195
195
|
| `GAPS_FOUND` | The created ticket set is incomplete. (a) For each gap, post a comment using the same product-facing template as Phase 3c.3 — anchored on the relevant sub-issue when `prd_anchor` is non-null, on the sentinel feedback issue otherwise; category badge from the gap's `category` field; `What's unclear` and `Recommendation` from the audit report's `what` and `recommendation` fields. Apply the same forbidden-language rules from Phase 3c.5. (b) Post one summary comment on the sentinel feedback issue listing the tickets that *were* successfully created (so product knows what to keep vs. what to extend). (c) Transition labels from `prd-ticketed` back to `prd-blocked` via `save_project`. |
|
|
196
196
|
| `NO_TICKETS_FOUND` | Should not happen if step 2 succeeded. If it does, log it as an Error in the cycle summary and leave label as `prd-ticketed` with a comment flagging the audit failure for human review. |
|
|
197
197
|
|
|
198
|
-
3. The created tickets remain in
|
|
198
|
+
3. The created tickets remain in the destination tracker regardless of the verdict — they are valid in their own right. The audit only tells us whether *more* are needed.
|
|
199
199
|
|
|
200
200
|
### Phase 4 — Summary report
|
|
201
201
|
|
|
@@ -243,25 +243,25 @@ Idempotency: the helper finds-or-creates. Re-runs of the cycle reuse the same se
|
|
|
243
243
|
## Idempotency & safety
|
|
244
244
|
|
|
245
245
|
- **Single-cycle scope**: this skill processes the `prd-ready` set as it exists at the start of Phase 2. New `prd-ready` projects added mid-cycle are picked up next run.
|
|
246
|
-
- **No writes outside the lifecycle**: this skill only ever writes to
|
|
246
|
+
- **No writes outside the lifecycle**: this skill only ever writes to the destination tracker via `lisa:linear-to-tracker` (which delegates to `lisa:tracker-write`), only ever changes Linear project labels among `prd-in-review`, `prd-blocked`, `prd-ticketed`, only ever creates/comments on the sentinel feedback issue (never any other Linear issue). It never edits project descriptions, never edits Linear documents, never touches `prd-draft` or `prd-shipped`, never archives or deletes projects.
|
|
247
247
|
- **Claim-first ordering**: the label flip to `prd-in-review` happens BEFORE validation runs, so a re-entrant call won't double-process.
|
|
248
248
|
- **Failure isolation**: an exception processing one project must not stop the cycle. Catch, record under "Errors" in the summary, continue to the next project. The project that errored is left labelled `prd-in-review` — the human investigates from there.
|
|
249
249
|
- **Single-label invariant**: after every transition, verify exactly one lifecycle label is present on the project. If two are present (rare race), surface as an Error and skip — do NOT auto-resolve, the human decides.
|
|
250
250
|
|
|
251
251
|
## Configuration
|
|
252
252
|
|
|
253
|
-
Same env vars as `lisa:linear-to-
|
|
253
|
+
Same env vars as `lisa:linear-to-tracker` — `JIRA_PROJECT`, `JIRA_SERVER`, `LINEAR_WORKSPACE`, `E2E_BASE_URL`, `E2E_TEST_PHONE`, `E2E_TEST_OTP`, `E2E_TEST_ORG`, `E2E_GRAPHQL_URL`. If any required value is missing, surface the missing key(s) and exit this cycle — never invent values.
|
|
254
254
|
|
|
255
255
|
## Rules
|
|
256
256
|
|
|
257
|
-
- Never write to
|
|
257
|
+
- Never write to the destination tracker outside of `lisa:linear-to-tracker` → `lisa:tracker-write`. The validator's verdict gates progress; bypassing it produces broken tickets.
|
|
258
258
|
- Never add or remove a label this skill doesn't own (`prd-in-review`, `prd-blocked`, `prd-ticketed`). Product owns `prd-draft`, `prd-ready`, `prd-shipped`. The issue-level `prd-intake-feedback` label is owned by this skill but is not a lifecycle label.
|
|
259
259
|
- Never edit a project's description or any attached Linear document. Communication with product happens only through comments on sub-issues or on the sentinel feedback issue.
|
|
260
260
|
- Never post a single dump of all gate failures on one comment. One comment per `prd_anchor` group on the relevant sub-issue (or one comment on the sentinel feedback issue for unanchored failures only). Comments must be sub-issue-anchored where possible, categorized, plain-language, and contain a concrete recommendation.
|
|
261
261
|
- Never include a gate ID, internal skill name, or engineering shorthand in a comment body.
|
|
262
262
|
- Never run more than one intake cycle concurrently against the same scope. This skill assumes serial execution.
|
|
263
263
|
- Never close, archive, or otherwise modify the sentinel feedback issue except to post comments on it. Its longevity is the audit trail.
|
|
264
|
-
- If `lisa:linear-to-
|
|
264
|
+
- If `lisa:linear-to-tracker` returns errors, treat them as gate failures: comment + `prd-blocked`. Don't silently fail.
|
|
265
265
|
|
|
266
266
|
## Adoption (one-time per project)
|
|
267
267
|
|
|
@@ -1,21 +1,20 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: linear-to-
|
|
2
|
+
name: linear-to-tracker
|
|
3
3
|
description: >
|
|
4
|
-
Break down a Linear PRD (a Linear Project) into
|
|
5
|
-
whenever the user shares a Linear project URL and wants it converted into
|
|
6
|
-
"break down this Linear project", "create tickets from a Linear project", "turn this Linear PRD into
|
|
7
|
-
JIRA", or similar. This skill mirrors `lisa:notion-to-jira` and `lisa:confluence-to-jira` for projects
|
|
4
|
+
Break down a Linear PRD (a Linear Project) into Epics, Stories, and Sub-tasks in the configured destination tracker (JIRA or GitHub Issues per .lisa.config.json). Use this skill
|
|
5
|
+
whenever the user shares a Linear project URL and wants it converted into tracker tickets, or asks to
|
|
6
|
+
"break down this Linear project", "create tickets from a Linear project", "turn this Linear PRD into tickets", or similar. This skill mirrors `lisa:notion-to-tracker` and `lisa:confluence-to-tracker` for projects
|
|
8
7
|
whose PRDs live in Linear — the workflow, gates, dry-run mode, and validation rules are identical;
|
|
9
8
|
only the source-of-truth tool surface differs (Linear MCP instead of Notion / Confluence MCP).
|
|
10
|
-
allowed-tools: ["Skill", "Bash", "mcp__linear-server__get_project", "mcp__linear-server__list_projects", "mcp__linear-server__list_issues", "mcp__linear-server__get_issue", "mcp__linear-server__list_comments", "mcp__linear-server__list_documents", "mcp__linear-server__get_document", "mcp__linear-server__list_project_labels", "mcp__linear-server__list_teams"
|
|
9
|
+
allowed-tools: ["Skill", "Bash", "mcp__linear-server__get_project", "mcp__linear-server__list_projects", "mcp__linear-server__list_issues", "mcp__linear-server__get_issue", "mcp__linear-server__list_comments", "mcp__linear-server__list_documents", "mcp__linear-server__get_document", "mcp__linear-server__list_project_labels", "mcp__linear-server__list_teams"]
|
|
11
10
|
---
|
|
12
11
|
|
|
13
|
-
# Linear PRD to
|
|
12
|
+
# Linear PRD to Tracker Breakdown
|
|
14
13
|
|
|
15
|
-
Convert a Linear PRD (a Linear **Project**) into a structured JIRA
|
|
14
|
+
Convert a Linear PRD (a Linear **Project**) into a structured ticket hierarchy in the configured destination tracker (JIRA or GitHub Issues per .lisa.config.json): Epics > Stories > Sub-tasks.
|
|
16
15
|
Each sub-task is scoped to exactly one repo and includes an empirical verification plan.
|
|
17
16
|
|
|
18
|
-
This skill is the Linear counterpart of `lisa:notion-to-
|
|
17
|
+
This skill is the Linear counterpart of `lisa:notion-to-tracker` and `lisa:confluence-to-tracker`. The three skills share the same phases, gates, dry-run contract, and per-ticket validation logic. Only the PRD-side fetch tools differ. When changing workflow logic, change ALL THREE skills together so the source vendors stay behaviorally identical.
|
|
19
18
|
|
|
20
19
|
## What "PRD" means in Linear
|
|
21
20
|
|
|
@@ -30,13 +29,13 @@ Linear has no native "PRD" entity. This skill treats a **Linear Project** as the
|
|
|
30
29
|
|
|
31
30
|
This skill supports two modes, controlled by a `dry_run` flag in `$ARGUMENTS`:
|
|
32
31
|
|
|
33
|
-
- **`dry_run: false`** (default — full mode): run all phases, write tickets via `lisa:
|
|
34
|
-
- **`dry_run: true`** (planning + validation only — no writes): run Phases 1, 1.5, 1.6, 2, 3, 4 to plan the hierarchy and draft each ticket spec, then call `lisa:
|
|
32
|
+
- **`dry_run: false`** (default — full mode): run all phases, write tickets via `lisa:tracker-write`, run the preservation gate, report.
|
|
33
|
+
- **`dry_run: true`** (planning + validation only — no writes): run Phases 1, 1.5, 1.6, 2, 3, 4 to plan the hierarchy and draft each ticket spec, then call `lisa:tracker-validate` (with `--spec-only`) on every drafted ticket. Aggregate the per-ticket validator reports into a single dry-run report. **Skip Phase 5 (sub-task creation), Phase 5.5 (preservation gate), and Phase 6 (results report)** — none of those make sense without writes. Return the dry-run report so the caller (e.g. `lisa:linear-prd-intake`) can decide whether to proceed.
|
|
35
34
|
|
|
36
|
-
Dry-run output format is identical to `lisa:notion-to-
|
|
35
|
+
Dry-run output format is identical to `lisa:notion-to-tracker`'s and `lisa:confluence-to-tracker`'s. Reuse the same fields, including `prd_anchor` and `prd_section`. The only difference: Linear has no inline-comment selection-anchor primitive at the project level — `prd_anchor` is the anchor a downstream caller would use to *post a comment on the related sub-issue* (typically the issue identifier, e.g. `LIN-123`, scoped to a section heading). When the failure does not map to any single sub-issue, set `prd_anchor: null` and the caller falls back to its sentinel feedback channel.
|
|
37
36
|
|
|
38
37
|
```text
|
|
39
|
-
## linear-to-
|
|
38
|
+
## linear-to-tracker dry-run: <PRD title>
|
|
40
39
|
|
|
41
40
|
### Planned hierarchy
|
|
42
41
|
- Epic: <summary>
|
|
@@ -68,11 +67,11 @@ Dry-run output format is identical to `lisa:notion-to-jira`'s and `lisa:confluen
|
|
|
68
67
|
|
|
69
68
|
The dry-run mode never writes to JIRA and never calls `mcp__atlassian__createJiraIssue`. It also never modifies the source Linear project, never adds/removes labels, never edits sub-issues, and never posts comments — that is the orchestrating skill's responsibility (`lisa:linear-prd-intake`).
|
|
70
69
|
|
|
71
|
-
## Hard Rule: All Writes Go Through `lisa:
|
|
70
|
+
## Hard Rule: All Writes Go Through `lisa:tracker-write`
|
|
72
71
|
|
|
73
|
-
**Every JIRA ticket created by this skill — every epic, story, and sub-task — MUST be created by invoking the `lisa:
|
|
72
|
+
**Every JIRA ticket created by this skill — every epic, story, and sub-task — MUST be created by invoking the `lisa:tracker-write` skill. Never call `mcp__atlassian__createJiraIssue`, `mcp__atlassian__editJiraIssue`, `mcp__atlassian__createIssueLink`, or any other Atlassian write tool directly from this skill or from any sub-agent it spawns.**
|
|
74
73
|
|
|
75
|
-
`lisa:
|
|
74
|
+
`lisa:tracker-write` enforces gates this skill does not:
|
|
76
75
|
- 3-audience description (Context / Technical Approach / Acceptance Criteria)
|
|
77
76
|
- Gherkin acceptance criteria
|
|
78
77
|
- Epic parent validation
|
|
@@ -81,7 +80,7 @@ The dry-run mode never writes to JIRA and never calls `mcp__atlassian__createJir
|
|
|
81
80
|
- Sign-in account and target environment recorded in description
|
|
82
81
|
- Post-create verification
|
|
83
82
|
|
|
84
|
-
Bypassing `lisa:
|
|
83
|
+
Bypassing `lisa:tracker-write` produces thin tickets that the rest of the lifecycle (triage, ticket-verify, journey, evidence) treats as broken. Atlassian reads in this skill are limited to the tools listed in `allowed-tools` (currently `getJiraIssueRemoteIssueLinks`) for the Phase 5.5 preservation gate. The Linear read tools listed in `allowed-tools` above are PRD-side only and never write.
|
|
85
84
|
|
|
86
85
|
## Input
|
|
87
86
|
|
|
@@ -159,7 +158,7 @@ The existing-component reuse expectation is defined in `lisa:jira-source-artifac
|
|
|
159
158
|
|
|
160
159
|
### Phase 2: Codebase + Live Product Research
|
|
161
160
|
|
|
162
|
-
Identical to `lisa:notion-to-
|
|
161
|
+
Identical to `lisa:notion-to-tracker` Phase 2 and `lisa:confluence-to-tracker` Phase 2. Two complementary inputs ground PRD analysis: the **code** (what's there to reuse / extend) and the **live product** (what users see today). Skipping either produces tickets that misjudge the change.
|
|
163
162
|
|
|
164
163
|
**2a. Codebase research.** If the session doesn't already have codebase context, explore the repos to understand what exists. Use Explore agents for repos not yet examined.
|
|
165
164
|
|
|
@@ -171,9 +170,9 @@ Walkthrough findings are surfaced back to product via the orchestrating intake s
|
|
|
171
170
|
|
|
172
171
|
### Phase 3: Create Epics
|
|
173
172
|
|
|
174
|
-
> **Mode guard**: In `dry_run: true` mode, do not invoke `lisa:
|
|
173
|
+
> **Mode guard**: In `dry_run: true` mode, do not invoke `lisa:tracker-write` in this phase. Instead, draft the epic spec (summary, description_body, artifacts) and validate it with `lisa:tracker-validate --spec-only`. Record the drafted spec (including a placeholder epic key like `DRY-RUN-EPIC-1`) for Phase 4 to use as parent references. In `dry_run: false` mode (default), proceed as described below.
|
|
175
174
|
|
|
176
|
-
For each epic identified in Phase 1, **invoke the `lisa:
|
|
175
|
+
For each epic identified in Phase 1, **invoke the `lisa:tracker-write` skill** (do not call `createJiraIssue` directly). Pass it everything it needs to enforce its quality gates:
|
|
177
176
|
|
|
178
177
|
- `project_key`: from `JIRA_PROJECT` config
|
|
179
178
|
- `issue_type`: `Epic`
|
|
@@ -193,7 +192,7 @@ Capture the returned epic key — Phase 4 needs it as the parent for stories.
|
|
|
193
192
|
|
|
194
193
|
### Phase 4: Create Stories
|
|
195
194
|
|
|
196
|
-
> **Mode guard**: In `dry_run: true` mode, do not invoke `lisa:
|
|
195
|
+
> **Mode guard**: In `dry_run: true` mode, do not invoke `lisa:tracker-write` in this phase. Instead, draft each story spec and validate it with `lisa:tracker-validate --spec-only`. Use placeholder keys (e.g. `DRY-RUN-STORY-1.1`) for any downstream references. In `dry_run: false` mode (default), proceed as described below.
|
|
197
196
|
|
|
198
197
|
For each Epic, plan two kinds of stories:
|
|
199
198
|
- **One "X.0 Setup" story** for data model and infrastructure prerequisites
|
|
@@ -201,13 +200,13 @@ For each Epic, plan two kinds of stories:
|
|
|
201
200
|
|
|
202
201
|
**Story naming convention**: Prefix the summary with a short code derived from the PRD title (e.g., `[CU-1.1]` for "Contract Upload").
|
|
203
202
|
|
|
204
|
-
For each story, **invoke `lisa:
|
|
203
|
+
For each story, **invoke `lisa:tracker-write`** with:
|
|
205
204
|
|
|
206
205
|
- `project_key`: from `JIRA_PROJECT` config
|
|
207
206
|
- `issue_type`: `Story`
|
|
208
207
|
- `epic_parent`: the Epic key captured in Phase 3 (mandatory)
|
|
209
208
|
- `summary`: prefixed per the naming convention above
|
|
210
|
-
- `description_body`: 3-audience description as in `lisa:notion-to-
|
|
209
|
+
- `description_body`: 3-audience description as in `lisa:notion-to-tracker` Phase 4
|
|
211
210
|
- `artifacts`: the Phase 1.5 artifacts filtered by domain per the inheritance table below
|
|
212
211
|
|
|
213
212
|
| Story type | Inherits domains |
|
|
@@ -221,7 +220,7 @@ Capture each returned story key — Phase 5 needs it as the parent for sub-tasks
|
|
|
221
220
|
|
|
222
221
|
### Phase 5: Create Sub-tasks
|
|
223
222
|
|
|
224
|
-
Delegate sub-task creation to **parallel agents** (one per epic or batch of stories) for efficiency. **Every spawned agent must invoke `lisa:
|
|
223
|
+
Delegate sub-task creation to **parallel agents** (one per epic or batch of stories) for efficiency. **Every spawned agent must invoke `lisa:tracker-write` for each sub-task — no agent may call `createJiraIssue` directly.**
|
|
225
224
|
|
|
226
225
|
Each sub-task MUST:
|
|
227
226
|
1. **Be scoped to exactly ONE repo** — indicated in brackets in the summary: `[repo-name]`
|
|
@@ -235,9 +234,9 @@ Run the preservation gate defined in `lisa:jira-source-artifacts` §8 against th
|
|
|
235
234
|
|
|
236
235
|
To run the gate, this skill must:
|
|
237
236
|
|
|
238
|
-
1. Pull the remote links of every epic and story created in this run via `
|
|
237
|
+
1. Pull the remote links of every epic and story created in this run via `lisa:tracker-read (vendor-neutral; dispatches to jira-read-ticket or github-read-issue)`.
|
|
239
238
|
2. Apply the §8 preservation matrix and verdict rules.
|
|
240
|
-
3. If the gate fails: list each dropped/misrouted artifact and either re-attach via `lisa:
|
|
239
|
+
3. If the gate fails: list each dropped/misrouted artifact and either re-attach via `lisa:tracker-write` (UPDATE mode) or stop and ask the human.
|
|
241
240
|
4. If the gate passes: print the matrix compactly and proceed to Phase 6.
|
|
242
241
|
|
|
243
242
|
This gate is not optional.
|
|
@@ -269,13 +268,13 @@ When delegating to agents, provide this context. **The "MUST invoke jira-write-t
|
|
|
269
268
|
```text
|
|
270
269
|
Create JIRA sub-tasks in the [PROJECT] project at [CLOUD_ID].
|
|
271
270
|
|
|
272
|
-
CRITICAL: For each sub-task, invoke the `lisa:
|
|
273
|
-
Do NOT call `mcp__atlassian__createJiraIssue` directly. The `lisa:
|
|
271
|
+
CRITICAL: For each sub-task, invoke the `lisa:tracker-write` skill via the Skill tool.
|
|
272
|
+
Do NOT call `mcp__atlassian__createJiraIssue` directly. The `lisa:tracker-write` skill
|
|
274
273
|
enforces required quality gates (Gherkin acceptance criteria, 3-audience description,
|
|
275
274
|
single-repo scope, sign-in/environment fields, post-create verification). Bypassing it
|
|
276
275
|
produces broken tickets that downstream skills (triage, journey, evidence) cannot use.
|
|
277
276
|
|
|
278
|
-
For each sub-task, invoke `lisa:
|
|
277
|
+
For each sub-task, invoke `lisa:tracker-write` with:
|
|
279
278
|
- issue_type: "Sub-task"
|
|
280
279
|
- parent: the parent story key
|
|
281
280
|
- project_key: [PROJECT]
|
|
@@ -291,9 +290,9 @@ For each sub-task, invoke `lisa:jira-write-ticket` with:
|
|
|
291
290
|
Each sub-task must:
|
|
292
291
|
1. Be scoped to ONE repo only — repo named in brackets in the summary
|
|
293
292
|
2. Include the Empirical Verification Plan in the description
|
|
294
|
-
3. Be created via `lisa:
|
|
293
|
+
3. Be created via `lisa:tracker-write`, not via direct MCP calls
|
|
295
294
|
|
|
296
|
-
If `lisa:
|
|
295
|
+
If `lisa:tracker-write` rejects a sub-task, fix the input and re-invoke. Do NOT fall back
|
|
297
296
|
to a direct `createJiraIssue` call to bypass the gate.
|
|
298
297
|
|
|
299
298
|
Test user info: [credentials from config]
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: notion-prd-intake
|
|
3
|
-
description: "Scans a Notion PRD database for pages with Status=Ready and runs each one through the dry-run validation pipeline. PRDs that pass every gate get tickets written and Status=Ticketed; PRDs that fail get clarifying-question comments and Status=Blocked. The skill is the runtime for the Ready → In Review → Blocked|Ticketed lifecycle. Composes existing skills (notion-to-
|
|
3
|
+
description: "Scans a Notion PRD database for pages with Status=Ready and runs each one through the dry-run validation pipeline. PRDs that pass every gate get tickets written and Status=Ticketed; PRDs that fail get clarifying-question comments and Status=Blocked. The skill is the runtime for the Ready → In Review → Blocked|Ticketed lifecycle. Composes existing skills (notion-to-tracker, tracker-validate, jira-source-artifacts, product-walkthrough); does not reimplement their logic."
|
|
4
4
|
allowed-tools: ["Skill", "Bash", "mcp__claude_ai_Notion__notion-fetch", "mcp__claude_ai_Notion__notion-search", "mcp__claude_ai_Notion__notion-update-page", "mcp__claude_ai_Notion__notion-create-comment", "mcp__atlassian__getAccessibleAtlassianResources"]
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -72,19 +72,19 @@ If the update fails (permission error, race), log it and skip this PRD. Do not p
|
|
|
72
72
|
|
|
73
73
|
#### 3b. Dry-run validation
|
|
74
74
|
|
|
75
|
-
Invoke the `lisa:notion-to-
|
|
75
|
+
Invoke the `lisa:notion-to-tracker` skill with `dry_run: true` and the PRD's URL. The skill returns a structured report containing:
|
|
76
76
|
- The planned ticket hierarchy
|
|
77
77
|
- Per-ticket validation verdicts and remediation
|
|
78
78
|
- An overall PASS / FAIL verdict
|
|
79
79
|
- A failure count
|
|
80
80
|
|
|
81
|
-
This call also indirectly invokes `lisa:jira-source-artifacts` (artifact extraction + classification) and `lisa:product-walkthrough` (when the PRD touches existing user-facing surfaces). All gate logic lives in `lisa:
|
|
81
|
+
This call also indirectly invokes `lisa:jira-source-artifacts` (artifact extraction + classification) and `lisa:product-walkthrough` (when the PRD touches existing user-facing surfaces). All gate logic lives in `lisa:tracker-validate`, which `lisa:notion-to-tracker` calls per ticket.
|
|
82
82
|
|
|
83
83
|
#### 3c. Branch on the verdict
|
|
84
84
|
|
|
85
85
|
**If `PASS`** (every planned ticket passed every applicable gate):
|
|
86
86
|
|
|
87
|
-
1. Re-invoke `lisa:notion-to-
|
|
87
|
+
1. Re-invoke `lisa:notion-to-tracker` with `dry_run: false` to actually write the tickets. This re-runs Phases 1-5 and runs the preservation gate (Phase 5.5).
|
|
88
88
|
2. Capture the created ticket keys from the skill's output.
|
|
89
89
|
3. Post a Notion comment on the PRD via `mcp__claude_ai_Notion__notion-create-comment` listing the created tickets (epic, stories, sub-tasks) with their JIRA URLs. Lead with: `"Ticketed by Claude. Created N JIRA issues — see below. Move Status to Shipped after the work is delivered."`
|
|
90
90
|
4. Set `Status = Ticketed` via `notion-update-page`.
|
|
@@ -104,7 +104,7 @@ Per-ticket gates prove each ticket is well-formed; they do NOT prove the *set* o
|
|
|
104
104
|
| `GAPS_FOUND` | The created ticket set is incomplete. (a) For each gap, post a Notion comment using the same product-facing template as Phase 3c.3 — block-anchored via `selection_with_ellipsis` when `prd_anchor` is non-null, page-level otherwise; category badge from the gap's `category` field; `What's unclear` and `Recommendation` from the audit report's `what` and `recommendation` fields. Apply the same forbidden-language rules from Phase 3c.5. (b) Post one summary comment listing the tickets that *were* successfully created (so product knows what to keep vs. what to extend). (c) Transition `Status` from `Ticketed` back to `Blocked` via `notion-update-page`. |
|
|
105
105
|
| `NO_TICKETS_FOUND` | Should not happen if step 2 succeeded. If it does, log it as an Error in the cycle summary and leave `Status = Ticketed` with a comment flagging the audit failure for human review. |
|
|
106
106
|
|
|
107
|
-
3. The created tickets remain in
|
|
107
|
+
3. The created tickets remain in the destination tracker regardless of the verdict — they are valid in their own right (they passed `lisa:tracker-validate`). The audit only tells us whether *more* are needed.
|
|
108
108
|
|
|
109
109
|
The audit's report should be summarized in the cycle summary alongside the per-PRD outcome (e.g., `Ticketed (coverage: COMPLETE)` or `Blocked (coverage gaps: 3)`).
|
|
110
110
|
|
|
@@ -115,7 +115,7 @@ The audience for these comments is the **product team**, not engineers. They are
|
|
|
115
115
|
##### 3c.1 Partition failures
|
|
116
116
|
|
|
117
117
|
1. Drop every failure where `product_relevant = false`. Those are internal data-quality problems — the agent should fix its own spec rather than ask product to clarify a missing core field. Record the dropped failures under `Errors` in the cycle summary so engineers can see them; never surface them on the PRD.
|
|
118
|
-
2. Group the remaining product-relevant failures by `prd_anchor` (the snippet from `notion-to-
|
|
118
|
+
2. Group the remaining product-relevant failures by `prd_anchor` (the snippet from `notion-to-tracker`'s dry-run report). Failures that share an anchor become one comment thread on that block. Failures with `prd_anchor: null` are batched into one page-level summary comment, since they have no source section to attach to.
|
|
119
119
|
|
|
120
120
|
##### 3c.2 Render each comment
|
|
121
121
|
|
|
@@ -162,7 +162,7 @@ Use these exact badge labels — they are the validator's category values transl
|
|
|
162
162
|
|
|
163
163
|
- Gate IDs (`S4`, `F2`, etc.). Never appear in a comment body.
|
|
164
164
|
- JIRA terminology that has no product meaning (e.g. "Gherkin", "epic parent", "issue link", "validation journey", "sub-task hierarchy"). If the validator's `what` field uses one of these terms, paraphrase before posting; do not pass through verbatim.
|
|
165
|
-
- Internal skill names (`lisa:
|
|
165
|
+
- Internal skill names (`lisa:tracker-validate`, `notion-to-tracker`).
|
|
166
166
|
- Engineering shorthand (`AC`, `OOS`, `repo`, `env var`).
|
|
167
167
|
- "Clarify this" / "Please specify" without candidate resolutions. The validator is required to provide candidates; if `recommendation` is empty or vague, treat the failure as an Error and surface internally rather than posting a useless comment.
|
|
168
168
|
|
|
@@ -202,7 +202,7 @@ Print to the agent's output. Do not write this summary to Notion or JIRA — it'
|
|
|
202
202
|
## Idempotency & safety
|
|
203
203
|
|
|
204
204
|
- **Single-cycle scope**: this skill processes the Ready set as it exists at the start of Phase 2. New `Ready` PRDs added mid-cycle are picked up next run.
|
|
205
|
-
- **No writes outside the lifecycle**: this skill only ever writes to
|
|
205
|
+
- **No writes outside the lifecycle**: this skill only ever writes to the destination tracker via `lisa:notion-to-tracker` (which delegates to `lisa:tracker-write`), and only ever changes Notion `Status` to `In Review`, `Blocked`, or `Ticketed`. It never edits PRD content, never touches `Draft` or `Shipped`, never deletes pages.
|
|
206
206
|
- **Claim-first ordering**: `Status = In Review` is set BEFORE validation runs, so a re-entrant call won't double-process.
|
|
207
207
|
- **Failure isolation**: an exception processing one PRD must not stop the cycle. Catch, record under "Errors" in the summary, continue to the next PRD. The PRD that errored is left in `In Review` — the human investigates from there.
|
|
208
208
|
|
|
@@ -212,7 +212,7 @@ This skill reads project configuration from environment variables (or `$ARGUMENT
|
|
|
212
212
|
|
|
213
213
|
| Variable | Purpose |
|
|
214
214
|
|----------|---------|
|
|
215
|
-
| `JIRA_PROJECT` | JIRA project key for ticket creation (passed to `lisa:notion-to-
|
|
215
|
+
| `JIRA_PROJECT` | JIRA project key for ticket creation (passed to `lisa:notion-to-tracker`) |
|
|
216
216
|
| `JIRA_SERVER` | Atlassian instance host |
|
|
217
217
|
| `E2E_BASE_URL` | Frontend URL for `lisa:product-walkthrough` |
|
|
218
218
|
| `E2E_TEST_PHONE` / `E2E_TEST_OTP` / `E2E_TEST_ORG` | Test user creds for walkthrough + verification plans |
|
|
@@ -220,10 +220,10 @@ This skill reads project configuration from environment variables (or `$ARGUMENT
|
|
|
220
220
|
|
|
221
221
|
## Rules
|
|
222
222
|
|
|
223
|
-
- Never write to
|
|
223
|
+
- Never write to the destination tracker outside of `lisa:notion-to-tracker` → `lisa:tracker-write`. The validator's verdict gates progress; bypassing it produces broken tickets.
|
|
224
224
|
- Never set Notion `Status` to a value this skill doesn't own (`In Review`, `Blocked`, `Ticketed`). Product owns `Draft`, `Ready`, `Shipped`.
|
|
225
225
|
- Never edit the PRD's body. Communication with product happens only through Notion comments.
|
|
226
226
|
- Never post a single page-level dump of all gate failures. One comment per `prd_anchor` group (or one page-level summary for unanchored failures only). The audience is product, not engineers — comments must be block-anchored, categorized, plain-language, and contain a concrete recommendation. See Phase 3c.3 for the required template and Phase 3c.5 for forbidden language.
|
|
227
227
|
- Never include a gate ID, internal skill name, or engineering shorthand in a Notion comment body. If the validator's `what` or `recommendation` field uses one, paraphrase before posting.
|
|
228
228
|
- Never run more than one intake cycle concurrently against the same database. This skill assumes serial execution. (Scheduling is a separate concern; the runtime should not start a new cycle if a previous one is still in flight.)
|
|
229
|
-
- If `lisa:notion-to-
|
|
229
|
+
- If `lisa:notion-to-tracker` returns errors (e.g. unreachable artifact, malformed PRD structure), treat them as gate failures: comment + Blocked. Don't silently fail.
|