create-agentic-pdlc 2.3.0 → 3.0.0

package/.agentic-pdlc/hooks/pdlc-stage-gate.sh

@@ -1,39 +1,66 @@
 #!/bin/bash
-# PDLC Stage Gate — blocks gh pr create without stage:approval on linked issue.
+# PDLC Stage Gate — blocks gh pr create and file edits without spec:approved on linked issue.
 # Bypass: branch prefix hotfix/ skips all checks.
 
 INPUT=$(cat)
 COMMAND=$(echo "$INPUT" | node -e "const d=JSON.parse(require('fs').readFileSync(0)); console.log(d.command || '')" 2>/dev/null || echo "")
+FILE_PATH=$(echo "$INPUT" | node -e "const d=JSON.parse(require('fs').readFileSync(0)); console.log(d.file_path || '')" 2>/dev/null || echo "")
 
-if ! echo "$COMMAND" | grep -q "gh pr create"; then
+IS_PR_CREATE=false
+IS_FILE_EDIT=false
+
+if echo "$COMMAND" | grep -q "gh pr create"; then
+  IS_PR_CREATE=true
+elif [ -n "$FILE_PATH" ]; then
+  IS_FILE_EDIT=true
+fi
+
+if [ "$IS_PR_CREATE" != "true" ] && [ "$IS_FILE_EDIT" != "true" ]; then
   exit 0
 fi
 
 BRANCH=$(git branch --show-current 2>/dev/null || echo "")
 
 if echo "$BRANCH" | grep -qE "^hotfix/"; then
-  echo "✅ PDLC: Hotfix branch — stage gate bypassed."
   exit 0
 fi
 
 ISSUE_NUM=$(echo "$BRANCH" | grep -oE '[0-9]+' | head -1)
 
 if [ -z "$ISSUE_NUM" ]; then
+  if [ "$IS_FILE_EDIT" = "true" ]; then
+    exit 0
+  fi
   echo "❌ PDLC Stage Gate: Cannot determine issue from branch '$BRANCH'."
   echo "   Use: feat/<issue-number>-<description> or hotfix/<issue-number>-<description>"
   exit 1
 fi
 
-LABELS=$(gh issue view "$ISSUE_NUM" --json labels --jq '[.labels[].name] | join(" ")' 2>/dev/null || echo "")
+LABELS=$(gh issue view "$ISSUE_NUM" --json labels --jq '[.labels[].name] | join(" ")' 2>/dev/null)
+if [ $? -ne 0 ] || [ -z "$LABELS" ]; then
+  echo "❌ PDLC Stage Gate: Could not fetch labels for issue #$ISSUE_NUM."
+  echo "   Missing condition: spec:approved"
+  echo "   Next step: verify gh auth and issue number, then have PM add spec:approved."
+  exit 1
+fi
 
-if echo "$LABELS" | grep -qw "stage:approval"; then
-  echo "✅ PDLC: Issue #$ISSUE_NUM approved — gate passed."
+if echo "$LABELS" | grep -qw "spec:approved"; then
   exit 0
 fi
 
 STAGE=$(echo "$LABELS" | tr ' ' '\n' | grep "^stage:" | head -1 || echo "none")
-echo "❌ PDLC Stage Gate: Issue #$ISSUE_NUM is not approved."
-echo "   Current stage: $STAGE"
-echo "   Required: stage:approval label on the issue."
-echo "   Emergency bypass: rename branch to hotfix/<issue-number>-<description>."
+
+if [ "$IS_PR_CREATE" = "true" ]; then
+  echo "❌ PDLC Stage Gate: PR creation blocked — issue #$ISSUE_NUM missing spec:approved."
+  echo "   Current stage: $STAGE"
+  echo "   Missing condition: spec:approved (set by PM after reviewing spec in issue body)"
+  echo "   Next step: complete spec → stage:approval → wait for PM to add spec:approved."
+  echo "   Emergency bypass: rename branch to hotfix/<issue-number>-<description>."
+else
+  echo "❌ PDLC Stage Gate: File edit blocked — issue #$ISSUE_NUM missing spec:approved."
+  echo "   Current stage: $STAGE"
+  echo "   Missing condition: spec:approved (set by PM after reviewing spec in issue body)"
+  echo "   Next step: complete spec → stage:approval → wait for PM to add spec:approved."
+  echo "   Emergency bypass: rename branch to hotfix/<issue-number>-<description>."
+fi
 exit 1

package/.agentic-pdlc/metrics/raw/2026-W22.jsonl

@@ -0,0 +1,114 @@
+{"issueNumber":84,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":84,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":84,"stage":"stage:approval","durationDays":0}
+{"issueNumber":84,"stage":"stage:development","durationDays":0}
+{"issueNumber":85,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":85,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":85,"stage":"stage:approval","durationDays":0}
+{"issueNumber":85,"stage":"stage:approval","durationDays":0}
+{"issueNumber":87,"stage":"stage:approval","durationDays":0}
+{"issueNumber":87,"stage":"stage:development","durationDays":0}
+{"issueNumber":87,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":87,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":87,"stage":"stage:approval","durationDays":0}
+{"issueNumber":88,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":88,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":88,"stage":"stage:approval","durationDays":0}
+{"issueNumber":88,"stage":"stage:development","durationDays":0}
+{"issueNumber":89,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":90,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":90,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":90,"stage":"stage:approval","durationDays":0}
+{"issueNumber":90,"stage":"stage:approval","durationDays":0}
+{"issueNumber":91,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":91,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":91,"stage":"stage:approval","durationDays":0}
+{"issueNumber":91,"stage":"stage:development","durationDays":0}
+{"issueNumber":92,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":92,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":92,"stage":"stage:approval","durationDays":0}
+{"issueNumber":92,"stage":"stage:development","durationDays":0}
+{"issueNumber":93,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":93,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":93,"stage":"stage:approval","durationDays":0}
+{"issueNumber":93,"stage":"stage:development","durationDays":0}
+{"issueNumber":94,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":94,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":94,"stage":"stage:approval","durationDays":0}
+{"issueNumber":96,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":96,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":96,"stage":"stage:approval","durationDays":0}
+{"issueNumber":96,"stage":"stage:development","durationDays":0}
+{"issueNumber":97,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":97,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":97,"stage":"stage:approval","durationDays":0}
+{"issueNumber":109,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":109,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":109,"stage":"stage:approval","durationDays":0}
+{"issueNumber":109,"stage":"stage:development","durationDays":0}
+{"issueNumber":110,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":110,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":110,"stage":"stage:approval","durationDays":0.3}
+{"issueNumber":110,"stage":"stage:development","durationDays":0}
+{"issueNumber":110,"stage":"stage:testing","durationDays":0}
+{"issueNumber":111,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":111,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":111,"stage":"stage:approval","durationDays":0.3}
+{"issueNumber":111,"stage":"stage:development","durationDays":0}
+{"issueNumber":111,"stage":"stage:testing","durationDays":0}
+{"issueNumber":113,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":113,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":113,"stage":"stage:approval","durationDays":0}
+{"issueNumber":113,"stage":"stage:development","durationDays":0}
+{"issueNumber":116,"stage":"stage:brainstorming","durationDays":3.7}
+{"issueNumber":116,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":116,"stage":"stage:approval","durationDays":0}
+{"issueNumber":116,"stage":"stage:development","durationDays":0}
+{"issueNumber":119,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":119,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":119,"stage":"stage:approval","durationDays":0}
+{"issueNumber":119,"stage":"stage:approval","durationDays":0.3}
+{"issueNumber":119,"stage":"stage:development","durationDays":0}
+{"issueNumber":120,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":120,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":120,"stage":"stage:approval","durationDays":0}
+{"issueNumber":120,"stage":"stage:development","durationDays":0}
+{"issueNumber":122,"stage":"stage:brainstorming","durationDays":0.1}
+{"issueNumber":122,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":122,"stage":"stage:approval","durationDays":0}
+{"issueNumber":122,"stage":"stage:development","durationDays":0}
+{"issueNumber":125,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":125,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":125,"stage":"stage:approval","durationDays":0.1}
+{"issueNumber":125,"stage":"stage:development","durationDays":0}
+{"issueNumber":128,"stage":"stage:brainstorming","durationDays":0.6}
+{"issueNumber":128,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":128,"stage":"stage:approval","durationDays":0}
+{"issueNumber":128,"stage":"stage:development","durationDays":0}
+{"issueNumber":130,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":130,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":130,"stage":"stage:approval","durationDays":0}
+{"issueNumber":130,"stage":"stage:development","durationDays":0}
+{"issueNumber":132,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":132,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":132,"stage":"stage:approval","durationDays":0}
+{"issueNumber":132,"stage":"stage:development","durationDays":0}
+{"issueNumber":132,"stage":"stage:testing","durationDays":0}
+{"issueNumber":135,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":135,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":135,"stage":"stage:approval","durationDays":0}
+{"issueNumber":135,"stage":"stage:development","durationDays":0}
+{"issueNumber":136,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":136,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":136,"stage":"stage:approval","durationDays":0}
+{"issueNumber":136,"stage":"stage:development","durationDays":0}
+{"issueNumber":136,"stage":"stage:testing","durationDays":0.1}
+{"issueNumber":137,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":137,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":137,"stage":"stage:approval","durationDays":0}
+{"issueNumber":137,"stage":"stage:development","durationDays":0}
+{"issueNumber":137,"stage":"stage:testing","durationDays":0}
+{"issueNumber":141,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":142,"stage":"stage:brainstorming","durationDays":0}
+{"issueNumber":142,"stage":"stage:detailing","durationDays":0}
+{"issueNumber":142,"stage":"stage:approval","durationDays":0}

package/.claude/settings.json

@@ -9,6 +9,24 @@
             "command": "bash .agentic-pdlc/hooks/pdlc-stage-gate.sh"
           }
         ]
+      },
+      {
+        "matcher": "Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .agentic-pdlc/hooks/pdlc-stage-gate.sh"
+          }
+        ]
+      },
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .agentic-pdlc/hooks/pdlc-stage-gate.sh"
+          }
+        ]
       }
     ]
   }

package/.coderabbit.yaml

@@ -0,0 +1,35 @@
+language: "en-US"
+reviews:
+  profile: "chill"
+  request_changes_workflow: false
+  high_level_summary: true
+  poem: false
+  auto_review:
+    enabled: true
+    drafts: false
+    base_branches:
+      - main
+  path_instructions:
+    - path: ".github/workflows/**"
+      instructions: >
+        Pay close attention to GitHub Actions syntax correctness, trigger
+        semantics (push/pull_request/workflow_run events and their filters),
+        expression syntax (${{ }}), and shell quoting in run steps.
+        Flag any logic that could cause silent failures or unintended trigger
+        behavior.
+  review_status: true
+  auto_apply_labels: true
+  labeling_instructions:
+    - label: "architecture-violation"
+      instructions: >
+        Apply when the PR introduces runtime behavior that violates documented
+        architectural invariants: code that bypasses the PDLC stage gate at runtime,
+        application code that programmatically sets or removes labels reserved for
+        automation (stage:*, spec:approved, qa:*) outside of their designated
+        automation workflows, business logic added directly to templates instead of
+        the CLI, or behavior that directly contradicts invariants in AGENTS.md or
+        CLAUDE.md. Do NOT apply for configuration changes to tools (e.g., updating
+        .coderabbit.yaml, GitHub Actions workflows, or CI config files) — those are
+        infrastructure, not invariant violations.
+chat:
+  auto_reply: true

package/.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,53 @@
+---
+name: Bug
+about: Broken behavior with root cause and fix criteria
+title: 'bug: '
+labels: type:bug
+assignees: ''
+---
+
+## Problem
+
+<!-- What fails. Who affected. Measured impact. -->
+
+## Root Cause
+
+<!-- Why it fails. Link to code/config if known. -->
+
+## Reproduction Steps
+
+1. 
+2. 
+3. 
+
+**Expected:** 
+**Actual:** 
+
+## Acceptance Criteria
+
+<!-- agent fills during detailing -->
+
+**AC1 — [name]**
+- Given 
+- When 
+- Then 
+
+## Edge Cases
+
+<!-- agent fills during detailing -->
+- EC1: [condition] → [expected behavior]
+
+## Out of Scope
+
+<!-- agent fills during detailing -->
+- 
+
+## Non-Functional Requirements
+
+<!-- agent fills during detailing — omit if pure docs/markdown -->
+- Reliability: idempotent — safe to re-run
+
+## Files to Modify
+
+<!-- agent fills during detailing -->
+- `path/to/file` — what changes

package/.github/ISSUE_TEMPLATE/feature.md

@@ -0,0 +1,54 @@
+---
+name: Feature
+about: New capability with spec scaffold for detailing agent
+title: 'feat: '
+labels: type:feature
+assignees: ''
+---
+
+## Problem
+
+<!-- What fails or is missing. Who affected. Measured impact. -->
+
+## Sprint Goal / Success Metrics
+
+<!-- agent fills during detailing -->
+
+| Metric | Baseline | Target | When |
+|--------|----------|--------|------|
+|  |  |  |  |
+
+## Solution
+
+<!-- agent fills during detailing — behavioral description, no implementation details -->
+
+## Acceptance Criteria
+
+<!-- agent fills during detailing -->
+
+**AC1 — [name]**
+- Given 
+- When 
+- Then 
+
+## Edge Cases
+
+<!-- agent fills during detailing -->
+- EC1: [condition] → [expected behavior]
+
+## Out of Scope
+
+<!-- agent fills during detailing -->
+- 
+
+## Non-Functional Requirements
+
+<!-- agent fills during detailing — omit if pure docs/markdown -->
+- Performance: 
+- Security: 
+- Reliability: 
+
+## Files to Modify
+
+<!-- agent fills during detailing -->
+- `path/to/file` — what changes

package/.github/ISSUE_TEMPLATE/task.md

@@ -0,0 +1,33 @@
+---
+name: Task
+about: Defined work unit with clear done criteria
+title: 'task: '
+labels: type:task
+assignees: ''
+---
+
+## Objective
+
+<!-- What must be done and why. -->
+
+## Steps
+
+<!-- agent fills during detailing -->
+1. 
+2. 
+
+## Acceptance Criteria
+
+<!-- agent fills during detailing -->
+- [ ] 
+- [ ] 
+
+## Out of Scope
+
+<!-- agent fills during detailing -->
+- 
+
+## Files to Modify
+
+<!-- agent fills during detailing -->
+- `path/to/file` — what changes

package/.github/workflows/add-to-board.yml

@@ -18,7 +18,7 @@ jobs:
     steps:
       - name: Add issue to project board
         if: ${{ env.PROJECT_TOKEN != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           github-token: ${{ env.PROJECT_TOKEN }}
           script: |

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

@@ -22,7 +22,7 @@ jobs:
       STATUS_DEVELOPMENT: "2c9e78e6"
     steps:
       - name: Swap labels — stage:approval → stage:development
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |
@@ -44,13 +44,13 @@ jobs:
               owner,
               repo,
               issue_number,
-              labels: ['stage:development', 'agent:working']
+              labels: ['stage:development']
             });
 
       - name: Move board card to Development
         if: ${{ env.PROJECT_TOKEN != '' }}
         continue-on-error: true
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           github-token: ${{ env.PROJECT_TOKEN }}
           script: |
@@ -79,7 +79,7 @@ jobs:
       contents: read
     steps:
       - name: Comment on issue
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |

package/.github/workflows/ci.yml

@@ -11,7 +11,7 @@ jobs:
     name: Run tests and linters
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5.0.1
 
       - name: Setup environment
         run: echo "Replace this with your language/toolchain setup (e.g., actions/setup-node)"

package/.github/workflows/npm-publish.yml

@@ -14,10 +14,10 @@ jobs:
 
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5.0.1
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6.4.0
         with:
           node-version: '24'
           registry-url: 'https://registry.npmjs.org'

package/.github/workflows/pdlc-health-check.yml

@@ -27,7 +27,7 @@ jobs:
     steps:
       - name: Validate Board Configuration
         if: ${{ env.PROJECT_TOKEN != '' && env.PROJECT_ID != '{{PROJECT_ID}}' }}
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           github-token: ${{ env.PROJECT_TOKEN }}
           script: |

package/.github/workflows/pdlc-stage-gate.yml

@@ -37,12 +37,12 @@ jobs:
 
           for NUM in $ISSUE_NUMS; do
             LABELS=$(gh issue view "$NUM" --repo "$REPO" --json labels --jq '[.labels[].name] | join(" ")' 2>/dev/null || echo "")
-            if echo "$LABELS" | grep -qw "stage:approval" || echo "$LABELS" | grep -qw "spec:approved" || echo "$LABELS" | grep -qw "stage:development"; then
+            if echo "$LABELS" | grep -qw "stage:approval" || echo "$LABELS" | grep -qw "spec:approved" || echo "$LABELS" | grep -qw "stage:development" || echo "$LABELS" | grep -qw "stage:testing" || echo "$LABELS" | grep -qw "human-approved"; then
               echo "✅ Issue #$NUM approved"
             else
               STAGE=$(echo "$LABELS" | tr ' ' '\n' | grep "^stage:" | head -1 || echo "none")
               echo "❌ Issue #$NUM missing approval (current: $STAGE)"
-              echo "   Required: stage:approval OR spec:approved OR stage:development label on the issue."
+              echo "   Required: stage:approval OR spec:approved OR stage:development OR stage:testing OR human-approved label on the issue."
               echo "   Emergency bypass: add 'hotfix' label to this PR."
               exit 1
             fi