Issue Lifecycle

@swamp/issue-lifecyclev2026.04.22.2· 8d agoMODELS·SKILLS

01README

Interactive triage and implementation planning for swamp-club lab issues. Drives the triage/plan/iterate/approve/implement loop as a local conversation with Claude, while posting structured lifecycle entries and status transitions back to the swamp-club issue on every step.

The model operates directly on swamp-club lab issue numbers — the issue must already exist in swamp-club before you start. There is no GitHub integration.

State Machine

created ──[start]──> triaging
triaging ──[triage]──> classified
classified ──[plan]──> plan_generated
plan_generated ──[iterate]──> plan_generated  (feedback loop)
plan_generated ──[approve]──> approved
approved ──[implement]──> implementing
implementing ──[link_pr]──> pr_open
pr_open ──[link_pr]──> pr_open  (idempotent re-link)
pr_open ──[complete]──> done
implementing ──[complete]──> done  (legacy, no PR linked)

Pre-flight checks enforce valid transitions: you cannot approve without a plan, cannot implement without approval, and cannot approve while critical or high adversarial findings remain unresolved. complete accepts both implementing and pr_open as source phases so legacy records (created before link_pr existed) can still reach done.

Methods

start — fetch issue context from swamp-club (fails if the issue does not exist)
triage — classify as bug/feature/security and PATCH the swamp-club issue type
plan — generate an implementation plan
review — display the current plan (read-only)
iterate — revise the plan with feedback (versioned)
adversarial_review — record adversarial review findings
resolve_findings — mark adversarial findings as resolved
approve — lock the plan and transition to in_progress
implement — signal implementation has started
link_pr — link an opaque pull request URL to the lifecycle record (idempotent; transitions to pr_open). Git-host agnostic — the model persists whatever URL the agent supplies without fetching anything.
complete — mark the lifecycle done

Data

All resources are versioned and immutable: state, context, classification, plan, feedback, adversarialReview, pullRequest.

Prerequisites

swamp initialized in the repository (swamp init)
SWAMP_API_KEY env var (or swamp auth login) for swamp-club access
The target lab issue must already exist in swamp-club

02Models1

@swamp/issue-lifecyclev2026.04.22.1issue_lifecycle.ts

fn start()

Ensure the swamp-club issue exists and begin the lifecycle

fn triage(confidence: enum, reasoning: string, isRegression?: boolean, clarifyingQuestions?: array)

Classify the issue based on context

Argument	Type	Required	Description
confidence	enum	yes
reasoning	string	yes
isRegression?	boolean	no	True if this is a regression (something that previously worked). Implies type=bug.
clarifyingQuestions?	array	no

fn plan(summary: string, dddAnalysis: string, steps: array, testingStrategy: string, potentialChallenges: array)

Generate an initial implementation plan

Argument	Type	Required
summary	string	yes
dddAnalysis	string	yes
steps	array	yes
testingStrategy	string	yes
potentialChallenges	array	yes

fn review(version?: number)

Display the current plan (read-only)

Argument	Type	Required	Description
version?	number	no	Specific plan version to review

fn iterate(feedback: string, summary: string, dddAnalysis: string, steps: array, testingStrategy: string, potentialChallenges: array)

Submit feedback and a revised plan incorporating all prior feedback

Argument	Type	Required	Description
feedback	string	yes	Human feedback on the current plan
summary	string	yes
dddAnalysis	string	yes
steps	array	yes
testingStrategy	string	yes
potentialChallenges	array	yes

fn adversarial_review(findings: array)

Record adversarial review findings for the current plan version

Argument	Type	Required	Description
findings	array	yes

fn resolve_findings(resolutions: array)

Mark adversarial review findings as resolved after plan revision

Argument	Type	Required	Description
resolutions	array	yes

fn approve()

Approve the current plan

fn implement()

Signal that implementation has started

fn link_pr(url: string)

Link a pull request to the implementation. Idempotent — calling

Argument	Type	Required	Description
url	string	yes	Canonical pull request URL. Opaque to the model — pass whatever

fn pr_merged(mergedAt?: string)

Record that the linked PR has been merged. Transitions to releasing.

Argument	Type	Required	Description
mergedAt?	string	no	ISO-8601 timestamp of when the PR was merged. Defaults to now.

fn pr_failed(reason: string)

Record that the linked PR has failed (CI failure, review rejection, etc.).

Argument	Type	Required	Description
reason	string	yes	Why the PR failed: CI failure details, review rejection reason, etc.

fn ship(releaseUrl?: string, releaseNotes?: string)

Mark the release as shipped after the release build completes.

Argument	Type	Required	Description
releaseUrl?	string	no	URL of the release (e.g., GitHub release page, package registry). Optional.
releaseNotes?	string	no	Brief release notes or summary. Optional.

fn complete()

Mark the issue lifecycle as done

Resources

state(infinite)— Current lifecycle phase and metadata

context(infinite)— Issue context fetched from swamp-club

classification(infinite)— Issue triage classification

plan(infinite)— Implementation plan (versioned across iterations)

feedback(infinite)— Human feedback on plan (versioned per round)

adversarialReview(infinite)— Adversarial review findings for the current plan version

pullRequest(infinite)— Pull request linked to the implementation. Single instance,

03Skills1

issue-lifecycle5 files

04Previous Versions4

2026.04.20.1Apr 20, 2026

Modified 1 models

2026.04.08.2Apr 8, 2026

Modified 1 models

2026.04.08.1Apr 8, 2026

Modified 1 models

2026.04.07.1Apr 7, 2026

05Stats

100 / 100

Downloads

Archive size

34.8 KB

Verified by Swamp

Has README or module doc2/2earned
README has a code example1/1earned
README is substantive1/1earned
Most symbols documented1/1earned
No slow types1/1earned
Has description1/1earned
At least one platform tag (or universal)1/1earned
Two or more platform tags (or universal)1/1earned
License declared1/1earned
Verified public repository2/2earned

Repository

https://github.com/systeminit/swamp-extensions

06Security Notice

This extension includes AI agent skills that can modify AI assistant behavior. Review the skill files before installing.

07Platforms

linux · x86_64 linux · aarch64 macOS · x86_64 macOS · aarch64

08Labels

#issue-lifecycle #sdlc