create-agentic-pdlc 2.3.0 → 3.0.0

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

@@ -1,128 +0,0 @@
-name: AI QA Agent
-on:
-  pull_request:
-    types: [opened, synchronize, reopened]
-
-permissions:
-  pull-requests: write
-  contents: read
-  issues: read
-  models: read
-
-jobs:
-  qa:
-    name: AC Coverage Verification (GitHub Models)
-    runs-on: ubuntu-latest
-    env:
-      PROJECT_TOKEN: ${{ secrets.PROJECT_TOKEN }}
-      PROJECT_ID: "PVT_kwHODpFFL84BXg7h"
-      STATUS_FIELD_ID: "PVTSSF_lAHODpFFL84BXg7hzhStRHI"
-      STATUS_CODE_REVIEW_PR: "86ca9720"
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Verify AC Coverage via GitHub Models
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          set -e
-
-          PR_NUMBER="${{ github.event.pull_request.number }}"
-          BASE="${{ github.event.pull_request.base.sha }}"
-          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 64000)
-
-          # Extract linked issues from PR body
-          PR_BODY=$(gh pr view "$PR_NUMBER" --json body --jq '.body // ""')
-          ISSUE_NUMS=$(echo "$PR_BODY" | grep -oiE '(Closes?|Fixes?|Resolves?)\s+#([0-9]+)' | grep -oE '[0-9]+' || true)
-
-          # Build acceptance criteria context
-          AC_CONTEXT=""
-          if [ -n "$ISSUE_NUMS" ]; then
-            for NUM in $ISSUE_NUMS; do
-              ISSUE_BODY=$(gh issue view "$NUM" --json body --jq '.body // ""' 2>/dev/null || echo "")
-              AC_CONTEXT="${AC_CONTEXT}\\n\\n--- Issue #${NUM} ---\\n${ISSUE_BODY}"
-            done
-          fi
-
-          if [ -z "$AC_CONTEXT" ]; then
-            AC_CONTEXT="No linked issue found. Evaluate if the PR description is self-contained."
-          fi
-
-          # 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 -sf -X POST \
-            "https://models.github.ai/inference/chat/completions" \
-            -H "Authorization: Bearer ${GITHUB_TOKEN}" \
-            -H "Content-Type: application/json" \
-            -d "{\"model\":\"gpt-4o-mini\",\"messages\":[{\"role\":\"user\",\"content\":${PROMPT_JSON}}]}" \
-            --max-time 30 || echo "API_ERROR")
-
-          if [ "$RESPONSE" = "API_ERROR" ]; then
-            GH_TOKEN="$PROJECT_TOKEN" gh api "repos/${GITHUB_REPOSITORY}/issues/${PR_NUMBER}/labels" --method POST -f 'labels[]=infra:qa-broken'
-            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,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_TOKEN="$PROJECT_TOKEN" gh api "repos/${GITHUB_REPOSITORY}/issues/${PR_NUMBER}/labels" --method POST -f 'labels[]=qa:approved'
-            gh pr comment "$PR_NUMBER" --body "🤖 **QA Agent:** AC coverage verified. ${EXPLANATION}"
-          elif echo "$VERDICT" | grep -q "^FAIL"; then
-            GH_TOKEN="$PROJECT_TOKEN" gh api "repos/${GITHUB_REPOSITORY}/issues/${PR_NUMBER}/labels" --method POST -f 'labels[]=qa:needs-work'
-            gh pr comment "$PR_NUMBER" --body "🤖 **QA Agent:** AC coverage insufficient. ${EXPLANATION}"
-          else
-            GH_TOKEN="$PROJECT_TOKEN" gh api "repos/${GITHUB_REPOSITORY}/issues/${PR_NUMBER}/labels" --method POST -f 'labels[]=infra:qa-broken'
-            gh pr comment "$PR_NUMBER" --body "🤖 **QA Agent:** Could not parse GitHub Models response. Manual review required."
-          fi
-
-      - name: Move board card to Code Review on qa:approved
-        if: ${{ env.PROJECT_TOKEN != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
-        uses: actions/github-script@v7
-        with:
-          github-token: ${{ env.PROJECT_TOKEN }}
-          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 });
-            if (!pr.labels.some(l => l.name === 'qa:approved')) {
-              console.log('qa:approved not on PR — skipping board move');
-              return;
-            }
-
-            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)`);
-            }

package/templates/AGENTS.md

@@ -1,115 +0,0 @@
-# {{PROJECT_NAME}} — AI Agent Instructions
-
-This template is the contract between the project and any external AI agent 
-(Claude Code, Cursor, Copilot, Jules, Codex, Sweep, etc.). Read this before committing any change.
-
-## Project Overview
-
-{{PROJECT_DESCRIPTION}}
-
-**Structure:**
-{{PROJECT_STRUCTURE}}
-
-## Before Any Change
-
-```bash
-git fetch origin && git checkout main && git pull
-```
-
-Always start from the current `main` HEAD. Never work over stale snapshots.
-
-## Invariants / Non-negotiable business rules
-
-{{INVARIANTS}}
-<!-- Examples:
-1. **Human-in-the-Loop** — No external side-effect actions without explicit human approval.
-2. **Immutable Audit-Log** — It's strictly forbidden to UPDATE/DELETE on audit_log; INSERT only.
-3. **Credential Isolation** — Decryption occurs only in a specific service.
--->
-
-## Mandatory Workflow
-
-0. **Identity**: Always prefix your GitHub comments with `🤖 **Agent:** ` to distinguish yourself.
-1. **Initial State**: When beginning work on a new issue, your very first action must be to apply the `stage:brainstorming` label using the GitHub CLI (`gh issue edit <N> --add-label "stage:brainstorming"`).
-2. Read the issue entirely — understand its type (US/BUG/TASK/SPIKE) and the Acceptance Criteria.
-3. Read `docs/pdlc.md` — understand the PDLC and the Definition of Done in this project.
-4. Read all files mentioned in the issue's technical context.
-5. Implement the **minimum viable change** that satisfies the ACs — do not refactor beyond scope.
-6. Run tests: `{{TEST_COMMAND}}`
-7. Run typecheck (if applicable): `{{TYPECHECK_COMMAND}}`
-8. Create a Pull Request with `Closes #N` in the body — automation moves the board.
-
-### Spec format (Upstream Agents)
-
-When detailing a solution in an issue body, you must **always** include both the user story and the acceptance criteria. Never append only the ACs to an existing text; rewrite the full issue body in this standard format:
-
-```
-**As** [user],
-**I want** [action],
-**so that** [benefit].
-
----
-
-## Acceptance Criteria
-
-**AC1 — ...**
-- Given ...
-- When ...
-- Then ...
-
-**AC2 — ...**
-...
-
-## Files to modify
-- `path/to/file.ts` — what changes
-```
-
-## Stage Transition Rules (non-negotiable)
-
-MUST apply `stage:brainstorming` label immediately on starting work — before reading
-any code, before invoking any skill. Then read context and present problem summary
-+ 2–3 solution options in a single message.
-
-MUST NOT add `stage:detailing` label until the user has explicitly selected
-an approach in the current conversation turn. Work done in a prior
-planning session does NOT count as confirmation.
-
-MUST NOT add `spec:approved`, `stage:development`, or manually add
-`stage:approval` — these represent final human approval or the result of it.
-`stage:approval` is only set by system automation after you provide a complete
-spec for human review. Adding them manually triggers irreversible automation
-(Jules dispatch, board move).
-
-Each stage transition requires a fresh explicit signal from the user in the same
-session where the transition happens. These rules have no exceptions.
-
-## 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`.
-- Never open a PR without passing the tests.
-- Never implement beyond the immediate scope of the issue.
-- Never create future-proofing abstractions for hypothetical features.
-- The agent MUST NOT apply these labels under any circumstances (PM only):
-  - `spec:approved`: triggers Jules dispatch + board move to Development.
-  - `qa:approved`: triggers board move to Code Review.
-  - `qa:needs-work`: signals the PR requires changes and halts the flow.
-- Never add or remove stage:* labels manually, except for stage:brainstorming as the initial label when starting work. All other stage transitions are owned by GitHub Actions automation and the PM.
-{{EXTRA_DONT}}
-
-## Project Standards
-
-- **Tests:** `{{TEST_COMMAND}}`
-- **Lint/Types:** `{{LINT_COMMAND}}`
-- **Typecheck:** `{{TYPECHECK_COMMAND}}`
-- **Build:** `{{BUILD_COMMAND}}`
-{{EXTRA_PATTERNS}}