@codyswann/lisa 2.198.0 → 2.198.2
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/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa/.codex-plugin/skills/lisa-debrief/SKILL.md +3 -1
- package/plugins/lisa/.codex-plugin/skills/lisa-github-build-intake/SKILL.md +30 -34
- package/plugins/lisa/.codex-plugin/skills/lisa-implement/SKILL.md +6 -2
- package/plugins/lisa/.codex-plugin/skills/lisa-intake/SKILL.md +10 -16
- package/plugins/lisa/.codex-plugin/skills/lisa-jira-build-intake/SKILL.md +28 -32
- package/plugins/lisa/.codex-plugin/skills/lisa-linear-build-intake/SKILL.md +28 -32
- package/plugins/lisa/.codex-plugin/skills/lisa-monitor/SKILL.md +3 -1
- package/plugins/lisa/.codex-plugin/skills/lisa-plan/SKILL.md +6 -2
- package/plugins/lisa/.codex-plugin/skills/lisa-repair-intake/SKILL.md +13 -42
- package/plugins/lisa/.codex-plugin/skills/lisa-research/SKILL.md +3 -1
- package/plugins/lisa/.codex-plugin/skills/lisa-verify/SKILL.md +3 -1
- package/plugins/lisa/agents/github-agent.md +3 -1
- package/plugins/lisa/agents/github-build-intake.md +2 -2
- package/plugins/lisa/agents/jira-agent.md +3 -1
- package/plugins/lisa/agents/jira-build-intake.md +2 -2
- package/plugins/lisa/agents/linear-agent.md +3 -1
- package/plugins/lisa/agents/linear-build-intake.md +2 -2
- package/plugins/lisa/rules/eager/intent-routing.md +2 -2
- package/plugins/lisa/rules/reference/intent-routing.md +4 -4
- package/plugins/lisa/skills/lisa-debrief/SKILL.md +3 -1
- package/plugins/lisa/skills/lisa-github-build-intake/SKILL.md +31 -35
- package/plugins/lisa/skills/lisa-implement/SKILL.md +6 -2
- package/plugins/lisa/skills/lisa-intake/SKILL.md +10 -16
- package/plugins/lisa/skills/lisa-jira-build-intake/SKILL.md +29 -33
- package/plugins/lisa/skills/lisa-linear-build-intake/SKILL.md +29 -33
- package/plugins/lisa/skills/lisa-monitor/SKILL.md +3 -1
- package/plugins/lisa/skills/lisa-plan/SKILL.md +6 -2
- package/plugins/lisa/skills/lisa-repair-intake/SKILL.md +13 -42
- package/plugins/lisa/skills/lisa-research/SKILL.md +3 -1
- package/plugins/lisa/skills/lisa-verify/SKILL.md +3 -1
- package/plugins/lisa-agy/agents/github-agent.md +3 -1
- package/plugins/lisa-agy/agents/github-build-intake.md +2 -2
- package/plugins/lisa-agy/agents/jira-agent.md +3 -1
- package/plugins/lisa-agy/agents/jira-build-intake.md +2 -2
- package/plugins/lisa-agy/agents/linear-agent.md +3 -1
- package/plugins/lisa-agy/agents/linear-build-intake.md +2 -2
- package/plugins/lisa-agy/plugin.json +1 -1
- package/plugins/lisa-agy/skills/lisa-debrief/SKILL.md +3 -1
- package/plugins/lisa-agy/skills/lisa-github-build-intake/SKILL.md +31 -35
- package/plugins/lisa-agy/skills/lisa-implement/SKILL.md +6 -2
- package/plugins/lisa-agy/skills/lisa-intake/SKILL.md +10 -16
- package/plugins/lisa-agy/skills/lisa-jira-build-intake/SKILL.md +29 -33
- package/plugins/lisa-agy/skills/lisa-linear-build-intake/SKILL.md +29 -33
- package/plugins/lisa-agy/skills/lisa-monitor/SKILL.md +3 -1
- package/plugins/lisa-agy/skills/lisa-plan/SKILL.md +6 -2
- package/plugins/lisa-agy/skills/lisa-repair-intake/SKILL.md +13 -42
- package/plugins/lisa-agy/skills/lisa-research/SKILL.md +3 -1
- package/plugins/lisa-agy/skills/lisa-verify/SKILL.md +3 -1
- package/plugins/lisa-cdk/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-cdk/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-cdk-agy/plugin.json +1 -1
- package/plugins/lisa-cdk-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-cdk-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-copilot/agents/github-agent.agent.md +3 -1
- package/plugins/lisa-copilot/agents/github-build-intake.agent.md +2 -2
- package/plugins/lisa-copilot/agents/jira-agent.agent.md +3 -1
- package/plugins/lisa-copilot/agents/jira-build-intake.agent.md +2 -2
- package/plugins/lisa-copilot/agents/linear-agent.agent.md +3 -1
- package/plugins/lisa-copilot/agents/linear-build-intake.agent.md +2 -2
- package/plugins/lisa-copilot/rules/eager/intent-routing.md +2 -2
- package/plugins/lisa-copilot/rules/reference/intent-routing.md +4 -4
- package/plugins/lisa-copilot/skills/lisa-debrief/SKILL.md +3 -1
- package/plugins/lisa-copilot/skills/lisa-github-build-intake/SKILL.md +31 -35
- package/plugins/lisa-copilot/skills/lisa-implement/SKILL.md +6 -2
- package/plugins/lisa-copilot/skills/lisa-intake/SKILL.md +10 -16
- package/plugins/lisa-copilot/skills/lisa-jira-build-intake/SKILL.md +29 -33
- package/plugins/lisa-copilot/skills/lisa-linear-build-intake/SKILL.md +29 -33
- package/plugins/lisa-copilot/skills/lisa-monitor/SKILL.md +3 -1
- package/plugins/lisa-copilot/skills/lisa-plan/SKILL.md +6 -2
- package/plugins/lisa-copilot/skills/lisa-repair-intake/SKILL.md +13 -42
- package/plugins/lisa-copilot/skills/lisa-research/SKILL.md +3 -1
- package/plugins/lisa-copilot/skills/lisa-verify/SKILL.md +3 -1
- package/plugins/lisa-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-cursor/agents/github-agent.md +3 -1
- package/plugins/lisa-cursor/agents/github-build-intake.md +2 -2
- package/plugins/lisa-cursor/agents/jira-agent.md +3 -1
- package/plugins/lisa-cursor/agents/jira-build-intake.md +2 -2
- package/plugins/lisa-cursor/agents/linear-agent.md +3 -1
- package/plugins/lisa-cursor/agents/linear-build-intake.md +2 -2
- package/plugins/lisa-cursor/rules/intent-routing-reference.mdc +4 -4
- package/plugins/lisa-cursor/rules/intent-routing.mdc +2 -2
- package/plugins/lisa-cursor/skills/lisa-debrief/SKILL.md +3 -1
- package/plugins/lisa-cursor/skills/lisa-github-build-intake/SKILL.md +31 -35
- package/plugins/lisa-cursor/skills/lisa-implement/SKILL.md +6 -2
- package/plugins/lisa-cursor/skills/lisa-intake/SKILL.md +10 -16
- package/plugins/lisa-cursor/skills/lisa-jira-build-intake/SKILL.md +29 -33
- package/plugins/lisa-cursor/skills/lisa-linear-build-intake/SKILL.md +29 -33
- package/plugins/lisa-cursor/skills/lisa-monitor/SKILL.md +3 -1
- package/plugins/lisa-cursor/skills/lisa-plan/SKILL.md +6 -2
- package/plugins/lisa-cursor/skills/lisa-repair-intake/SKILL.md +13 -42
- package/plugins/lisa-cursor/skills/lisa-research/SKILL.md +3 -1
- package/plugins/lisa-cursor/skills/lisa-verify/SKILL.md +3 -1
- package/plugins/lisa-expo/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-expo/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-expo-agy/plugin.json +1 -1
- package/plugins/lisa-expo-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-expo-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric-agy/plugin.json +1 -1
- package/plugins/lisa-harper-fabric-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-harper-fabric-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs-agy/plugin.json +1 -1
- package/plugins/lisa-nestjs-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-nestjs-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw-agy/plugin.json +1 -1
- package/plugins/lisa-openclaw-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-openclaw-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser-agy/plugin.json +1 -1
- package/plugins/lisa-phaser-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-phaser-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-rails/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-rails/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-rails-agy/plugin.json +1 -1
- package/plugins/lisa-rails-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-rails-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript-agy/plugin.json +1 -1
- package/plugins/lisa-typescript-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-typescript-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki/.codex-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki-agy/plugin.json +1 -1
- package/plugins/lisa-wiki-copilot/.claude-plugin/plugin.json +1 -1
- package/plugins/lisa-wiki-cursor/.claude-plugin/plugin.json +1 -1
- package/plugins/src/base/agents/github-agent.md +3 -1
- package/plugins/src/base/agents/github-build-intake.md +2 -2
- package/plugins/src/base/agents/jira-agent.md +3 -1
- package/plugins/src/base/agents/jira-build-intake.md +2 -2
- package/plugins/src/base/agents/linear-agent.md +3 -1
- package/plugins/src/base/agents/linear-build-intake.md +2 -2
- package/plugins/src/base/rules/eager/intent-routing.md +2 -2
- package/plugins/src/base/rules/reference/intent-routing.md +4 -4
- package/plugins/src/base/skills/lisa-debrief/SKILL.md +3 -1
- package/plugins/src/base/skills/lisa-github-build-intake/SKILL.md +31 -35
- package/plugins/src/base/skills/lisa-implement/SKILL.md +6 -2
- package/plugins/src/base/skills/lisa-intake/SKILL.md +10 -16
- package/plugins/src/base/skills/lisa-jira-build-intake/SKILL.md +29 -33
- package/plugins/src/base/skills/lisa-linear-build-intake/SKILL.md +29 -33
- package/plugins/src/base/skills/lisa-monitor/SKILL.md +3 -1
- package/plugins/src/base/skills/lisa-plan/SKILL.md +6 -2
- package/plugins/src/base/skills/lisa-repair-intake/SKILL.md +13 -42
- package/plugins/src/base/skills/lisa-research/SKILL.md +3 -1
- package/plugins/src/base/skills/lisa-verify/SKILL.md +3 -1
|
@@ -114,7 +114,9 @@ If the type label is missing, read the body to classify and surface the missing
|
|
|
114
114
|
|
|
115
115
|
### 5. Delegate to Flow
|
|
116
116
|
|
|
117
|
-
Hand off to the appropriate flow
|
|
117
|
+
Hand off to the appropriate flow by invoking its lifecycle skill via the Skill tool — `lisa-implement` for Build / Fix / Improve / Investigate-Only, `lisa-plan` for Plan (Epics) — passing the full issue context (body, acceptance criteria, credentials, reproduction steps). The lifecycle skill owns orchestration: invoked from the lead session, its preamble assembles the per-item agent team (input-resolver, Roster Decision, specialist fanout) as defined in the `intent-routing` rule.
|
|
118
|
+
|
|
119
|
+
If this workflow is executing inside a spawned subagent or teammate (it should instead run in-session in the lead — see `lisa-github-build-intake` Phase 3c), do NOT run the flow inline and do NOT spawn named teammates: return a structured flow-request (flow, work type, context bundle) to your caller so the lead session can invoke the lifecycle skill with full team authority.
|
|
118
120
|
|
|
119
121
|
### 6. Sync Progress at Milestones
|
|
120
122
|
|
|
@@ -33,9 +33,9 @@ If no repo is provided, stop and ask. Never run intake against a default scope
|
|
|
33
33
|
|
|
34
34
|
### 2. Run the intake skill
|
|
35
35
|
|
|
36
|
-
Invoke the `github-build-intake` skill with the repo as `$ARGUMENTS`. The skill owns the cycle logic — query, claim, dispatch
|
|
36
|
+
Invoke the `github-build-intake` skill with the repo as `$ARGUMENTS`. The skill owns the cycle logic — query, claim, in-session lifecycle dispatch (the github-agent workflow culminating in the lisa-implement skill), relabel on success, summary. Do not duplicate that logic here.
|
|
37
37
|
|
|
38
|
-
The skill
|
|
38
|
+
The skill runs the github-agent workflow in-session per issue — read full graph, verify, triage, then route to the flow by invoking its lifecycle skill (lisa-implement / lisa-plan) via the Skill tool, plus sync progress and post evidence. Never spawn github-agent (or the lifecycle flow) as a subagent — the lifecycle skill must run in the lead session so it can create its agent team.
|
|
39
39
|
|
|
40
40
|
### 3. Surface the summary
|
|
41
41
|
|
|
@@ -93,7 +93,9 @@ If the ticket type is ambiguous, read the description to classify. A "Task" that
|
|
|
93
93
|
|
|
94
94
|
### 5. Delegate to Flow
|
|
95
95
|
|
|
96
|
-
Hand off to the appropriate flow
|
|
96
|
+
Hand off to the appropriate flow by invoking its lifecycle skill via the Skill tool — `lisa-implement` for Build / Fix / Improve / Investigate-Only, `lisa-plan` for Plan (Epics) — passing the full ticket context (description, acceptance criteria, credentials, reproduction steps). The lifecycle skill owns orchestration: invoked from the lead session, its preamble assembles the per-item agent team (input-resolver, Roster Decision, specialist fanout) as defined in the `intent-routing` rule.
|
|
97
|
+
|
|
98
|
+
If this workflow is executing inside a spawned subagent or teammate (it should instead run in-session in the lead — see `lisa-jira-build-intake` Phase 3c), do NOT run the flow inline and do NOT spawn named teammates: return a structured flow-request (flow, work type, context bundle) to your caller so the lead session can invoke the lifecycle skill with full team authority.
|
|
97
99
|
|
|
98
100
|
### 6. Sync Progress at Milestones
|
|
99
101
|
|
|
@@ -33,9 +33,9 @@ If no query is provided, stop and ask. Never run intake against a default scope
|
|
|
33
33
|
|
|
34
34
|
### 2. Run the intake skill
|
|
35
35
|
|
|
36
|
-
Invoke the `jira-build-intake` skill with the query as `$ARGUMENTS`. The skill owns the cycle logic — JQL execution, claim, dispatch
|
|
36
|
+
Invoke the `jira-build-intake` skill with the query as `$ARGUMENTS`. The skill owns the cycle logic — JQL execution, claim, in-session lifecycle dispatch (the jira-agent workflow culminating in the lisa-implement skill), transition on success, summary. Do not duplicate that logic here.
|
|
37
37
|
|
|
38
|
-
The skill
|
|
38
|
+
The skill runs the jira-agent workflow in-session per ticket — read full graph, verify, triage, then route to the flow by invoking its lifecycle skill (lisa-implement / lisa-plan) via the Skill tool, plus sync progress and post evidence. Never spawn jira-agent (or the lifecycle flow) as a subagent — the lifecycle skill must run in the lead session so it can create its agent team.
|
|
39
39
|
|
|
40
40
|
### 3. Surface the summary
|
|
41
41
|
|
|
@@ -95,7 +95,9 @@ Linear doesn't have a single "issue type" field like JIRA — type is typically
|
|
|
95
95
|
|
|
96
96
|
### 5. Delegate to Flow
|
|
97
97
|
|
|
98
|
-
Hand off to the appropriate flow
|
|
98
|
+
Hand off to the appropriate flow by invoking its lifecycle skill via the Skill tool — `lisa-implement` for Build / Fix / Improve / Investigate-Only, `lisa-plan` for Plan (Epic-equivalents) — passing the full item context (description, acceptance criteria, credentials, reproduction steps). The lifecycle skill owns orchestration: invoked from the lead session, its preamble assembles the per-item agent team (input-resolver, Roster Decision, specialist fanout) as defined in the `intent-routing` rule.
|
|
99
|
+
|
|
100
|
+
If this workflow is executing inside a spawned subagent or teammate (it should instead run in-session in the lead — see `lisa-linear-build-intake` Phase 3c), do NOT run the flow inline and do NOT spawn named teammates: return a structured flow-request (flow, work type, context bundle) to your caller so the lead session can invoke the lifecycle skill with full team authority.
|
|
99
101
|
|
|
100
102
|
### 6. Sync Progress at Milestones
|
|
101
103
|
|
|
@@ -33,9 +33,9 @@ If no query is provided AND no `linear.teamKey` is configured, stop and ask. Nev
|
|
|
33
33
|
|
|
34
34
|
### 2. Run the intake skill
|
|
35
35
|
|
|
36
|
-
Invoke the `linear-build-intake` skill with the query as `$ARGUMENTS`. The skill owns the cycle logic — Linear MCP queries, claim, dispatch
|
|
36
|
+
Invoke the `linear-build-intake` skill with the query as `$ARGUMENTS`. The skill owns the cycle logic — Linear MCP queries, claim, in-session lifecycle dispatch (the linear-agent workflow culminating in the lisa-implement skill), transition on success, summary. Do not duplicate that logic here.
|
|
37
37
|
|
|
38
|
-
The skill
|
|
38
|
+
The skill runs the linear-agent workflow in-session per Issue — read full graph, verify, triage, then route to the flow by invoking its lifecycle skill (lisa-implement / lisa-plan) via the Skill tool, plus sync progress and post evidence. Never spawn linear-agent (or the lifecycle flow) as a subagent — the lifecycle skill must run in the lead session so it can create its agent team.
|
|
39
39
|
|
|
40
40
|
### 3. Surface the summary
|
|
41
41
|
|
|
@@ -6,10 +6,10 @@
|
|
|
6
6
|
2. **Echo the chosen flow** with a one-sentence justification. Example:
|
|
7
7
|
> **Flow: Implement/Fix** — bug report with reproduction steps.
|
|
8
8
|
3. **Echo orchestration mode in the same message.** One of:
|
|
9
|
-
> **Orchestration: agent team** — Research, Plan, Implement, Intake, Debrief, and any flow that invokes Review.
|
|
9
|
+
> **Orchestration: agent team** — Research, Plan, Implement, Intake, Debrief, and any flow that invokes Review. (For Intake, the team is created by the per-item lifecycle skill — `lisa-plan` / `lisa-implement` — that Intake dispatches in-session; Intake itself is a thin dispatcher and never creates a team or spawns the lifecycle flow as a subagent.)
|
|
10
10
|
> **Orchestration: single agent** — Verify (standalone), Monitor (standalone), product-walkthrough standalone, debrief-apply, one-off diagnostic sessions.
|
|
11
11
|
4. **Check the readiness gate.** If gate fails interactively, ask for what's missing with recommended answers; do not start work. Headless/`-p` sessions infer from available context instead of blocking.
|
|
12
|
-
5. **Cascade rule.**
|
|
12
|
+
5. **Cascade rule.** You are inside an agent team only if you are yourself a spawned teammate/subagent (spawned into a team context, or reporting to a team lead). In that case do **not** create a second team — add specialists through the existing lead: on Claude, teams are flat, so message the lead with teammate + assignment; on Codex, use `multi_agent_v1.spawn_agent`. A lead session that spawned subagents earlier is still the lead — a lifecycle skill invoked there (including by `lisa-intake`) creates its team normally.
|
|
13
13
|
|
|
14
14
|
Once a flow is established, **do not re-classify** on later messages, even if a follow-up looks vague ("now run the tests", "thanks"). Subsequent messages inherit the established flow unless the user explicitly changes scope.
|
|
15
15
|
|
|
@@ -32,9 +32,9 @@ What this rule still enforces:
|
|
|
32
32
|
> **Orchestration: agent team** (or **single agent**)
|
|
33
33
|
> One-sentence justification.
|
|
34
34
|
|
|
35
|
-
2. **Cascade rule (load-bearing)**: Before creating a team,
|
|
35
|
+
2. **Cascade rule (load-bearing)**: Before creating a team, determine your role. You are *inside* an agent team only if you are yourself a spawned teammate/subagent — you were spawned into a team context, or your context references a team lead you report to. A lead/root session is never "inside" a team in this sense, even when a prior team-creation or `Agent` call exists in the session: the lead simply keeps using its existing team (or forms one with its first named spawn) — including when a lifecycle skill is invoked there by `lisa-intake`. If you ARE a spawned teammate, **do NOT create a second team** — many harnesses reject double-creates and the work stalls — and do NOT collapse the nested flow into inline single-agent work. The nested flow must request the existing team lead add the specialist agent(s) it needs to the current team and coordinate through the shared task state. On Claude, teammates cannot add named teammates (teams are flat), so message the lead with the teammate(s), assignments, and completion criteria. On Codex, ask the addressable lead/root to `multi_agent_v1.spawn_agent` the specialists; if no lead handle exists but spawning is available, spawn the bounded specialist agent(s), `wait_agent`, and relay results upward. Invoke flows via the Skill tool; never satisfy a team-first flow by doing all the work inline.
|
|
36
36
|
|
|
37
|
-
3. **Default mode**: `Research`, `Plan`, `Implement`, `Intake`, and `Debrief` run as agent teams. The `Implement` flow — including every work type (`Build`, `Fix`, `Improve`, `Investigate-Only`) — is **always** a team flow. Bug fixes that "look simple" are not an exception: the Reproduce sub-flow, debug-specialist, bug-fixer, parallel reviewers, and verification-specialist all need to compose. `Debrief` runs as a team because tracker-mining and pr-mining parallelize cleanly and synthesis gates on both completing. `Verify` (standalone) and `Monitor` (standalone) use the One-shot Sub-agents pattern (see `## Orchestration` below) — these flows are linear with no parallelism and the team overhead is not warranted. Single-agent mode is otherwise reserved for: `product-walkthrough` invoked standalone (not as part of Research/Plan), `debrief-apply` (deterministic routing of human-marked dispositions), and one-off diagnostic Bash/Read sessions that don't invoke any lifecycle skill. When in doubt, use a team.
|
|
37
|
+
3. **Default mode**: `Research`, `Plan`, `Implement`, `Intake`, and `Debrief` run as agent teams. (`Intake` is a special case: the Intake skill itself is a thin dispatcher that creates no team and never spawns the lifecycle flow as a subagent — the team is created by the per-item lifecycle skill, `lisa-plan` or `lisa-implement`, that Intake dispatches in-session, so the session still runs as an agent team.) The `Implement` flow — including every work type (`Build`, `Fix`, `Improve`, `Investigate-Only`) — is **always** a team flow. Bug fixes that "look simple" are not an exception: the Reproduce sub-flow, debug-specialist, bug-fixer, parallel reviewers, and verification-specialist all need to compose. `Debrief` runs as a team because tracker-mining and pr-mining parallelize cleanly and synthesis gates on both completing. `Verify` (standalone) and `Monitor` (standalone) use the One-shot Sub-agents pattern (see `## Orchestration` below) — these flows are linear with no parallelism and the team overhead is not warranted. Single-agent mode is otherwise reserved for: `product-walkthrough` invoked standalone (not as part of Research/Plan), `debrief-apply` (deterministic routing of human-marked dispositions), and one-off diagnostic Bash/Read sessions that don't invoke any lifecycle skill. When in doubt, use a team.
|
|
38
38
|
|
|
39
39
|
The mechanical team bootstrap directive lives inside each lifecycle skill — see those skills' orchestration preambles for the exact wording. Modern Claude Code uses the implicit team model (the first `Agent` spawn establishes the team); older Claude Code may still expose `TeamCreate`. Other runtimes must use their equivalent team-discovery and team-creation tools, or explicitly declare the no-team fallback when no such tool exists.
|
|
40
40
|
|
|
@@ -329,12 +329,12 @@ The `observability-audit` rule owns the profile detection, rubric, anomaly thres
|
|
|
329
329
|
|
|
330
330
|
When the request references a tracker ticket (a JIRA key like `PROJ-123`, a JIRA URL, a GitHub issue URL, an `org/repo#<n>` token, or a Linear identifier like `ENG-123` or a Linear project URL):
|
|
331
331
|
|
|
332
|
-
1. Hand off to the matching vendor agent — `jira-agent` (JIRA refs), `github-agent` (GitHub Issue refs), or `linear-agent` (Linear identifier or project URL). The configured destination tracker (`.lisa.config.json` `tracker`) is the default when the ref shape is ambiguous.
|
|
332
|
+
1. Hand off to the matching vendor agent workflow — `jira-agent` (JIRA refs), `github-agent` (GitHub Issue refs), or `linear-agent` (Linear identifier or project URL). The configured destination tracker (`.lisa.config.json` `tracker`) is the default when the ref shape is ambiguous. **Execution mode**: run the vendor agent's workflow in the current (lead) session — its read/verify/triage gates are Skill invocations — and do NOT spawn the vendor agent as a subagent for build work, because step 6's flow delegation must invoke the lifecycle skill (`lisa-implement` / `lisa-plan`) from the lead session, where it can create its agent team.
|
|
333
333
|
2. The agent reads the work item fully via the matching read skill (`jira-read-ticket` / `github-read-issue` / `linear-read-issue`) — description / body, comments, attachments, linked items, parent (Epic / Project / parent Issue), siblings.
|
|
334
334
|
3. The agent validates item quality via the matching verify skill (`jira-verify` / `github-verify` / `linear-verify`).
|
|
335
335
|
4. The agent runs analytical triage via the vendor-neutral `ticket-triage` skill.
|
|
336
336
|
5. If triage finds unresolved ambiguities (`BLOCKED` verdict), the agent posts findings and STOPS -- no work begins.
|
|
337
|
-
6. The agent determines intent and delegates to the appropriate flow:
|
|
337
|
+
6. The agent determines intent and delegates to the appropriate flow by invoking its lifecycle skill (`lisa-implement` for Build / Fix / Improve / Investigate-Only, `lisa-plan` for Plan) via the Skill tool from the lead session:
|
|
338
338
|
|
|
339
339
|
| Item kind | Flow | Work Type |
|
|
340
340
|
|-----------|------|-----------|
|
|
@@ -10,7 +10,9 @@ Walk the original Plan for `$ARGUMENTS`, mine the completed work items and their
|
|
|
10
10
|
|
|
11
11
|
## Orchestration: agent team
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
You are "inside an agent team" only if you are yourself a spawned teammate or subagent — you were spawned into a team context, or your context names a team lead you report to. A lead/root session that has previously spawned subagents is still the lead and retains full authority to create this flow's team.
|
|
14
|
+
|
|
15
|
+
If you are NOT inside an agent team by that definition, the very first thing you do is establish team orchestration.
|
|
14
16
|
|
|
15
17
|
Use the team tool for the current runtime:
|
|
16
18
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: lisa-github-build-intake
|
|
3
|
-
description: "GitHub counterpart to lisa-jira-build-intake. Scans a GitHub repository for issues carrying the configured `ready` build label, processes the first eligible issue, runs leaf work via
|
|
3
|
+
description: "GitHub counterpart to lisa-jira-build-intake. Scans a GitHub repository for issues carrying the configured `ready` build label, processes the first eligible issue, runs leaf work via the github-agent workflow in-session (culminating in lisa-implement), relabels to the configured `done` label on completion, then exits. Enforces the claim-time arm of the `leaf-only-lifecycle` rule: a parent/container with open child work (or a childless Epic) that still carries a stale build-ready label is moved out of the ready pickup queue into the configured `claimed` label with a lifecycle-repair comment, never dispatched to the build lifecycle. The `ready` label is the human-flipped signal that an issue is truly ready for direct development pickup — mirroring how Notion PRDs work product Draft → Ready → (us) In Review → Blocked|Ticketed."
|
|
4
4
|
allowed-tools: ["Skill", "Bash"]
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -12,7 +12,7 @@ allowed-tools: ["Skill", "Bash"]
|
|
|
12
12
|
2. A full GitHub repo URL (e.g., `https://github.com/acme/frontend-v2`).
|
|
13
13
|
3. The literal token `github` — falls back to `.lisa.config.json` (`github.org` / `github.repo`).
|
|
14
14
|
|
|
15
|
-
Run one build-intake cycle. The first eligible issue in the configured `ready` build label is claimed, built via the `
|
|
15
|
+
Run one build-intake cycle. The first eligible issue in the configured `ready` build label is claimed, built via the `github-agent` workflow run in-session (Phase 3c, culminating in `lisa-implement`), relabeled to the configured `done` label (env-aware — see Workflow resolution), then the cycle exits. Remaining ready issues stay queued for later scheduler invocations.
|
|
16
16
|
|
|
17
17
|
This skill also accepts an optional `assignee=<github-login>` queue filter. Resolve it in this
|
|
18
18
|
order:
|
|
@@ -91,13 +91,13 @@ In prose below, the role names refer to the resolved labels: e.g. "the `ready` l
|
|
|
91
91
|
|
|
92
92
|
## Confirmation policy
|
|
93
93
|
|
|
94
|
-
Do NOT ask the caller whether to proceed. Once invoked with a repo, run the cycle to completion — claim and dispatch the first eligible issue through
|
|
94
|
+
Do NOT ask the caller whether to proceed. Once invoked with a repo, run the cycle to completion — claim and dispatch the first eligible issue through the in-session lifecycle (Phase 3c), relabel a successful build to `$DONE`, write the summary, and exit. The caller (a human or a cron) has already authorized the run by invoking the skill; re-prompting defeats the purpose of a background queue.
|
|
95
95
|
|
|
96
96
|
Specifically forbidden:
|
|
97
97
|
|
|
98
98
|
- Previewing projected scope (issue count, projected PR count, build duration) and asking whether to continue.
|
|
99
99
|
- Offering A/B/C-style choices like "proceed / skip a few / dry-run only".
|
|
100
|
-
- Pausing because the queue is large, issues look complex, or issues are likely to be `Blocked` by
|
|
100
|
+
- Pausing because the queue is large, issues look complex, or issues are likely to be `Blocked` by the pre-flight gate. Pre-flight `Blocked` is a valid terminal state of the per-issue lifecycle, not a failure mode.
|
|
101
101
|
- Pausing because the build flow looks expensive.
|
|
102
102
|
|
|
103
103
|
The only legitimate reasons to stop early:
|
|
@@ -179,7 +179,7 @@ GitHub Issues live in one repo by definition, so the scanned repo's issues are u
|
|
|
179
179
|
|
|
180
180
|
Build intake dispatches **only independently implementable leaf work units** to the build agent. This enforces the claim-time arm of the vendor-neutral `leaf-only-lifecycle` rule: a parent/container that still carries a stale build-ready role (e.g. `status:ready` applied before this rule existed, or hand-applied to an Epic/Story) is **never dispatched** — intake moves it out of the pickup queue by replacing `$READY` with `$CLAIMED`, then posts a clear lifecycle-repair message. It is the claim-time complement to the write-time labeling in `lisa-github-write-issue` and the validate-time S15 gate in `lisa-github-validate-issue`; all three cite the same rule so the classification never drifts. **Never silently implement a container.**
|
|
181
181
|
|
|
182
|
-
Run this gate **before** the leaf claim relabel, starting with the oldest/highest-priority ready candidate. Do NOT comment "Claimed" or
|
|
182
|
+
Run this gate **before** the leaf claim relabel, starting with the oldest/highest-priority ready candidate. Do NOT comment "Claimed" or dispatch the lifecycle for an issue that fails the gate. A container repair still changes labels: remove `$READY`, add `$CLAIMED`, explain that parent/container `$CLAIMED` means rollup/build-lane progress through child/leaf work rather than direct implementation, record it, and end the cycle.
|
|
183
183
|
|
|
184
184
|
**Resolve container vs. leaf — structural first, then nominal.** Per `leaf-only-lifecycle` the classification is structural: an issue is a **container** if it has **open** child work, whatever its declared type; otherwise the **type label** decides. Resolve child work using the same hierarchy `lisa-github-read-issue` uses — native sub-issues first, then body parentage (task-list checkboxes referencing other issues, `Parent: #<n>` references). Dependency links such as `Blocked by:` are not parentage; they are handled by the active dependency hold gate below.
|
|
185
185
|
|
|
@@ -214,7 +214,7 @@ Classify and act (first match wins). `type:` is read from the issue's labels (`t
|
|
|
214
214
|
|
|
215
215
|
The childless-parent exception promotes every childless type **except Epic** to a dispatchable leaf: a childless Story is a directly shippable increment and a childless Spike *is* the investigation unit, so neither is stranded. Only a childless **Epic** is held back — an Epic is a pure rollup container by design, and a childless one is an incomplete decomposition or a mis-applied role, moved out of the ready pickup queue for repair/rollup and never dispatched.
|
|
216
216
|
|
|
217
|
-
**Lifecycle repair (default action for a flagged container).** Move the issue out of the pickup queue by removing `$READY` and adding `$CLAIMED`, post a single lifecycle-repair comment, and record the issue under "Repaired (container)" in the summary. Do NOT
|
|
217
|
+
**Lifecycle repair (default action for a flagged container).** Move the issue out of the pickup queue by removing `$READY` and adding `$CLAIMED`, post a single lifecycle-repair comment, and record the issue under "Repaired (container)" in the summary. Do NOT dispatch the lifecycle. Keep the comment idempotent — skip posting if an identical `[claude-build-intake]` lifecycle-repair comment already exists on the issue, so a re-entrant cycle doesn't spam it.
|
|
218
218
|
|
|
219
219
|
```bash
|
|
220
220
|
gh issue edit <number> --repo <org>/<repo> --remove-label "$READY" --add-label "$CLAIMED"
|
|
@@ -239,7 +239,7 @@ Default cleared blocker labels for GitHub build intake are:
|
|
|
239
239
|
- `status:on-stg`
|
|
240
240
|
- `status:done`
|
|
241
241
|
|
|
242
|
-
A blocker is active if it is open and has no cleared status label. Treat `status:ready`, `status:in-progress`, missing status labels, and inaccessible blockers as active. Closed blockers are cleared. If any blocker is active, skip the candidate without changing lifecycle labels, without posting "Claimed", and without
|
|
242
|
+
A blocker is active if it is open and has no cleared status label. Treat `status:ready`, `status:in-progress`, missing status labels, and inaccessible blockers as active. Closed blockers are cleared. If any blocker is active, skip the candidate without changing lifecycle labels, without posting "Claimed", and without dispatching the lifecycle. Record it under "Skipped (active blockers)" in the summary and include the active blocker refs. Keep any dependency-hold comment idempotent with a `[claude-build-intake]` prefix.
|
|
243
243
|
|
|
244
244
|
#### 3b. Claim
|
|
245
245
|
|
|
@@ -256,44 +256,40 @@ This is the idempotency lock — a re-entrant cycle's `--label $READY` filter wi
|
|
|
256
256
|
|
|
257
257
|
If the relabel fails (permission, race), log under "Errors" in the cycle summary and skip this issue. **Do not invoke the build flow on an issue you didn't successfully claim.**
|
|
258
258
|
|
|
259
|
-
#### 3c.
|
|
259
|
+
#### 3c. Run the per-issue lifecycle in-session (never as a subagent)
|
|
260
260
|
|
|
261
|
-
After the claim succeeds, the per-issue
|
|
261
|
+
After the claim succeeds, run the per-issue lifecycle defined by the `github-agent` workflow **in the current session** — never by spawning `github-agent` (or any named worker) via the `Agent` tool. The lifecycle culminates in a team-first flow (`lisa-implement`), and that flow can only create its agent team from the lead session: a spawned teammate cannot add named teammates (Claude teams are flat), so dispatching the build into a subagent strands `lisa-implement` without its team and collapses the build into a single inline worker. Concretely:
|
|
262
262
|
|
|
263
|
-
|
|
264
|
-
-
|
|
265
|
-
-
|
|
263
|
+
1. **Run the gates in-session** via their skills, exactly as `github-agent.md` defines them and with all of its gating behaviors intact:
|
|
264
|
+
- `lisa-github-read-issue` — the full issue graph (mandatory; never ad-hoc `gh` reads)
|
|
265
|
+
- `lisa-github-verify` — pre-flight quality gate, including the draft-then-block procedure on FAIL
|
|
266
|
+
- `lisa-ticket-triage` — analytical triage gate (a `BLOCKED` verdict stops the cycle with findings posted)
|
|
267
|
+
- Intent determination from the `type:` label
|
|
268
|
+
2. **Dispatch the flow in-session:** when the gates pass, invoke the lifecycle skill via the Skill tool — `lisa-implement <org>/<repo>#<number>` for Build / Fix / Improve / Investigate-Only (or `lisa-plan` for an Epic) — passing the full context bundle from the read step. `lisa-implement`'s own orchestration preamble then creates the per-item agent team (input-resolver, Roster Decision, specialist fanout) exactly as a direct invocation would.
|
|
269
|
+
3. **Milestone sync and evidence** (`lisa-github-sync`, `lisa-github-evidence`) happen at the milestones the `github-agent` workflow defines, within the dispatched flow.
|
|
266
270
|
|
|
267
|
-
Return this payload
|
|
271
|
+
If you are somehow running this skill as a spawned teammate inside an existing team (nested misrouting — Intake keeps this chain in the lead session), do NOT run the lifecycle inline and do NOT spawn named peers. Return this payload to the lead so the lead session can run this Phase 3c in-session:
|
|
268
272
|
|
|
269
273
|
```json
|
|
270
274
|
{
|
|
271
275
|
"type": "delegation-request",
|
|
272
|
-
"
|
|
276
|
+
"phase": "github-build-intake 3c",
|
|
273
277
|
"workItem": "<org>/<repo>#<number>",
|
|
274
278
|
"context": {
|
|
275
279
|
"claimedLabel": "$CLAIMED",
|
|
276
280
|
"doneResolution": "Resolve $DONE from the PR base branch per this skill's Workflow resolution section"
|
|
277
281
|
},
|
|
278
282
|
"onSuccess": "Confirm the returned PR is merged, then apply Phase 3d and Phase 3d.1",
|
|
279
|
-
"onBlockedOrError": "Leave the issue where
|
|
283
|
+
"onBlockedOrError": "Leave the issue where the lifecycle left it and record the surfaced outcome"
|
|
280
284
|
}
|
|
281
285
|
```
|
|
282
286
|
|
|
283
|
-
|
|
284
|
-
- Reading the full issue graph (`lisa-github-read-issue`)
|
|
285
|
-
- Running its own pre-flight quality gate (`lisa-github-verify`)
|
|
286
|
-
- Running issue triage (`lisa-ticket-triage`)
|
|
287
|
-
- Routing to the appropriate flow (Build / Fix / Investigate / Improve based on `type:` label)
|
|
288
|
-
- Posting progress comments via `lisa-github-sync`
|
|
289
|
-
- Posting evidence via `lisa-github-evidence`
|
|
290
|
-
|
|
291
|
-
The lead waits for `lisa-github-agent` to return, then resumes this scanner with the returned outcome:
|
|
287
|
+
The lifecycle run returns one of the following outcomes; resume this scanner with it:
|
|
292
288
|
|
|
293
289
|
- **Success** — the build flow completed and a PR exists; evidence posted. The PR may already be **merged** or still **open** (auto-merge enabled, awaiting checks/merge). "Success" means the build work is sound — it does **not** assert the change reached an environment. The env transition in 3d gates on the PR actually being merged; an open PR does not advance the issue to a `done` env status.
|
|
294
|
-
- **Blocked by github-verify pre-flight gate** —
|
|
295
|
-
- **Duplicate already fixed** — `lisa-
|
|
296
|
-
- **Blocked by ticket-triage ambiguities** —
|
|
290
|
+
- **Blocked by github-verify pre-flight gate** — the pre-flight gate (github-agent workflow step 2) relabels the issue to `status:blocked` (or removes `$CLAIMED` and reassigns to the original author). This is correct and expected — let it stand. Record and move on.
|
|
291
|
+
- **Duplicate already fixed** — `lisa-ticket-triage` returned `DUPLICATE_ALREADY_FIXED` with a canonical issue reference and empirical base-branch evidence. Post the triage finding, ensure the native `duplicates <canonical>` relationship exists when GitHub exposes it (otherwise leave an explicit cross-reference comment/body link), remove `$CLAIMED`, add the terminal `$DONE` label, close the issue with `gh issue close --reason "not planned"`, and do not open a PR. If the canonical fix is merged but not yet on the production branch, the close comment must say the production error can recur until the canonical issue promotes and that recurrence is tracked by the canonical issue; do not reopen this duplicate for that recurrence.
|
|
292
|
+
- **Blocked by ticket-triage ambiguities** — triage posts findings and the lifecycle stops. The issue stays in `$CLAIMED`. Surface to human; do not auto-relabel. Record under "Errors".
|
|
297
293
|
- **Errored** — exception, missing config, etc. Leave the issue in `$CLAIMED` for human investigation. Record under "Errors".
|
|
298
294
|
|
|
299
295
|
#### 3c.1 Close duplicate already fixed
|
|
@@ -320,7 +316,7 @@ This path is distinct from `BLOCKED`: ambiguity, open blockers, and duplicate-of
|
|
|
320
316
|
|
|
321
317
|
A `done` env state (`status:on-dev`, `status:on-stg`, or the terminal value) asserts that the code has actually reached that environment. Never set it for a PR that is merely open: auto-merge can be blocked indefinitely (a required rebase / `BEHIND` branch, failing checks, an unaddressed review), and the change may never land. Relabeling an issue `status:on-stg` on an open PR makes it *claim* a deploy that never happened. Transition only after confirming the PR merged.
|
|
322
318
|
|
|
323
|
-
If
|
|
319
|
+
If the lifecycle run returned Success:
|
|
324
320
|
|
|
325
321
|
1. **Confirm the PR merged.** Read the live state of the issue's PR — `gh pr view <pr> --json state,mergedAt,mergeStateStatus,url`:
|
|
326
322
|
- **Merged** (`state == MERGED`) → proceed to resolve and apply `$DONE` below. Where the env deploy is observable (a deploy workflow run / deployment status keyed to the merged-into branch via `deploy.branches`), confirm it did not fail before relabeling; a still-running deploy is treated like an open PR (leave in `$CLAIMED`), a failed deploy is recorded as an Error.
|
|
@@ -345,7 +341,7 @@ gh issue close <number> --repo <org>/<repo> --reason completed
|
|
|
345
341
|
|
|
346
342
|
This close is idempotent: if the issue is already closed, record that native closure was already satisfied and continue. If `$DONE` is an intermediate env state, leave the issue open by design.
|
|
347
343
|
|
|
348
|
-
For any non-Success outcome, do NOT transition. The issue sits in `$CLAIMED` (or wherever
|
|
344
|
+
For any non-Success outcome, do NOT transition. The issue sits in `$CLAIMED` (or wherever the lifecycle left it) — humans take it from there.
|
|
349
345
|
|
|
350
346
|
#### 3d.1 Roll up the parent chain (forward rollup)
|
|
351
347
|
|
|
@@ -376,7 +372,7 @@ Issues processed: <n>
|
|
|
376
372
|
- PR open — awaiting merge (left in $CLAIMED for repair-intake): <n>
|
|
377
373
|
- <org>/<repo>#<number> <title> → PR <URL> (mergeStateStatus: <state>)
|
|
378
374
|
- Repaired (container — leaf-only-lifecycle): <n>
|
|
379
|
-
- <org>/<repo>#<number> <title> — build-ready on a parent/container; moved $READY → $CLAIMED without
|
|
375
|
+
- <org>/<repo>#<number> <title> — build-ready on a parent/container; moved $READY → $CLAIMED without dispatching the lifecycle; lifecycle-repair comment posted
|
|
380
376
|
- Skipped (active blockers): <n>
|
|
381
377
|
- <org>/<repo>#<number> <title> — waiting on <blocker refs>
|
|
382
378
|
- Duplicate already fixed (closed as duplicate): <n>
|
|
@@ -395,8 +391,8 @@ Total PRs opened: <n>
|
|
|
395
391
|
|
|
396
392
|
- **Leaf-only claim gate runs first**: Phase 3a classifies each candidate before any leaf claim; a container with open child work (or a childless Epic) is moved `$READY` → `$CLAIMED` as lifecycle repair and never dispatched. The lifecycle-repair comment is idempotent — a re-entrant cycle does not re-post it.
|
|
397
393
|
- **Dependency hold runs before leaf claim**: explicit `Blocked by:` relationships are resolved after container repair is ruled out but before `$READY → $CLAIMED`; active blockers leave the leaf candidate in `$READY` and are reported as skipped, not blocked.
|
|
398
|
-
- **Claim-first ordering**: `$CLAIMED` set BEFORE
|
|
399
|
-
- **No writes outside the lifecycle**: this skill only relabels `$READY → $CLAIMED` and `$CLAIMED → $DONE`. For containers, `$READY → $CLAIMED` is a lifecycle repair, not a direct build claim. Every other label change is owned by
|
|
394
|
+
- **Claim-first ordering**: `$CLAIMED` set BEFORE the lifecycle dispatch for leaves; containers are also moved to `$CLAIMED` to leave the ready pickup queue, but are not dispatched.
|
|
395
|
+
- **No writes outside the lifecycle**: this skill only relabels `$READY → $CLAIMED` and `$CLAIMED → $DONE`. For containers, `$READY → $CLAIMED` is a lifecycle repair, not a direct build claim. Every other label change is owned by the per-issue lifecycle (github-agent workflow).
|
|
400
396
|
- **Duplicate terminal exception**: `DUPLICATE_ALREADY_FIXED` is the only triage outcome that may close a claimed item without a PR from this cycle. It must include a canonical issue reference and empirical base-branch evidence, and it closes as duplicate/not-planned rather than as completed build work.
|
|
401
397
|
- **Terminal native closure**: after `$CLAIMED → $DONE`, close the GitHub issue only when `$DONE` is the true terminal done value per `leaf-only-lifecycle`; intermediate env labels stay open.
|
|
402
398
|
- **One item per cycle**: per-issue exceptions are caught and recorded, then the cycle exits. The scheduler owns retrying or moving on to the next ready item.
|
|
@@ -421,12 +417,12 @@ If the repo has not adopted the `status:*` label namespace, this skill cannot ru
|
|
|
421
417
|
|
|
422
418
|
- **Dispatch leaves only.** Per the `leaf-only-lifecycle` rule, never dispatch a container — an issue with open child work, or a childless Epic — even if it carries the build-ready role. Move it `$READY → $CLAIMED` as lifecycle repair (Phase 3a); never silently implement a container.
|
|
423
419
|
- Never relabel an issue outside the cycle's allowed transitions. The `$CLAIMED` label is the signature of cycle ownership for leaves, and the parent/container progress state for lifecycle repairs.
|
|
424
|
-
- Never
|
|
420
|
+
- Never do build work directly from this scanner — the per-issue lifecycle (the `github-agent` workflow culminating in `lisa-implement`) owns it. And never spawn that lifecycle as a subagent; run it in-session per Phase 3c so `lisa-implement` can create its agent team.
|
|
425
421
|
- Never auto-transition past `$DONE`. Downstream labels (terminal `status:done`, etc.) are owned by QA / PM / merge automation.
|
|
426
422
|
- Never close a GitHub issue at intermediate env states (`status:on-dev`, `status:on-stg`, or configured equivalents). Native close happens only at the terminal `done` value.
|
|
427
423
|
- Never auto-close a `BLOCKED`, ambiguous, or duplicate-of-open issue. Auto-close is allowed only for `DUPLICATE_ALREADY_FIXED`.
|
|
428
|
-
- If the issue has no Validation Journey or no sign-in credentials,
|
|
429
|
-
- On any unexpected
|
|
424
|
+
- If the issue has no Validation Journey or no sign-in credentials, the pre-flight verify gate will catch it — **don't try to fix the issue from here**.
|
|
425
|
+
- On any unexpected outcome from the lifecycle run (status it doesn't claim, missing PR URL on success), record as Error and surface — never assume.
|
|
430
426
|
- Never pick an arbitrary env for `$DONE` resolution. If `done` is a map and env is ambiguous, fail loudly.
|
|
431
427
|
|
|
432
428
|
## Adoption (one-time per repo)
|
|
@@ -9,7 +9,9 @@ description: This skill should be used for any non-trivial request — features,
|
|
|
9
9
|
|
|
10
10
|
Implement is a **team-first** flow. Bug, Build, Improve, and Investigate-Only all compose multiple specialists (Reproduce → debug → fix → review → verify). Single-agent mode is not permitted based on task complexity — the only exception is when no team creation or subagent delegation tool is available in the current runtime (see no-team fallback in the paragraph below).
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
You are "inside an agent team" only if you are yourself a spawned teammate or subagent — you were spawned into a team context, or your context names a team lead you report to. A lead/root session that has previously spawned subagents is still the lead: prior `Agent` calls in the session (e.g., an Intake cycle's bounded scan helpers) do NOT make this a nested flow, and the lead retains full authority to create this flow's team.
|
|
13
|
+
|
|
14
|
+
If you are NOT inside an agent team by that definition, the very first thing you do is establish team orchestration.
|
|
13
15
|
|
|
14
16
|
Use the team tool for the current runtime:
|
|
15
17
|
|
|
@@ -21,7 +23,9 @@ If no team creation or subagent delegation tool is available, explicitly state t
|
|
|
21
23
|
|
|
22
24
|
Your only permitted first move is establishing orchestration by spawning the bounded **input-resolver** teammate (Claude: `Agent`; Codex: `multi_agent_v1.spawn_agent`), or declaring the no-team fallback. The initial Claude `Agent` spawn is the only pre-team exception, and for Implement it must be the bounded input-resolver rather than a builder. Apart from that single spawn, do NOT call any of: a second `Agent`/`spawn_agent` for any worker, `TaskCreate`, `Skill` (including `lisa-tracker-read`, `lisa-jira-read-ticket`, `lisa-github-read-issue`), MCP tools (Atlassian / Linear / GitHub / Notion), `Read`, `Write`, `Edit`, `Bash`, `Grep`, `Glob` — until the input-resolver has returned and the Roster Decision has been recorded. Reading the ticket, exploring the code, fetching context — every one of those is a task for the team, not for the lead session before orchestration exists. Doing them inline, or spawning a single worker that does the whole build, is the exact bypass path that produces a 1-agent ad-hoc fix instead of a real team flow.
|
|
23
25
|
|
|
24
|
-
|
|
26
|
+
Note that `lisa-intake` dispatching this skill is NOT the nested case: Intake is a thin dispatcher that creates no team of its own and invokes this skill via the Skill tool in the lead session precisely so this preamble fires — treat an Intake dispatch exactly like a direct invocation and run the full team-first flow above.
|
|
27
|
+
|
|
28
|
+
If you ARE already inside an agent team by the definition above (you are a teammate that was handed this skill via the Skill tool from within another flow's team), do NOT create a second team — many harnesses reject double-creates — and do NOT collapse the nested flow into a single inline worker. A nested team-first flow must still bring in the specialists it requires by adding them to the existing team, not by doing the work itself:
|
|
25
29
|
|
|
26
30
|
- **Claude:** teams are flat and only the lead can add named teammates, so do NOT call `Agent` with a `name` from a teammate (the harness rejects it: *"Teammates cannot spawn other teammates — the team roster is flat"*). Send the team lead a message naming the specialist teammate(s) this flow needs, their task assignments, and completion criteria, then coordinate through the shared task list until they finish. An anonymous subagent (`Agent` with `name` omitted) is permitted only for bounded one-shot work whose result returns directly to you — it is not a substitute for the required lifecycle specialists.
|
|
27
31
|
- **Codex:** do NOT call `TeamCreate`. If the lead/root agent is addressable (you were given its id/handle), send it a request to `multi_agent_v1.spawn_agent` the specialist agent(s), including each agent's prompt, ownership, and expected result. If no lead handle exists but `spawn_agent` is available to you, spawn only the bounded specialist agent(s) this flow needs, `wait_agent` for their results, and relay those results upward to the parent/lead.
|
|
@@ -37,28 +37,22 @@ The only legitimate reasons to stop early:
|
|
|
37
37
|
- The queue itself is misconfigured (Status property missing expected values, JIRA workflow can't reach required transitions). Surface and exit.
|
|
38
38
|
- Empty `Ready` set. Exit cleanly with the idle-case message.
|
|
39
39
|
|
|
40
|
-
## Orchestration:
|
|
40
|
+
## Orchestration: thin dispatcher (no team of its own)
|
|
41
41
|
|
|
42
|
-
|
|
42
|
+
Intake creates NO agent team and spawns NO named teammates. It is a bounded scanner/dispatcher: resolve the queue, find the first eligible Ready item, claim it, and hand it to the single-item lifecycle skill — all in the current session.
|
|
43
43
|
|
|
44
|
-
|
|
44
|
+
This is deliberate. The per-item lifecycle skills (`lisa-plan` for PRDs, `lisa-implement` for build tickets) are team-first flows: each contains its own orchestration preamble that creates the agent team, records the roster, and fans out specialists. That preamble only has authority when the skill runs in the lead session — a teammate cannot add named teammates (Claude teams are flat: *"Teammates cannot spawn other teammates — the team roster is flat"*), so pushing the lifecycle skill down into a spawned subagent strands it without its team and collapses the flow into the single inline worker every team-first skill forbids. Therefore:
|
|
45
45
|
|
|
46
|
-
-
|
|
47
|
-
-
|
|
48
|
-
-
|
|
46
|
+
- **Scanning and claiming run inline in this session** (Bash / MCP / vendor skills via the Skill tool). This is cheap, bounded work — it does not need a team.
|
|
47
|
+
- **Per-item dispatch is a Skill-tool invocation in this same session — never an `Agent` spawn.** The chain Intake → vendor batch skill → lifecycle skill stays in the lead session end-to-end, so when `lisa-plan` / `lisa-implement` starts, its team-first preamble fires exactly as if the user had invoked it directly: it creates the per-item agent team, records the Roster Decision, and fans out its specialists.
|
|
48
|
+
- **Fresh context per item comes from the scheduler, not from subagent isolation.** Intake processes ONE eligible item per invocation and exits; each scheduled invocation is a fresh session. Never claim or process a second item after the first item's lifecycle flow has run in this session — exit and let the next cycle take it with clean context.
|
|
49
|
+
- The only permissible `Agent` use inside an Intake cycle is a bounded **anonymous** helper (`Agent` with `name` omitted) for scan-side legwork whose result returns directly to this session — e.g., paging a large queue. Never spawn the lifecycle flow, a vendor lifecycle agent (`jira-agent` / `github-agent` / `linear-agent`), or any implementation worker as a subagent from Intake.
|
|
49
50
|
|
|
50
|
-
|
|
51
|
+
Codex: the same contract applies — run the scan inline in the root session and invoke the lifecycle skill there so it can `multi_agent_v1.spawn_agent` its own team; do not `spawn_agent` the lifecycle flow itself. Other runtimes: apply the same rule through their equivalent delegation surface. If the runtime has no team/subagent tooling at all, the lifecycle skill's own no-team fallback handles it — Intake's job is unchanged.
|
|
51
52
|
|
|
52
|
-
|
|
53
|
+
If a teammate inside an existing team somehow invokes Intake (this should not happen — Intake is a session entry point, not a nested flow), do not scan or claim from there: return a structured `delegation-request` to the team lead asking it to run the Intake cycle in the lead session, and surface the misrouting.
|
|
53
54
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
- **Claude:** teams are flat and only the lead can add named teammates, so do NOT call `Agent` with a `name` from a teammate (the harness rejects it: *"Teammates cannot spawn other teammates — the team roster is flat"*). Send the team lead a message naming the specialist teammate(s) this flow needs, their task assignments, and completion criteria, then coordinate through the shared task list until they finish. An anonymous subagent (`Agent` with `name` omitted) is permitted only for bounded one-shot work whose result returns directly to you — it is not a substitute for the required lifecycle specialists.
|
|
57
|
-
- **Codex:** do NOT call `TeamCreate`. If the lead/root agent is addressable (you were given its id/handle), send it a request to `multi_agent_v1.spawn_agent` the specialist agent(s), including each agent's prompt, ownership, and expected result. If no lead handle exists but `spawn_agent` is available to you, spawn only the bounded specialist agent(s) this flow needs, `wait_agent` for their results, and relay those results upward to the parent/lead.
|
|
58
|
-
|
|
59
|
-
Treat the first successful lead-spawn request (or, on the Codex fallback, the first specialist spawn) as preserving team orchestration. Never satisfy a team-first lifecycle flow by doing all the work inline.
|
|
60
|
-
|
|
61
|
-
The cycle's outer team is created by Intake. The one item it processes (a PRD via `lisa-plan`, a ticket via `lisa-implement`) executes within that team — those skills' orchestration preambles detect the existing team and skip creating a second team. One team per cron cycle, one eligible Ready item per cycle.
|
|
55
|
+
One item per cycle. One team per item, created and owned by the lifecycle skill. A fresh session per cycle, provided by the scheduler.
|
|
62
56
|
|
|
63
57
|
## Source dispatch
|
|
64
58
|
|