create-agentic-pdlc 2.1.5 → 2.2.0

package/templates/.github/workflows/project-automation.yml

@@ -6,7 +6,7 @@ on:
   pull_request_review:
     types: [submitted]
   issues:
-    types: [labeled]
+    types: [labeled, edited]
 
 env:
   PROJECT_ID: "{{PROJECT_ID}}"
@@ -87,6 +87,32 @@ jobs:
             await moveItem(node_id, targetStatusId);
             console.log(`Issue #${number} moved to ${stageName}`);
 
+  auto-move-to-approval:
+    name: Spec complete → stage:approval
+    if: >
+      github.event_name == 'issues' &&
+      github.event.action == 'edited' &&
+      contains(github.event.issue.labels.*.name, 'stage:detailing')
+    runs-on: ubuntu-latest
+    env:
+      PROJECT_PAT: ${{ secrets.PROJECT_PAT }}
+    steps:
+      - name: Check spec markers and swap labels
+        if: ${{ env.PROJECT_PAT != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ env.PROJECT_PAT }}
+          script: |
+            const body = context.payload.issue.body ?? '';
+            if (!body.includes('## Acceptance Criteria') || !body.includes('## Files to modify')) return;
+
+            const { owner, repo } = context.repo;
+            const issue_number = context.payload.issue.number;
+
+            await github.rest.issues.addLabels({ owner, repo, issue_number, labels: ['stage:approval'] }).catch(() => {});
+            await github.rest.issues.removeLabel({ owner, repo, issue_number, name: 'stage:detailing' }).catch(() => {});
+            console.log(`Issue #${issue_number} auto-moved to stage:approval`);
+
   # OPTIONAL: Uncomment to enable architecture-violation → Idea
   # move-violation-to-board:
   #   name: architecture-violation → 💡 Idea
@@ -115,16 +141,15 @@ jobs:
   #             });
   #           console.log(`Issue #${number} moved to Idea`);
 
-  # PR Opened → Move linked issue to Code Review / PR
-  # 💡 VARIANT B (QA Agent): If using an AI QA agent, change `STATUS_CODE_REVIEW_PR` to `STATUS_TESTING` on line ~158
+  # PR Opened → Move linked issue to Testing (Variant B — QA Agent enabled)
   move-card-on-pr-open:
-    name: Open PR → Code Review / PR
+    name: Open PR → Testing
     if: github.event_name == 'pull_request' && (github.event.action == 'opened' || github.event.action == 'reopened')
     runs-on: ubuntu-latest
     env:
       PROJECT_PAT: ${{ secrets.PROJECT_PAT }}
     steps:
-      - name: Move linked issue to Code Review / PR
+      - name: Move linked issue to Testing
         if: ${{ env.PROJECT_PAT != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
         uses: actions/github-script@v7
         with:
@@ -153,7 +178,7 @@ jobs:
                   }
                 }`, {
                   p: process.env.PROJECT_ID, i: item.id, f: process.env.STATUS_FIELD_ID,
-                  v: { singleSelectOptionId: process.env.STATUS_CODE_REVIEW_PR }
+                  v: { singleSelectOptionId: process.env.STATUS_TESTING }
                 });
             };
 
@@ -161,15 +186,60 @@ jobs:
               for (const n of linkedIssues) {
                 const { data: issue } = await github.rest.issues.get({ owner, repo, issue_number: n });
                 await moveItem(issue.node_id);
-                console.log(`Issue #${n} → Code Review / PR`);
+                console.log(`Issue #${n} → Testing`);
               }
             } else {
               await moveItem(pr.node_id);
-              console.log(`PR #${prNumber} → Code Review / PR (no linked issue)`);
+              console.log(`PR #${prNumber} → Testing (no linked issue)`);
             }
 
             await github.rest.issues.addLabels({ owner, repo, issue_number: prNumber, labels: ['pr:in-review'] }).catch(() => {});
 
+  # QA Approved → Move linked issue to Code Review / PR
+  move-card-on-qa-pass:
+    name: qa:approved → Code Review / PR
+    if: github.event_name == 'pull_request' && github.event.action == 'labeled' && github.event.label.name == 'qa:approved'
+    runs-on: ubuntu-latest
+    env:
+      PROJECT_PAT: ${{ secrets.PROJECT_PAT }}
+    steps:
+      - name: Move linked issue to Code Review / PR
+        if: ${{ env.PROJECT_PAT != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ env.PROJECT_PAT }}
+          script: |
+            const prNumber = context.payload.pull_request.number;
+            const { owner, repo } = context.repo;
+            const { data: pr } = await github.rest.pulls.get({ owner, repo, pull_number: prNumber });
+            const body = pr.body ?? '';
+            const linkedIssues = [...body.matchAll(/(?:Closes?|Fixes?|Resolves?)\s+#(\d+)/gi)].map(m => parseInt(m[1]));
+            const moveItem = async (nodeId) => {
+              const { addProjectV2ItemById: { item } } = await github.graphql(`
+                mutation($p: ID!, $c: ID!) {
+                  addProjectV2ItemById(input: {projectId: $p, contentId: $c}) { item { id } }
+                }`, { p: process.env.PROJECT_ID, c: nodeId });
+              await github.graphql(`
+                mutation($p: ID!, $i: ID!, $f: ID!, $v: ProjectV2FieldValue!) {
+                  updateProjectV2ItemFieldValue(input: {projectId: $p, itemId: $i, fieldId: $f, value: $v}) {
+                    projectV2Item { id }
+                  }
+                }`, {
+                  p: process.env.PROJECT_ID, i: item.id, f: process.env.STATUS_FIELD_ID,
+                  v: { singleSelectOptionId: process.env.STATUS_CODE_REVIEW_PR }
+                });
+            };
+            if (linkedIssues.length > 0) {
+              for (const n of linkedIssues) {
+                const { data: issue } = await github.rest.issues.get({ owner, repo, issue_number: n });
+                await moveItem(issue.node_id);
+                console.log(`Issue #${n} → Code Review / PR`);
+              }
+            } else {
+              await moveItem(pr.node_id);
+              console.log(`PR #${prNumber} → Code Review / PR (no linked issue)`);
+            }
+
   # Review Approved → Add Label
   move-card-on-review-approved:
     name: Approved PR → Add Label
@@ -189,52 +259,6 @@ jobs:
             try { await github.rest.issues.removeLabel({ owner, repo, issue_number: prNumber, name: 'pr:in-review' }); } catch {}
             await github.rest.issues.addLabels({ owner, repo, issue_number: prNumber, labels: ['pr:approved'] }).catch(() => {});
 
-  # OPTIONAL: Uncomment for Variant B (QA Agent enabled)
-  # When qa:approved is added to a PR, move linked issue to Code Review / PR
-  # move-card-on-qa-pass:
-  #   name: qa:approved → Code Review / PR
-  #   if: github.event_name == 'pull_request' && github.event.action == 'labeled' && github.event.label.name == 'qa:approved'
-  #   runs-on: ubuntu-latest
-  #   env:
-  #     PROJECT_PAT: ${{ secrets.PROJECT_PAT }}
-  #   steps:
-  #     - name: Move linked issue to Code Review / PR
-  #       if: ${{ env.PROJECT_PAT != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
-  #       uses: actions/github-script@v7
-  #       with:
-  #         github-token: ${{ env.PROJECT_PAT }}
-  #         script: |
-  #           const prNumber = context.payload.pull_request.number;
-  #           const { owner, repo } = context.repo;
-  #           const { data: pr } = await github.rest.pulls.get({ owner, repo, pull_number: prNumber });
-  #           const body = pr.body ?? '';
-  #           const linkedIssues = [...body.matchAll(/(?:Closes?|Fixes?|Resolves?)\s+#(\d+)/gi)].map(m => parseInt(m[1]));
-  #           const moveItem = async (nodeId) => {
-  #             const { addProjectV2ItemById: { item } } = await github.graphql(`
-  #               mutation($p: ID!, $c: ID!) {
-  #                 addProjectV2ItemById(input: {projectId: $p, contentId: $c}) { item { id } }
-  #               }`, { p: process.env.PROJECT_ID, c: nodeId });
-  #             await github.graphql(`
-  #               mutation($p: ID!, $i: ID!, $f: ID!, $v: ProjectV2FieldValue!) {
-  #                 updateProjectV2ItemFieldValue(input: {projectId: $p, itemId: $i, fieldId: $f, value: $v}) {
-  #                   projectV2Item { id }
-  #                 }
-  #               }`, {
-  #                 p: process.env.PROJECT_ID, i: item.id, f: process.env.STATUS_FIELD_ID,
-  #                 v: { singleSelectOptionId: process.env.STATUS_CODE_REVIEW_PR }
-  #               });
-  #           };
-  #           if (linkedIssues.length > 0) {
-  #             for (const n of linkedIssues) {
-  #               const { data: issue } = await github.rest.issues.get({ owner, repo, issue_number: n });
-  #               await moveItem(issue.node_id);
-  #               console.log(`Issue #${n} → Code Review / PR`);
-  #             }
-  #           } else {
-  #             await moveItem(pr.node_id);
-  #             console.log(`PR #${prNumber} → Code Review / PR (no linked issue)`);
-  #           }
-
   # PR Merged → Production
   move-card-on-pr-merge:
     name: Merged PR → Production

package/templates/.github/workflows/qa-agent.yml

@@ -7,20 +7,20 @@ permissions:
   pull-requests: write
   contents: read
   issues: read
+  models: read
 
 jobs:
   qa:
-    name: AC Coverage Verification (Gemini)
+    name: AC Coverage Verification (GitHub Models)
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
-      - name: Verify AC Coverage via Gemini
+      - name: Verify AC Coverage via GitHub Models
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
         run: |
           set -e
 
@@ -29,7 +29,7 @@ jobs:
           HEAD="${{ github.event.pull_request.head.sha }}"
 
           # Get PR diff (truncated to 8000 chars to stay within context limits)
-          DIFF=$(git diff "$BASE" "$HEAD" | head -c 8000)
+          DIFF=$(git diff "$BASE" "$HEAD" | head -c 64000)
 
           # Extract linked issues from PR body
           PR_BODY=$(gh pr view "$PR_NUMBER" --json body --jq '.body // ""')
@@ -48,23 +48,24 @@ jobs:
             AC_CONTEXT="No linked issue found. Evaluate if the PR description is self-contained."
           fi
 
-          # Serialize prompt as JSON string and call Gemini API (30s timeout)
-          PROMPT_JSON=$(printf '%s' "You are a senior QA engineer. Review whether this PR diff satisfies the Acceptance Criteria below.\n\nACCEPTANCE CRITERIA:\n${AC_CONTEXT}\n\nPR DIFF:\n${DIFF}\n\nRespond with exactly one word: PASS or FAIL, then on the next line explain briefly why (max 3 sentences)." | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read()))')
+          # Serialize prompt as JSON string and call GitHub Models API (30s timeout)
+          PROMPT_JSON=$(printf '%s' "You are a senior QA engineer. Review whether this PR diff satisfies the Acceptance Criteria below.\n\nACCEPTANCE CRITERIA:\n${AC_CONTEXT}\n\nPR DIFF:\n${DIFF}\n\nFirst line of your response must be exactly one word: PASS or FAIL. Second line: brief explanation (max 3 sentences)." | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read()))')
 
-          RESPONSE=$(curl -s -X POST \
-            "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=${GEMINI_API_KEY}" \
+          RESPONSE=$(curl -sf -X POST \
+            "https://models.github.ai/inference/chat/completions" \
+            -H "Authorization: Bearer ${GITHUB_TOKEN}" \
             -H "Content-Type: application/json" \
-            -d "{\"contents\":[{\"parts\":[{\"text\":${PROMPT_JSON}}]}]}" \
+            -d "{\"model\":\"gpt-4o-mini\",\"messages\":[{\"role\":\"user\",\"content\":${PROMPT_JSON}}]}" \
             --max-time 30 || echo "API_ERROR")
 
           if [ "$RESPONSE" = "API_ERROR" ]; then
             gh pr edit "$PR_NUMBER" --add-label "infra:qa-broken"
-            gh pr comment "$PR_NUMBER" --body "🤖 **QA Agent:** Could not reach Gemini API. Manual review required."
+            gh pr comment "$PR_NUMBER" --body "🤖 **QA Agent:** Could not reach GitHub Models API. Manual review required."
             exit 0
           fi
 
-          VERDICT=$(echo "$RESPONSE" | python3 -c 'import json,sys; d=json.load(sys.stdin); t=d.get("candidates",[{}])[0].get("content",{}).get("parts",[{}])[0].get("text","").strip(); print(t.split("\n")[0].upper() if t else "API_ERROR")')
-          EXPLANATION=$(echo "$RESPONSE" | python3 -c 'import json,sys; d=json.load(sys.stdin); t=d.get("candidates",[{}])[0].get("content",{}).get("parts",[{}])[0].get("text","").strip(); lines=t.split("\n",1); print(lines[1].strip() if len(lines)>1 else "")')
+          VERDICT=$(echo "$RESPONSE" | python3 -c 'import json,sys,re; d=json.load(sys.stdin); t=d.get("choices",[{}])[0].get("message",{}).get("content","").strip(); first=t.split("\n")[0].upper() if t else ""; print("FAIL" if re.search(r"\bFAIL\b",first) else "PASS" if re.search(r"\bPASS\b",first) else "API_ERROR")')
+          EXPLANATION=$(echo "$RESPONSE" | python3 -c 'import json,sys; d=json.load(sys.stdin); t=d.get("choices",[{}])[0].get("message",{}).get("content","").strip(); lines=t.split("\n",1); print(lines[1].strip() if len(lines)>1 else "")')
 
           if echo "$VERDICT" | grep -q "^PASS"; then
             gh pr edit "$PR_NUMBER" --add-label "qa:approved"
@@ -74,5 +75,5 @@ jobs:
             gh pr comment "$PR_NUMBER" --body "🤖 **QA Agent:** AC coverage insufficient. ${EXPLANATION}"
           else
             gh pr edit "$PR_NUMBER" --add-label "infra:qa-broken"
-            gh pr comment "$PR_NUMBER" --body "🤖 **QA Agent:** Could not parse Gemini response. Manual review required."
+            gh pr comment "$PR_NUMBER" --body "🤖 **QA Agent:** Could not parse GitHub Models response. Manual review required."
           fi

package/templates/AGENTS.md

@@ -64,6 +64,16 @@ When detailing a solution in an issue body, you must **always** include both the
 - `path/to/file.ts` — what changes
 ```
 
+## Pipeline Updates
+
+To add or configure optional agents (Jules, QA Agent, Sentinel) at any time:
+
+```bash
+npx create-agentic-pdlc --update
+```
+
+Run this when the user says anything like "update the pipeline", "update the board", or "configure the agents". It detects what is already configured and interactively sets up what is missing — without touching this file or any user-owned config.
+
 ## What NOT to do
 
 - Never commit directly to `main`.

package/templates/docs/pdlc.md

@@ -4,7 +4,7 @@
 
 | Column | Meaning | Who moves the card |
 |---|---|---|
-| 💡 Idea | Backlog — every new issue lands here | Manual |
+| 💡 Idea — don't move manually to Exploration | Backlog — tell agent: "work on issue #XX" | Don't move manually |
 | 🔍 Exploration | Claude is analyzing code and context | Label `stage:exploration` |
 | 🧠 Brainstorming | Claude proposed approaches, awaiting PM gate | Label `stage:brainstorming` |
 | 📐 Detail Solution | Claude is writing the technical spec | Label `stage:detailing` |
@@ -80,6 +80,10 @@ REPO         = {{REPO_OWNER}}/{{REPO_NAME}}
 | `qa:approved` | PR | Green | QA Agent passed — AC coverage verified |
 | `qa:needs-work` | PR | Red | QA Agent failed — PR needs changes |
 | `infra:qa-broken` | PR | Orange | QA Agent error — manual review required |
+| `type:us` | Issue | Blue | New feature or behavioral change — full flow |
+| `type:task` | Issue | Yellow | Operational/non-functional change — skips brainstorming |
+| `type:bug` | Issue | Red | Something broken — skips brainstorming |
+| `type:spike` | Issue | Gray | Research/evaluation — never reaches Development |
 
 ## Approval Gates
 
@@ -93,10 +97,16 @@ This triggers the implementation agent via `agent-trigger.yml`.
 
 ## Shortcuts by Type
 
-- **BUG** — Skips Brainstorming; enters Detail Solution with diagnostics + fix.
-- **TASK** — Skips Brainstorming; enters Detail Solution with operational steps.
-- **SPIKE** — Never reaches Development; delivery is a concluding comment.
-- **US** — Full flow observing both gates.
+The `type:*` label is the authoritative signal — set automatically by the agent via type inference (see `adapters/claude-code/skill.md`). Title prefixes (`🔧 TASK:`, `👤 US:`) are hints for humans; the label drives the flow.
+
+| Label | Flow |
+|---|---|
+| `type:us` | Full flow — exploration → brainstorming → Gate 1 → detailing → approval |
+| `type:task` | Skips brainstorming — exploration → detailing → approval |
+| `type:bug` | Skips brainstorming — exploration → detailing → approval |
+| `type:spike` | Skips brainstorming — exploration → detailing → conclusion comment (never reaches Development) |
+
+If no `type:*` label present and agent confidence < 85%, defaults to `type:us` (safe fallback — never skips gates by omission).
 
 ## Definition of Done