create-agentic-pdlc 1.0.0 → 1.1.0

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

@@ -0,0 +1,36 @@
+name: Publish to NPM
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish-npm:
+    name: Publish NPM Package
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write # Required for NPM provenance tracking
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Sync Version with GitHub Release Tag
+        run: |
+          # Strip 'v' from tag (e.g., v1.0.2 -> 1.0.2)
+          VERSION=${GITHUB_REF_NAME#v}
+          echo "Setting package version to $VERSION"
+          npm version $VERSION --no-git-tag-version
+
+      - name: Install Dependencies
+        run: npm install
+
+      - name: Publish to NPM Registry
+        run: npm publish --provenance

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

@@ -5,15 +5,79 @@ on:
     types: [opened, reopened, closed]
   pull_request_review:
     types: [submitted]
+  issue_comment:
+    types: [created]
 
 env:
   PROJECT_ID: "{{PROJECT_ID}}"
   STATUS_FIELD_ID: "{{STATUS_FIELD_ID}}"
+  STATUS_EXPLORATION: "{{ID_EXPLORATION}}"
+  STATUS_BRAINSTORMING: "{{ID_BRAINSTORMING}}"
+  STATUS_DETAILING: "{{ID_DETAILING}}"
+  STATUS_APPROVAL: "{{ID_APPROVAL}}"
   STATUS_CODE_REVIEW: "{{ID_CODE_REVIEW}}"
   STATUS_PULL_REQUEST: "{{ID_PULL_REQUEST}}"
   STATUS_PRODUCAO: "{{ID_PRODUCAO}}"
 
 jobs:
+  # Issue Comment → Move Upstream
+  move-card-on-comment:
+    name: Upstream Comment Marker → Move Card
+    if: github.event_name == 'issue_comment' && github.event.action == 'created'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Detect Marker and Move Issue
+        if: ${{ secrets.PROJECT_TOKEN != '' }}
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.PROJECT_TOKEN }}
+          script: |
+            const body = context.payload.comment.body;
+            let targetStatusId = null;
+            let stageName = null;
+
+            if (body.includes('<!-- PDLC:stage:exploration -->')) {
+              targetStatusId = process.env.STATUS_EXPLORATION;
+              stageName = 'Exploration';
+            } else if (body.includes('<!-- PDLC:stage:brainstorming -->')) {
+              targetStatusId = process.env.STATUS_BRAINSTORMING;
+              stageName = 'Brainstorming';
+            } else if (body.includes('<!-- PDLC:stage:detailing -->')) {
+              targetStatusId = process.env.STATUS_DETAILING;
+              stageName = 'Detailing';
+            } else if (body.includes('<!-- PDLC:stage:approval -->')) {
+              targetStatusId = process.env.STATUS_APPROVAL;
+              stageName = 'Approval';
+            }
+
+            if (!targetStatusId) {
+              console.log('No upstream PDLC marker found. Skipping.');
+              return;
+            }
+
+            const { issue: { number, node_id } } = context.payload;
+
+            const moveItem = async (nodeId, statusId) => {
+              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: statusId }
+                });
+            };
+
+            await moveItem(node_id, targetStatusId);
+            console.log(`Issue #${number} moved to ${stageName}`);
+
+
   # PR Opened → Move linked issue to Code Review
   move-card-on-pr-open:
     name: Open PR → Code Review
@@ -21,6 +85,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Move linked issue to Code Review
+        if: ${{ secrets.PROJECT_TOKEN != '' }}
         uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.PROJECT_TOKEN }}
@@ -72,6 +137,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Move issue to Pull Request
+        if: ${{ secrets.PROJECT_TOKEN != '' }}
         uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.PROJECT_TOKEN }}
@@ -115,6 +181,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Move issue to Production
+        if: ${{ secrets.PROJECT_TOKEN != '' }}
         uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.PROJECT_TOKEN }}

package/AGENTS.md

@@ -26,6 +26,7 @@ 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.

package/bin/cli.js

@@ -39,7 +39,7 @@ function copyDirSync(src, dest) {
   }
 }
 
-rl.question('Which AI Agent do you use to bootstrap? (claude / cursor): ', (answer) => {
+rl.question('Which AI Agent will you use for the setup? (e.g. claude, cursor, copilot, or other): ', (answer) => {
   const agent = answer.trim().toLowerCase();
   
   console.log(`\n${yellow}Scaffolding Agentic PDLC into your project...${reset}`);
@@ -59,13 +59,13 @@ rl.question('Which AI Agent do you use to bootstrap? (claude / cursor): ', (answ
 
   if (agent === 'claude') {
     if (fs.existsSync(claudeSetupSrc)) {
-      const dest = path.join(targetDir, '.claude.md');
+      const dest = path.join(targetDir, '.agentic-setup.md');
       fs.copyFileSync(claudeSetupSrc, dest);
-      console.log(`✅ Setup agent profile written to .claude.md`);
+      console.log(`✅ Setup agent profile written to .agentic-setup.md`);
       console.log(`\n${green}🎉 Done! To start the conversational setup:${reset}`);
       console.log(`${cyan}\t1. Type 'claude'${reset}`);
-      console.log(`${cyan}\t2. It should automatically detect Setup Mode and prompt you.${reset}`);
-      console.log(`\nNote: The agent expects templates in .agentic-pdlc/templates.\n`);
+      console.log(`${cyan}\t2. Ask Claude to "read .agentic-setup.md to enter Setup Mode."${reset}`);
+      console.log(`\nNote: Once setup is completed, the agent will typically delete .agentic-setup.md to keep your root clean.\n`);
     } else {
       console.error(`❌ Could not find claude instruction file at ${claudeSetupSrc}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-agentic-pdlc",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Scaffold the Agentic PDLC framework effortlessly",
   "type": "commonjs",
   "bin": {
@@ -21,6 +21,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/rafaeltcosta86/agentic-pdlc.git"
+    "url": "git+https://github.com/rafaeltcosta86/agentic-pdlc.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   }
 }

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

@@ -5,15 +5,79 @@ on:
     types: [opened, reopened, closed]
   pull_request_review:
     types: [submitted]
+  issue_comment:
+    types: [created]
 
 env:
   PROJECT_ID: "{{PROJECT_ID}}"
   STATUS_FIELD_ID: "{{STATUS_FIELD_ID}}"
+  STATUS_EXPLORATION: "{{ID_EXPLORATION}}"
+  STATUS_BRAINSTORMING: "{{ID_BRAINSTORMING}}"
+  STATUS_DETAILING: "{{ID_DETAILING}}"
+  STATUS_APPROVAL: "{{ID_APPROVAL}}"
   STATUS_CODE_REVIEW: "{{ID_CODE_REVIEW}}"
   STATUS_PULL_REQUEST: "{{ID_PULL_REQUEST}}"
   STATUS_PRODUCAO: "{{ID_PRODUCAO}}"
 
 jobs:
+  # Issue Comment → Move Upstream
+  move-card-on-comment:
+    name: Upstream Comment Marker → Move Card
+    if: github.event_name == 'issue_comment' && github.event.action == 'created'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Detect Marker and Move Issue
+        if: ${{ secrets.PROJECT_TOKEN != '' }}
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.PROJECT_TOKEN }}
+          script: |
+            const body = context.payload.comment.body;
+            let targetStatusId = null;
+            let stageName = null;
+
+            if (body.includes('<!-- PDLC:stage:exploration -->')) {
+              targetStatusId = process.env.STATUS_EXPLORATION;
+              stageName = 'Exploration';
+            } else if (body.includes('<!-- PDLC:stage:brainstorming -->')) {
+              targetStatusId = process.env.STATUS_BRAINSTORMING;
+              stageName = 'Brainstorming';
+            } else if (body.includes('<!-- PDLC:stage:detailing -->')) {
+              targetStatusId = process.env.STATUS_DETAILING;
+              stageName = 'Detailing';
+            } else if (body.includes('<!-- PDLC:stage:approval -->')) {
+              targetStatusId = process.env.STATUS_APPROVAL;
+              stageName = 'Approval';
+            }
+
+            if (!targetStatusId) {
+              console.log('No upstream PDLC marker found. Skipping.');
+              return;
+            }
+
+            const { issue: { number, node_id } } = context.payload;
+
+            const moveItem = async (nodeId, statusId) => {
+              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: statusId }
+                });
+            };
+
+            await moveItem(node_id, targetStatusId);
+            console.log(`Issue #${number} moved to ${stageName}`);
+
+
   # PR Opened → Move linked issue to Code Review
   move-card-on-pr-open:
     name: Open PR → Code Review
@@ -21,6 +85,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Move linked issue to Code Review
+        if: ${{ secrets.PROJECT_TOKEN != '' }}
         uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.PROJECT_TOKEN }}
@@ -72,6 +137,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Move issue to Pull Request
+        if: ${{ secrets.PROJECT_TOKEN != '' }}
         uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.PROJECT_TOKEN }}
@@ -115,6 +181,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Move issue to Production
+        if: ${{ secrets.PROJECT_TOKEN != '' }}
         uses: actions/github-script@v7
         with:
           github-token: ${{ secrets.PROJECT_TOKEN }}

package/templates/AGENTS.md

@@ -29,6 +29,7 @@ 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.