@snappedly-tools/shipyard 0.10.0 → 0.11.0

package/README.md

@@ -86,10 +86,11 @@ npx shipyard uninstall
 
 Then:
 
-1. Write an issue with a clear goal and add the `shipyard` and
-   `ready-for-agent` labels.
-2. Run Shipyard to check for the issue, implement it in Docker,
-   review the work, and open a pull request.
+1. Write an issue with a clear goal. If it is already triaged and approved for
+   agent implementation, add `ready-for-agent`. Add `shipyard` last to activate
+   the issue.
+2. Run Shipyard. It triages issues without `ready-for-agent`, verifies ready
+   issues, implements them in Docker, reviews the work, and opens a pull request.
 3. Inspect the pull request and merge it when you are happy with the result.
 
 ## Choose a workflow

package/dist/main.js

@@ -2400,7 +2400,7 @@ var runnerCommand = Command.make(
     purgeRunnerCommand
   ])
 );
-var VERSION = "0.10.0" ;
+var VERSION = "0.11.0" ;
 var SHIPYARD_PACKAGE_NAME = "@snappedly-tools/shipyard";
 var isMissingPath = (error) => error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT";
 var lstatIfPresent = async (path) => {

package/dist/templates/parallel-planner/main.mts

@@ -115,12 +115,14 @@ type Ticket = {
   body: string;
   state: string;
   blockedBy: Array<{ id: string; title: string; state: string }>;
+  triageReady: boolean;
 };
 type Scope = {
   id: string;
   title: string;
   branch: string;
   kind: "standalone" | "spec";
+  triageReady?: boolean;
   body?: string;
   tickets?: Ticket[];
   completedTicketIds?: string[];
@@ -172,13 +174,14 @@ const runWorker = async (scope: Scope, ticket: Ticket) => {
     copyToWorktree: [".shipyard/setup.sh"],
   });
   try {
-    await sandbox.run({
-      name: `triage #${ticket.id}`,
-      maxIterations: 1,
-      agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
-      promptFile: "./.shipyard/triage-prompt.md",
-      promptArgs: { TASK_ID: ticket.id, BASE_BRANCH: targetBranch },
-    });
+    if (!ticket.triageReady)
+      await sandbox.run({
+        name: `triage #${ticket.id}`,
+        maxIterations: 1,
+        agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+        promptFile: "./.shipyard/triage-prompt.md",
+        promptArgs: { TASK_ID: ticket.id, BASE_BRANCH: targetBranch },
+      });
     verifyTriage(ticket.id);
     const implementation = await sandbox.run({
       name: "implementer",
@@ -444,13 +447,14 @@ for (let iteration = 0; iteration < 10; iteration++) {
         let handoffEvidence: string;
         try {
           if (scope.kind === "standalone") {
-            await integration.run({
-              name: `triage #${id}`,
-              maxIterations: 1,
-              agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
-              promptFile: "./.shipyard/triage-prompt.md",
-              promptArgs: { TASK_ID: id, BASE_BRANCH: targetBranch },
-            });
+            if (!scope.triageReady)
+              await integration.run({
+                name: `triage #${id}`,
+                maxIterations: 1,
+                agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+                promptFile: "./.shipyard/triage-prompt.md",
+                promptArgs: { TASK_ID: id, BASE_BRANCH: targetBranch },
+              });
             verifyTriage(id);
             const standalone = await integration.run({
               name: "implementer",

package/dist/templates/parallel-planner/select-issues.mjs

@@ -124,6 +124,17 @@ const dependencies = (id) => {
 };
 const planningSpec = (body) =>
   /work item type:\*?\*?\s*planning spec/i.test(body ?? "");
+const triageStates = [
+  "needs-triage",
+  "needs-info",
+  "ready-for-agent",
+  "ready-for-human",
+  "wontfix",
+];
+const triageReady = (labels) =>
+  triageStates
+    .filter((state) => labels.some((label) => label.name === state))
+    .join() === "ready-for-agent";
 const textParent = (body, issueId) => {
   const match = /^##?\s*Parent\b[^\n]*\n/im.exec(body ?? "");
   if (!match) return undefined;
@@ -476,9 +487,10 @@ for (const candidate of activated) {
         ),
     );
     selectedTicketIds = new Set(selectableTickets.map((ticket) => ticket.id));
-    const tickets = selectableTickets.map(({ labels: _labels, ...ticket }) => ({
+    const tickets = selectableTickets.map(({ labels, ...ticket }) => ({
       ...ticket,
       blockedBy: dependencies(ticket.id),
+      triageReady: triageReady(labels),
     }));
     const completedTicketIds = linkedTickets
       .filter((ticket) =>
@@ -756,7 +768,13 @@ for (const candidate of activated) {
             completedTicketIds,
             outstandingTicketIds,
           }
-        : { id, title: candidate.title, branch, kind: "standalone" },
+        : {
+            id,
+            title: candidate.title,
+            branch,
+            kind: "standalone",
+            triageReady: triageReady(candidate.labels ?? []),
+          },
     );
   } catch (error) {
     if (!(error instanceof SelectionError)) throw error;

package/dist/templates/parallel-planner/triage-prompt.md

@@ -2,6 +2,6 @@ Triage GitHub issue #{{TASK_ID}} before Shipyard implementation.
 
 Follow `/triage` and the repository's triage label mapping. Read the full issue and comments. Verify the reported behavior against `origin/{{BASE_BRANCH}}`, the integration baseline. The checked-out task branch may contain unfinished changes from an earlier attempt. Do not close the issue as already complete based on the task branch or comments about that candidate.
 
-Apply the appropriate category and state label and post the brief or triage notes required by the skill. The maintainer has authorized Shipyard to apply an evidence-based recommendation during this unattended intake. If a decision requires maintainer judgment, use `needs-triage` and record the question. Do not implement the issue or start a PR in this phase.
+Apply the appropriate category and state label and post the brief or triage notes required by the skill. The maintainer has authorized Shipyard to apply an evidence-based recommendation during this unattended intake. Derive acceptance criteria from the stated outcome. For example, equal spacing between named header items is a testable visual goal without a pixel target. Choose a representative supported viewport if none is specified. An inaccessible attachment does not require `needs-info` when the text establishes the current and desired behavior; record the verification limit in the brief. Do not treat equal CSS gap values alone as proof that the rendered gaps are equal. Apply `needs-info` and ask one concrete question only when missing details change the intended result or prevent meaningful verification. Use `needs-triage` only when the available facts leave a product or policy decision for the maintainer, not for routine layout or implementation choices. Preserve the `shipyard` or `shipyard:pending` label. Do not implement the issue or start a PR in this phase.
 
-Report the applied state and evidence. Shipyard will independently re-read GitHub labels and implement only an open issue carrying both `shipyard` and the sole triage state `ready-for-agent`.
+Report the applied state and evidence. Shipyard will independently re-read GitHub labels and implement only an open issue carrying `shipyard` or `shipyard:pending` and the sole triage state `ready-for-agent`.

package/dist/templates/parallel-planner/verify-triage.sh

@@ -11,9 +11,18 @@ gh issue view "$issue" --repo "$repo" --json state,labels |
     const issue = JSON.parse(require("node:fs").readFileSync(0, "utf8"));
     const labels = new Set(issue.labels.map((label) => label.name));
     const states = ["needs-triage", "needs-info", "ready-for-agent", "ready-for-human", "wontfix"];
-    if (issue.state !== "OPEN" || !labels.has("shipyard") ||
-        states.filter((state) => labels.has(state)).join() !== "ready-for-agent") {
-      console.error("Issue cannot be implemented: requires an open issue with shipyard and only ready-for-agent as its triage state");
+    if (issue.state !== "OPEN" ||
+        !(labels.has("shipyard") || labels.has("shipyard:pending"))) {
+      console.error("Issue cannot be implemented: requires an open issue with shipyard or shipyard:pending");
+      process.exit(1);
+    }
+    const triageStates = states.filter((state) => labels.has(state));
+    if (triageStates.join() === "needs-info") {
+      console.error("Issue needs information from the reporter before implementation");
+      process.exit(1);
+    }
+    if (triageStates.join() !== "ready-for-agent") {
+      console.error(`Issue cannot be implemented: triage state is ${triageStates.join() || "missing"}; requires only ready-for-agent`);
       process.exit(1);
     }
   '

package/dist/templates/parallel-planner-with-review/main.mts

@@ -115,12 +115,14 @@ type Ticket = {
   body: string;
   state: string;
   blockedBy: Array<{ id: string; title: string; state: string }>;
+  triageReady: boolean;
 };
 type Scope = {
   id: string;
   title: string;
   branch: string;
   kind: "standalone" | "spec";
+  triageReady?: boolean;
   body?: string;
   tickets?: Ticket[];
   completedTicketIds?: string[];
@@ -182,13 +184,14 @@ const runWorker = async (scope: Scope, ticket: Ticket) => {
     copyToWorktree: [".shipyard/setup.sh"],
   });
   try {
-    await sandbox.run({
-      name: `triage #${ticket.id}`,
-      maxIterations: 1,
-      agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
-      promptFile: "./.shipyard/triage-prompt.md",
-      promptArgs: { TASK_ID: ticket.id, BASE_BRANCH: targetBranch },
-    });
+    if (!ticket.triageReady)
+      await sandbox.run({
+        name: `triage #${ticket.id}`,
+        maxIterations: 1,
+        agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+        promptFile: "./.shipyard/triage-prompt.md",
+        promptArgs: { TASK_ID: ticket.id, BASE_BRANCH: targetBranch },
+      });
     verifyTriage(ticket.id);
     const implementation = await sandbox.run({
       name: "implementer",
@@ -467,13 +470,14 @@ for (let iteration = 0; iteration < 10; iteration++) {
         let handoffEvidence: string;
         try {
           if (scope.kind === "standalone") {
-            await integration.run({
-              name: `triage #${id}`,
-              maxIterations: 1,
-              agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
-              promptFile: "./.shipyard/triage-prompt.md",
-              promptArgs: { TASK_ID: id, BASE_BRANCH: targetBranch },
-            });
+            if (!scope.triageReady)
+              await integration.run({
+                name: `triage #${id}`,
+                maxIterations: 1,
+                agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+                promptFile: "./.shipyard/triage-prompt.md",
+                promptArgs: { TASK_ID: id, BASE_BRANCH: targetBranch },
+              });
             verifyTriage(id);
             const standalone = await integration.run({
               name: "implementer",

package/dist/templates/parallel-planner-with-review/select-issues.mjs

@@ -124,6 +124,17 @@ const dependencies = (id) => {
 };
 const planningSpec = (body) =>
   /work item type:\*?\*?\s*planning spec/i.test(body ?? "");
+const triageStates = [
+  "needs-triage",
+  "needs-info",
+  "ready-for-agent",
+  "ready-for-human",
+  "wontfix",
+];
+const triageReady = (labels) =>
+  triageStates
+    .filter((state) => labels.some((label) => label.name === state))
+    .join() === "ready-for-agent";
 const textParent = (body, issueId) => {
   const match = /^##?\s*Parent\b[^\n]*\n/im.exec(body ?? "");
   if (!match) return undefined;
@@ -476,9 +487,10 @@ for (const candidate of activated) {
         ),
     );
     selectedTicketIds = new Set(selectableTickets.map((ticket) => ticket.id));
-    const tickets = selectableTickets.map(({ labels: _labels, ...ticket }) => ({
+    const tickets = selectableTickets.map(({ labels, ...ticket }) => ({
       ...ticket,
       blockedBy: dependencies(ticket.id),
+      triageReady: triageReady(labels),
     }));
     const completedTicketIds = linkedTickets
       .filter((ticket) =>
@@ -756,7 +768,13 @@ for (const candidate of activated) {
             completedTicketIds,
             outstandingTicketIds,
           }
-        : { id, title: candidate.title, branch, kind: "standalone" },
+        : {
+            id,
+            title: candidate.title,
+            branch,
+            kind: "standalone",
+            triageReady: triageReady(candidate.labels ?? []),
+          },
     );
   } catch (error) {
     if (!(error instanceof SelectionError)) throw error;

package/dist/templates/parallel-planner-with-review/triage-prompt.md

@@ -2,6 +2,6 @@ Triage GitHub issue #{{TASK_ID}} before Shipyard implementation.
 
 Follow `/triage` and the repository's triage label mapping. Read the full issue and comments. Verify the reported behavior against `origin/{{BASE_BRANCH}}`, the integration baseline. The checked-out task branch may contain unfinished changes from an earlier attempt. Do not close the issue as already complete based on the task branch or comments about that candidate.
 
-Apply the appropriate category and state label and post the brief or triage notes required by the skill. The maintainer has authorized Shipyard to apply an evidence-based recommendation during this unattended intake. If a decision requires maintainer judgment, use `needs-triage` and record the question. Do not implement the issue or start a PR in this phase.
+Apply the appropriate category and state label and post the brief or triage notes required by the skill. The maintainer has authorized Shipyard to apply an evidence-based recommendation during this unattended intake. Derive acceptance criteria from the stated outcome. For example, equal spacing between named header items is a testable visual goal without a pixel target. Choose a representative supported viewport if none is specified. An inaccessible attachment does not require `needs-info` when the text establishes the current and desired behavior; record the verification limit in the brief. Do not treat equal CSS gap values alone as proof that the rendered gaps are equal. Apply `needs-info` and ask one concrete question only when missing details change the intended result or prevent meaningful verification. Use `needs-triage` only when the available facts leave a product or policy decision for the maintainer, not for routine layout or implementation choices. Preserve the `shipyard` or `shipyard:pending` label. Do not implement the issue or start a PR in this phase.
 
-Report the applied state and evidence. Shipyard will independently re-read GitHub labels and implement only an open issue carrying both `shipyard` and the sole triage state `ready-for-agent`.
+Report the applied state and evidence. Shipyard will independently re-read GitHub labels and implement only an open issue carrying `shipyard` or `shipyard:pending` and the sole triage state `ready-for-agent`.

package/dist/templates/parallel-planner-with-review/verify-triage.sh

@@ -11,9 +11,18 @@ gh issue view "$issue" --repo "$repo" --json state,labels |
     const issue = JSON.parse(require("node:fs").readFileSync(0, "utf8"));
     const labels = new Set(issue.labels.map((label) => label.name));
     const states = ["needs-triage", "needs-info", "ready-for-agent", "ready-for-human", "wontfix"];
-    if (issue.state !== "OPEN" || !labels.has("shipyard") ||
-        states.filter((state) => labels.has(state)).join() !== "ready-for-agent") {
-      console.error("Issue cannot be implemented: requires an open issue with shipyard and only ready-for-agent as its triage state");
+    if (issue.state !== "OPEN" ||
+        !(labels.has("shipyard") || labels.has("shipyard:pending"))) {
+      console.error("Issue cannot be implemented: requires an open issue with shipyard or shipyard:pending");
+      process.exit(1);
+    }
+    const triageStates = states.filter((state) => labels.has(state));
+    if (triageStates.join() === "needs-info") {
+      console.error("Issue needs information from the reporter before implementation");
+      process.exit(1);
+    }
+    if (triageStates.join() !== "ready-for-agent") {
+      console.error(`Issue cannot be implemented: triage state is ${triageStates.join() || "missing"}; requires only ready-for-agent`);
       process.exit(1);
     }
   '

package/dist/templates/sequential-reviewer/main.mts

@@ -139,6 +139,7 @@ for (let iteration = 0; iteration < MAX_ITERATIONS; iteration++) {
     title: string;
     branch: string;
     kind: "standalone" | "spec";
+    triageReady?: boolean;
     body?: string;
     tickets?: Array<{
       id: string;
@@ -146,6 +147,7 @@ for (let iteration = 0; iteration < MAX_ITERATIONS; iteration++) {
       body: string;
       state: string;
       blockedBy: Array<{ id: string; title: string; state: string }>;
+      triageReady: boolean;
     }>;
     completedTicketIds?: string[];
     outstandingTicketIds?: string[];
@@ -193,13 +195,19 @@ for (let iteration = 0; iteration < MAX_ITERATIONS; iteration++) {
       for (const ticketId of issue.kind === "spec"
         ? (issue.tickets ?? []).map((ticket) => ticket.id)
         : [issue.id]) {
-        await sandbox.run({
-          name: `triage #${ticketId}`,
-          agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
-          maxIterations: 1,
-          promptFile: "./.shipyard/triage-prompt.md",
-          promptArgs: { TASK_ID: ticketId, BASE_BRANCH: targetBranch },
-        });
+        const ready =
+          issue.kind === "spec"
+            ? issue.tickets?.find((ticket) => ticket.id === ticketId)
+                ?.triageReady
+            : issue.triageReady;
+        if (!ready)
+          await sandbox.run({
+            name: `triage #${ticketId}`,
+            agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+            maxIterations: 1,
+            promptFile: "./.shipyard/triage-prompt.md",
+            promptArgs: { TASK_ID: ticketId, BASE_BRANCH: targetBranch },
+          });
         verifyTriage(ticketId);
       }
       const implement = await sandbox.run({

package/dist/templates/sequential-reviewer/select-issues.mjs

@@ -124,6 +124,17 @@ const dependencies = (id) => {
 };
 const planningSpec = (body) =>
   /work item type:\*?\*?\s*planning spec/i.test(body ?? "");
+const triageStates = [
+  "needs-triage",
+  "needs-info",
+  "ready-for-agent",
+  "ready-for-human",
+  "wontfix",
+];
+const triageReady = (labels) =>
+  triageStates
+    .filter((state) => labels.some((label) => label.name === state))
+    .join() === "ready-for-agent";
 const textParent = (body, issueId) => {
   const match = /^##?\s*Parent\b[^\n]*\n/im.exec(body ?? "");
   if (!match) return undefined;
@@ -476,9 +487,10 @@ for (const candidate of activated) {
         ),
     );
     selectedTicketIds = new Set(selectableTickets.map((ticket) => ticket.id));
-    const tickets = selectableTickets.map(({ labels: _labels, ...ticket }) => ({
+    const tickets = selectableTickets.map(({ labels, ...ticket }) => ({
       ...ticket,
       blockedBy: dependencies(ticket.id),
+      triageReady: triageReady(labels),
     }));
     const completedTicketIds = linkedTickets
       .filter((ticket) =>
@@ -756,7 +768,13 @@ for (const candidate of activated) {
             completedTicketIds,
             outstandingTicketIds,
           }
-        : { id, title: candidate.title, branch, kind: "standalone" },
+        : {
+            id,
+            title: candidate.title,
+            branch,
+            kind: "standalone",
+            triageReady: triageReady(candidate.labels ?? []),
+          },
     );
   } catch (error) {
     if (!(error instanceof SelectionError)) throw error;

package/dist/templates/sequential-reviewer/triage-prompt.md

@@ -2,6 +2,6 @@ Triage GitHub issue #{{TASK_ID}} before Shipyard implementation.
 
 Follow `/triage` and the repository's triage label mapping. Read the full issue and comments. Verify the reported behavior against `origin/{{BASE_BRANCH}}`, the integration baseline. The checked-out task branch may contain unfinished changes from an earlier attempt. Do not close the issue as already complete based on the task branch or comments about that candidate.
 
-Apply the appropriate category and state label and post the brief or triage notes required by the skill. The maintainer has authorized Shipyard to apply an evidence-based recommendation during this unattended intake. If a decision requires maintainer judgment, use `needs-triage` and record the question. Do not implement the issue or start a PR in this phase.
+Apply the appropriate category and state label and post the brief or triage notes required by the skill. The maintainer has authorized Shipyard to apply an evidence-based recommendation during this unattended intake. Derive acceptance criteria from the stated outcome. For example, equal spacing between named header items is a testable visual goal without a pixel target. Choose a representative supported viewport if none is specified. An inaccessible attachment does not require `needs-info` when the text establishes the current and desired behavior; record the verification limit in the brief. Do not treat equal CSS gap values alone as proof that the rendered gaps are equal. Apply `needs-info` and ask one concrete question only when missing details change the intended result or prevent meaningful verification. Use `needs-triage` only when the available facts leave a product or policy decision for the maintainer, not for routine layout or implementation choices. Preserve the `shipyard` or `shipyard:pending` label. Do not implement the issue or start a PR in this phase.
 
-Report the applied state and evidence. Shipyard will independently re-read GitHub labels and implement only an open issue carrying both `shipyard` and the sole triage state `ready-for-agent`.
+Report the applied state and evidence. Shipyard will independently re-read GitHub labels and implement only an open issue carrying `shipyard` or `shipyard:pending` and the sole triage state `ready-for-agent`.

package/dist/templates/sequential-reviewer/verify-triage.sh

@@ -11,9 +11,18 @@ gh issue view "$issue" --repo "$repo" --json state,labels |
     const issue = JSON.parse(require("node:fs").readFileSync(0, "utf8"));
     const labels = new Set(issue.labels.map((label) => label.name));
     const states = ["needs-triage", "needs-info", "ready-for-agent", "ready-for-human", "wontfix"];
-    if (issue.state !== "OPEN" || !labels.has("shipyard") ||
-        states.filter((state) => labels.has(state)).join() !== "ready-for-agent") {
-      console.error("Issue cannot be implemented: requires an open issue with shipyard and only ready-for-agent as its triage state");
+    if (issue.state !== "OPEN" ||
+        !(labels.has("shipyard") || labels.has("shipyard:pending"))) {
+      console.error("Issue cannot be implemented: requires an open issue with shipyard or shipyard:pending");
+      process.exit(1);
+    }
+    const triageStates = states.filter((state) => labels.has(state));
+    if (triageStates.join() === "needs-info") {
+      console.error("Issue needs information from the reporter before implementation");
+      process.exit(1);
+    }
+    if (triageStates.join() !== "ready-for-agent") {
+      console.error(`Issue cannot be implemented: triage state is ${triageStates.join() || "missing"}; requires only ready-for-agent`);
       process.exit(1);
     }
   '

package/dist/templates/shared/select-issues.mjs

@@ -124,6 +124,17 @@ const dependencies = (id) => {
 };
 const planningSpec = (body) =>
   /work item type:\*?\*?\s*planning spec/i.test(body ?? "");
+const triageStates = [
+  "needs-triage",
+  "needs-info",
+  "ready-for-agent",
+  "ready-for-human",
+  "wontfix",
+];
+const triageReady = (labels) =>
+  triageStates
+    .filter((state) => labels.some((label) => label.name === state))
+    .join() === "ready-for-agent";
 const textParent = (body, issueId) => {
   const match = /^##?\s*Parent\b[^\n]*\n/im.exec(body ?? "");
   if (!match) return undefined;
@@ -476,9 +487,10 @@ for (const candidate of activated) {
         ),
     );
     selectedTicketIds = new Set(selectableTickets.map((ticket) => ticket.id));
-    const tickets = selectableTickets.map(({ labels: _labels, ...ticket }) => ({
+    const tickets = selectableTickets.map(({ labels, ...ticket }) => ({
       ...ticket,
       blockedBy: dependencies(ticket.id),
+      triageReady: triageReady(labels),
     }));
     const completedTicketIds = linkedTickets
       .filter((ticket) =>
@@ -756,7 +768,13 @@ for (const candidate of activated) {
             completedTicketIds,
             outstandingTicketIds,
           }
-        : { id, title: candidate.title, branch, kind: "standalone" },
+        : {
+            id,
+            title: candidate.title,
+            branch,
+            kind: "standalone",
+            triageReady: triageReady(candidate.labels ?? []),
+          },
     );
   } catch (error) {
     if (!(error instanceof SelectionError)) throw error;

package/dist/templates/shared/triage-prompt.md

@@ -2,6 +2,6 @@ Triage GitHub issue #{{TASK_ID}} before Shipyard implementation.
 
 Follow `/triage` and the repository's triage label mapping. Read the full issue and comments. Verify the reported behavior against `origin/{{BASE_BRANCH}}`, the integration baseline. The checked-out task branch may contain unfinished changes from an earlier attempt. Do not close the issue as already complete based on the task branch or comments about that candidate.
 
-Apply the appropriate category and state label and post the brief or triage notes required by the skill. The maintainer has authorized Shipyard to apply an evidence-based recommendation during this unattended intake. If a decision requires maintainer judgment, use `needs-triage` and record the question. Do not implement the issue or start a PR in this phase.
+Apply the appropriate category and state label and post the brief or triage notes required by the skill. The maintainer has authorized Shipyard to apply an evidence-based recommendation during this unattended intake. Derive acceptance criteria from the stated outcome. For example, equal spacing between named header items is a testable visual goal without a pixel target. Choose a representative supported viewport if none is specified. An inaccessible attachment does not require `needs-info` when the text establishes the current and desired behavior; record the verification limit in the brief. Do not treat equal CSS gap values alone as proof that the rendered gaps are equal. Apply `needs-info` and ask one concrete question only when missing details change the intended result or prevent meaningful verification. Use `needs-triage` only when the available facts leave a product or policy decision for the maintainer, not for routine layout or implementation choices. Preserve the `shipyard` or `shipyard:pending` label. Do not implement the issue or start a PR in this phase.
 
-Report the applied state and evidence. Shipyard will independently re-read GitHub labels and implement only an open issue carrying both `shipyard` and the sole triage state `ready-for-agent`.
+Report the applied state and evidence. Shipyard will independently re-read GitHub labels and implement only an open issue carrying `shipyard` or `shipyard:pending` and the sole triage state `ready-for-agent`.

package/dist/templates/shared/verify-triage.sh

@@ -11,9 +11,18 @@ gh issue view "$issue" --repo "$repo" --json state,labels |
     const issue = JSON.parse(require("node:fs").readFileSync(0, "utf8"));
     const labels = new Set(issue.labels.map((label) => label.name));
     const states = ["needs-triage", "needs-info", "ready-for-agent", "ready-for-human", "wontfix"];
-    if (issue.state !== "OPEN" || !labels.has("shipyard") ||
-        states.filter((state) => labels.has(state)).join() !== "ready-for-agent") {
-      console.error("Issue cannot be implemented: requires an open issue with shipyard and only ready-for-agent as its triage state");
+    if (issue.state !== "OPEN" ||
+        !(labels.has("shipyard") || labels.has("shipyard:pending"))) {
+      console.error("Issue cannot be implemented: requires an open issue with shipyard or shipyard:pending");
+      process.exit(1);
+    }
+    const triageStates = states.filter((state) => labels.has(state));
+    if (triageStates.join() === "needs-info") {
+      console.error("Issue needs information from the reporter before implementation");
+      process.exit(1);
+    }
+    if (triageStates.join() !== "ready-for-agent") {
+      console.error(`Issue cannot be implemented: triage state is ${triageStates.join() || "missing"}; requires only ready-for-agent`);
       process.exit(1);
     }
   '

package/dist/templates/simple-loop/main.mts

@@ -136,6 +136,7 @@ for (let iteration = 0; iteration < 3; iteration++) {
     title: string;
     branch: string;
     kind: "standalone" | "spec";
+    triageReady?: boolean;
     body?: string;
     tickets?: Array<{
       id: string;
@@ -143,6 +144,7 @@ for (let iteration = 0; iteration < 3; iteration++) {
       body: string;
       state: string;
       blockedBy: Array<{ id: string; title: string; state: string }>;
+      triageReady: boolean;
     }>;
     completedTicketIds?: string[];
     outstandingTicketIds?: string[];
@@ -190,13 +192,19 @@ for (let iteration = 0; iteration < 3; iteration++) {
       for (const ticketId of issue.kind === "spec"
         ? (issue.tickets ?? []).map((ticket) => ticket.id)
         : [issue.id]) {
-        await sandbox.run({
-          name: `triage #${ticketId}`,
-          agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
-          maxIterations: 1,
-          promptFile: "./.shipyard/triage-prompt.md",
-          promptArgs: { TASK_ID: ticketId, BASE_BRANCH: targetBranch },
-        });
+        const ready =
+          issue.kind === "spec"
+            ? issue.tickets?.find((ticket) => ticket.id === ticketId)
+                ?.triageReady
+            : issue.triageReady;
+        if (!ready)
+          await sandbox.run({
+            name: `triage #${ticketId}`,
+            agent: roleAgent("routine", shipyard.CODEX_MODELS.routine),
+            maxIterations: 1,
+            promptFile: "./.shipyard/triage-prompt.md",
+            promptArgs: { TASK_ID: ticketId, BASE_BRANCH: targetBranch },
+          });
         verifyTriage(ticketId);
       }
       const result = await sandbox.run({

package/dist/templates/simple-loop/select-issues.mjs

@@ -124,6 +124,17 @@ const dependencies = (id) => {
 };
 const planningSpec = (body) =>
   /work item type:\*?\*?\s*planning spec/i.test(body ?? "");
+const triageStates = [
+  "needs-triage",
+  "needs-info",
+  "ready-for-agent",
+  "ready-for-human",
+  "wontfix",
+];
+const triageReady = (labels) =>
+  triageStates
+    .filter((state) => labels.some((label) => label.name === state))
+    .join() === "ready-for-agent";
 const textParent = (body, issueId) => {
   const match = /^##?\s*Parent\b[^\n]*\n/im.exec(body ?? "");
   if (!match) return undefined;
@@ -476,9 +487,10 @@ for (const candidate of activated) {
         ),
     );
     selectedTicketIds = new Set(selectableTickets.map((ticket) => ticket.id));
-    const tickets = selectableTickets.map(({ labels: _labels, ...ticket }) => ({
+    const tickets = selectableTickets.map(({ labels, ...ticket }) => ({
       ...ticket,
       blockedBy: dependencies(ticket.id),
+      triageReady: triageReady(labels),
     }));
     const completedTicketIds = linkedTickets
       .filter((ticket) =>
@@ -756,7 +768,13 @@ for (const candidate of activated) {
             completedTicketIds,
             outstandingTicketIds,
           }
-        : { id, title: candidate.title, branch, kind: "standalone" },
+        : {
+            id,
+            title: candidate.title,
+            branch,
+            kind: "standalone",
+            triageReady: triageReady(candidate.labels ?? []),
+          },
     );
   } catch (error) {
     if (!(error instanceof SelectionError)) throw error;

package/dist/templates/simple-loop/triage-prompt.md

@@ -2,6 +2,6 @@ Triage GitHub issue #{{TASK_ID}} before Shipyard implementation.
 
 Follow `/triage` and the repository's triage label mapping. Read the full issue and comments. Verify the reported behavior against `origin/{{BASE_BRANCH}}`, the integration baseline. The checked-out task branch may contain unfinished changes from an earlier attempt. Do not close the issue as already complete based on the task branch or comments about that candidate.
 
-Apply the appropriate category and state label and post the brief or triage notes required by the skill. The maintainer has authorized Shipyard to apply an evidence-based recommendation during this unattended intake. If a decision requires maintainer judgment, use `needs-triage` and record the question. Do not implement the issue or start a PR in this phase.
+Apply the appropriate category and state label and post the brief or triage notes required by the skill. The maintainer has authorized Shipyard to apply an evidence-based recommendation during this unattended intake. Derive acceptance criteria from the stated outcome. For example, equal spacing between named header items is a testable visual goal without a pixel target. Choose a representative supported viewport if none is specified. An inaccessible attachment does not require `needs-info` when the text establishes the current and desired behavior; record the verification limit in the brief. Do not treat equal CSS gap values alone as proof that the rendered gaps are equal. Apply `needs-info` and ask one concrete question only when missing details change the intended result or prevent meaningful verification. Use `needs-triage` only when the available facts leave a product or policy decision for the maintainer, not for routine layout or implementation choices. Preserve the `shipyard` or `shipyard:pending` label. Do not implement the issue or start a PR in this phase.
 
-Report the applied state and evidence. Shipyard will independently re-read GitHub labels and implement only an open issue carrying both `shipyard` and the sole triage state `ready-for-agent`.
+Report the applied state and evidence. Shipyard will independently re-read GitHub labels and implement only an open issue carrying `shipyard` or `shipyard:pending` and the sole triage state `ready-for-agent`.

package/dist/templates/simple-loop/verify-triage.sh

@@ -11,9 +11,18 @@ gh issue view "$issue" --repo "$repo" --json state,labels |
     const issue = JSON.parse(require("node:fs").readFileSync(0, "utf8"));
     const labels = new Set(issue.labels.map((label) => label.name));
     const states = ["needs-triage", "needs-info", "ready-for-agent", "ready-for-human", "wontfix"];
-    if (issue.state !== "OPEN" || !labels.has("shipyard") ||
-        states.filter((state) => labels.has(state)).join() !== "ready-for-agent") {
-      console.error("Issue cannot be implemented: requires an open issue with shipyard and only ready-for-agent as its triage state");
+    if (issue.state !== "OPEN" ||
+        !(labels.has("shipyard") || labels.has("shipyard:pending"))) {
+      console.error("Issue cannot be implemented: requires an open issue with shipyard or shipyard:pending");
+      process.exit(1);
+    }
+    const triageStates = states.filter((state) => labels.has(state));
+    if (triageStates.join() === "needs-info") {
+      console.error("Issue needs information from the reporter before implementation");
+      process.exit(1);
+    }
+    if (triageStates.join() !== "ready-for-agent") {
+      console.error(`Issue cannot be implemented: triage state is ${triageStates.join() || "missing"}; requires only ready-for-agent`);
       process.exit(1);
     }
   '

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snappedly-tools/shipyard",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Run AI coding agents in isolated sandboxes",
   "type": "module",
   "main": "./dist/index.js",