create-agentic-pdlc 1.2.1 → 2.0.1

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

@@ -16,9 +16,9 @@ env:
   STATUS_DETAILING: "{{ID_DETAILING}}"
   STATUS_APPROVAL: "{{ID_APPROVAL}}"
   STATUS_DEVELOPMENT: "{{ID_DEVELOPMENT}}"
+  STATUS_TESTING: "{{ID_TESTING}}"
   STATUS_CODE_REVIEW_PR: "{{ID_CODE_REVIEW_PR}}"
-  STATUS_MERGE: "{{ID_MERGE}}"
-  STATUS_PRODUCAO: "{{ID_PRODUCAO}}"
+  STATUS_PRODUCTION: "{{ID_PRODUCTION}}"
 
 jobs:
   # Issue Labeled → Move Upstream
@@ -39,21 +39,24 @@ jobs:
             let targetStatusId = null;
             let stageName = null;
 
-            if (labelName === 'stage:exploration') {
+            if (labelName === 'upstream:exploration') {
               targetStatusId = process.env.STATUS_EXPLORATION;
               stageName = 'Exploration';
-            } else if (labelName === 'stage:brainstorming') {
+            } else if (labelName === 'upstream:brainstorming') {
               targetStatusId = process.env.STATUS_BRAINSTORMING;
               stageName = 'Brainstorming';
-            } else if (labelName === 'stage:detailing') {
+            } else if (labelName === 'upstream:detailing') {
               targetStatusId = process.env.STATUS_DETAILING;
               stageName = 'Detailing';
-            } else if (labelName === 'spec:approved') {
+            } else if (labelName === 'upstream:approval') {
               targetStatusId = process.env.STATUS_APPROVAL;
               stageName = 'Approval';
-            } else if (labelName === 'stage:development') {
+            } else if (labelName === 'upstream:development') {
               targetStatusId = process.env.STATUS_DEVELOPMENT;
               stageName = 'Development';
+            } else if (labelName === 'upstream:testing') {
+              targetStatusId = process.env.STATUS_TESTING;
+              stageName = 'Testing';
             }
 
             if (!targetStatusId) {
@@ -83,6 +86,7 @@ jobs:
             await moveItem(node_id, targetStatusId);
             console.log(`Issue #${number} moved to ${stageName}`);
 
+{{OPTIONAL_ARCHITECTURE_VIOLATION_JOB}}
 
   # PR Opened → Move linked issue to Code Review / PR
   move-card-on-pr-open:
@@ -136,17 +140,17 @@ jobs:
               console.log(`PR #${prNumber} → Code Review / PR (no linked issue)`);
             }
 
-            await github.rest.issues.addLabels({ owner, repo, issue_number: prNumber, labels: ['pr:review'] }).catch(() => {});
+            await github.rest.issues.addLabels({ owner, repo, issue_number: prNumber, labels: ['pr:in-review'] }).catch(() => {});
 
-  # Review Approved → Merge
+  # Review Approved → Add Label
   move-card-on-review-approved:
-    name: Approved PR → Merge
+    name: Approved PR → Add Label
     if: github.event_name == 'pull_request_review' && github.event.review.state == 'approved'
     runs-on: ubuntu-latest
     env:
       PROJECT_TOKEN: ${{ secrets.PROJECT_TOKEN }}
     steps:
-      - name: Move issue to Merge
+      - name: Swap PR labels
         if: ${{ env.PROJECT_TOKEN != '' }}
         uses: actions/github-script@v7
         with:
@@ -154,34 +158,7 @@ jobs:
           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_MERGE } });
-            };
-
-            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);
-              }
-            } else {
-              await moveItem(pr.node_id);
-            }
-
-            try { await github.rest.issues.removeLabel({ owner, repo, issue_number: prNumber, name: 'pr:review' }); } catch {}
+            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(() => {});
 
   # PR Merged → Production
@@ -215,7 +192,7 @@ jobs:
                     projectV2Item { id }
                   }
                 }`, { p: process.env.PROJECT_ID, i: item.id, f: process.env.STATUS_FIELD_ID,
-                      v: { singleSelectOptionId: process.env.STATUS_PRODUCAO } });
+                      v: { singleSelectOptionId: process.env.STATUS_PRODUCTION } });
             };
 
             if (linkedIssues.length > 0) {

package/templates/.github/workflows/upstream-gate.yml

@@ -0,0 +1,54 @@
+name: Upstream Gate 1
+
+on:
+  issue_comment:
+    types: [created]
+
+jobs:
+  evaluate-gate:
+    name: Evaluate Brainstorming Approval
+    if: ${{ !github.event.issue.pull_request && contains(github.event.issue.labels.*.name, 'upstream:brainstorming') }}
+    runs-on: ubuntu-latest
+    env:
+      PROJECT_TOKEN: ${{ secrets.PROJECT_TOKEN }}
+    steps:
+      - name: Check for approval and swap label
+        if: ${{ env.PROJECT_TOKEN != '' }}
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ env.PROJECT_TOKEN }}
+          script: |
+            const comment = context.payload.comment.body.toLowerCase();
+            const isApproved = 
+              comment.includes('approved') || 
+              comment.includes('lgtm') || 
+              /option\s+[a-z0-9]/i.test(comment) ||
+              /go\s+with\s+[a-z0-9]/i.test(comment) ||
+              /proceed/i.test(comment);
+
+            if (isApproved) {
+              const { owner, repo } = context.repo;
+              const issue_number = context.payload.issue.number;
+
+              console.log('Approval detected, swapping labels...');
+
+              try {
+                await github.rest.issues.removeLabel({
+                  owner,
+                  repo,
+                  issue_number,
+                  name: 'upstream:brainstorming'
+                });
+              } catch (e) {
+                console.log('Could not remove upstream:brainstorming label');
+              }
+
+              await github.rest.issues.addLabels({
+                owner,
+                repo,
+                issue_number,
+                labels: ['upstream:detailing']
+              });
+            } else {
+              console.log('No approval pattern detected in the comment.');
+            }

package/templates/AGENTS.md

@@ -30,12 +30,39 @@ Always start from the current `main` HEAD. Never work over stale snapshots.
 ## Mandatory Workflow
 
 0. **Identity**: Always prefix your GitHub comments with `🤖 **Agent:** ` to distinguish yourself.
-1. Read the issue entirely — understand its type (US/BUG/TASK/SPIKE) and the Acceptance Criteria.
-2. Read `docs/pdlc.md` — understand the PDLC and the Definition of Done in this project.
-3. Read all files mentioned in the issue's technical context.
-4. Implement the **minimum viable change** that satisfies the ACs — do not refactor beyond scope.
-5. Run tests: `{{TEST_COMMAND}}`
-6. Create a Pull Request with `Closes #N` in the body — automation moves the board.
+1. **Initial State**: When beginning work on a new issue, your very first action must be to apply the `stage:exploration` label using the GitHub CLI (`gh issue edit <N> --add-label "stage:exploration"`).
+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
+```
 
 ## What NOT to do
 
@@ -49,5 +76,6 @@ Always start from the current `main` HEAD. Never work over stale snapshots.
 
 - **Tests:** `{{TEST_COMMAND}}`
 - **Lint/Types:** `{{LINT_COMMAND}}`
+- **Typecheck:** `{{TYPECHECK_COMMAND}}`
 - **Build:** `{{BUILD_COMMAND}}`
 {{EXTRA_PATTERNS}}

package/templates/docs/pdlc.md

@@ -72,7 +72,7 @@ REPO         = {{REPO_OWNER}}/{{REPO_NAME}}
 | `stage:detailing` | Issue | Blue | Technical spec is being written |
 | `stage:development` | Issue | Orange | Agent is implementing the spec |
 | `spec:approved` | Issue | Green | Gate 2 — agent is cleared to implement |
-| `pr:review` | PR | Yellow | Awaiting code review |
+| `pr:in-review` | PR | Yellow | Awaiting code review |
 | `pr:approved` | PR | Green | Code review approved |
 
 ## Approval Gates