create-agentic-pdlc 2.3.0 → 3.0.0

package/.agentic-pdlc/templates/AGENTS.md

@@ -1,104 +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.
-
-## 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.
-{{EXTRA_DONT}}
-
-## Project Standards
-
-- **Tests:** `{{TEST_COMMAND}}`
-- **Lint/Types:** `{{LINT_COMMAND}}`
-- **Typecheck:** `{{TYPECHECK_COMMAND}}`
-- **Build:** `{{BUILD_COMMAND}}`
-{{EXTRA_PATTERNS}}

package/.agentic-pdlc/templates/docs/pdlc.md

@@ -1,123 +0,0 @@
-# PDLC — {{PROJECT_NAME}}
-
-## Board Columns
-
-| Column | Meaning | Who moves the card |
-|---|---|---|
-| 💡 Idea | Backlog — tell agent: "work on issue #XX" | Don't move manually |
-| 🧠 Brainstorming | AI reading context, proposing approaches and trade-offs | Label `stage:brainstorming` |
-| 📐 Detail Solution | Claude is writing the technical spec | Label `stage:detailing` |
-| ✅ Approval | Spec ready, awaiting `spec:approved` label | Label `spec:approved` |
-| ⚙️ Development | Agent implementing the spec | Label `stage:development` |
-| 🧪 Testing | CI pipeline or AI QA Agent running (Variant B) | GitHub Actions / QA Agent |
-| 👁 Code Review / PR | PR opened (Variant A) or QA passed (Variant B) | GitHub Actions |
-| 🚀 Ready for Production | Merged | GitHub Actions |
-
-<!--
-Adapt columns as needed. The functional baseline is:
-💡 Idea → ⚙️ Development → 👁 Code Review / PR → 🚀 Ready for Production
--->
-
-## Workflow Variants (QA Agent)
-
-- **Variant A (Default):** PRs bypass the `Testing` column and land directly in `Code Review / PR`.
-- **Variant B (QA Agent Enabled):** PRs land in the `Testing` column first. An AI QA agent verifies the PR, adding `qa:pass` or `qa:fail`. Only after a `qa:pass` is the issue moved to `Code Review / PR`.
-
-## Board Identifiers (GitHub Projects)
-
-```
-PROJECT_ID   = {{PROJECT_ID}}
-STATUS_FIELD = {{STATUS_FIELD_ID}}
-REPO         = {{REPO_OWNER}}/{{REPO_NAME}}
-```
-
-## Column Option IDs
-
-| Column | Option ID |
-|---|---|
-| 💡 Idea | `{{ID_IDEA}}` |
-| 🧠 Brainstorming | `{{ID_BRAINSTORMING}}` |
-| 📐 Detail Solution | `{{ID_DETAIL}}` |
-| ✅ Approval | `{{ID_APPROVAL}}` |
-| ⚙️ Development | `{{ID_DEVELOPMENT}}` |
-| 🧪 Testing | `{{ID_TESTING}}` |
-| 👁 Code Review / PR | `{{ID_CODE_REVIEW_PR}}` |
-| 🚀 Ready for Production | `{{ID_READY_FOR_PRODUCTION}}` |
-
-## Agent × Phase Mapping
-
-| Phase | Responsible |
-|---|---|
-| 💡 → 📐 (upstream) | Claude (or ideation agent) in conversational session |
-| ⚙️ → 🔀 (downstream) | {{IMPLEMENTATION_AGENT}} (e.g. Jules `@google-labs-jules`) |
-| 👁 Code Review / PR | Human (you) |
-| Automatic transitions | GitHub Actions |
-
-## Issue Title Conventions
-
-```
-[icon] [PREFIX]: [short description, imperative tense]
-
-👤 US:     user story
-🐛 BUG:    bug
-🔧 TASK:   operational task
-🔬 SPIKE:  exploration/evaluation spike
-```
-
-## Labels
-
-| Label | Entity | Color | Meaning |
-|---|---|---|---|
-| `stage:brainstorming` | Issue | Pink | Proposed approaches awaiting PM gate |
-| `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:in-review` | PR | Yellow | Awaiting code review |
-| `pr:approved` | PR | Green | Code review approved |
-| `type:us` | Issue | Blue | New feature or behavioral change — full flow |
-| `type:task` | Issue | Yellow | Operational/non-functional change — full flow |
-| `type:bug` | Issue | Red | Something broken — full flow |
-| `type:spike` | Issue | Gray | Research/evaluation — never reaches Development |
-
-## Approval Gates
-
-**Gate 1 — PM/Ideation (Brainstorming):**
-Agent presents problem summary + 2–3 solution options in a single message. You select an approach.
-Format: *"Option X"* or *"Go with B"* or *"Approved — proceed with option X."*
-
-**Gate 2 — Tech Lead (Spec):**
-You add the `spec:approved` label to the issue after reviewing the technical spec in the body.
-This triggers the implementation agent via `agent-trigger.yml`.
-
-## Shortcuts by Type
-
-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` | brainstorming → Gate 1 → detailing → approval |
-| `type:task` | brainstorming → Gate 1 → detailing → approval |
-| `type:bug` | brainstorming → Gate 1 → detailing → approval |
-| `type:spike` | brainstorming → Gate 1 → 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).
-
-## Bypass Mechanism
-
-Agents MUST NOT skip any stage. The ONLY authorized bypasses are:
-
-| Mechanism | Who authorizes | What it bypasses |
-|---|---|---|
-| `human-approved` label on issue | PM (human) only | All stage gates |
-| Branch prefix `hotfix/` | PM (human) only | PR gate only |
-
-Agents MUST NOT self-authorize a bypass. Stop and ask the PM explicitly.
-
-## Definition of Done
-
-An issue is truly done when:
-- [ ] All Acceptance Criteria described in the body are implemented
-- [ ] Tests passing: `{{TEST_COMMAND}}`
-- [ ] No invariant violations (CI green)
-- [ ] Associated PR explicitly contains `Closes #N`
-- [ ] Basic manual smoke test executed after deploy (when applicable)

package/.github/workflows/agentic-metrics.yml

@@ -1,422 +0,0 @@
-name: Agentic Metrics — Weekly Pulse
-
-on:
-  schedule:
-    - cron: '0 8 * * 0' # Sunday 8am UTC
-  workflow_dispatch:
-
-permissions:
-  contents: write
-  issues: write
-
-jobs:
-  generate-pulse:
-    name: Generate Weekly Agentic Pulse
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Collect Stage Residence Time
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const fs = require('fs');
-
-            const { owner, repo } = context.repo;
-            const since = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString();
-            const STAGE_LABELS = new Set([
-              'stage:brainstorming', 'stage:detailing',
-              'stage:approval', 'stage:development', 'stage:testing'
-            ]);
-
-            const QUERY = `
-              query($owner: String!, $repo: String!, $since: DateTime!, $cursor: String) {
-                repository(owner: $owner, name: $repo) {
-                  issues(first: 50, after: $cursor, filterBy: { since: $since }) {
-                    pageInfo { hasNextPage endCursor }
-                    nodes {
-                      number
-                      timelineItems(first: 100, itemTypes: [LABELED_EVENT, UNLABELED_EVENT]) {
-                        nodes {
-                          ... on LabeledEvent   { __typename createdAt label { name } }
-                          ... on UnlabeledEvent { __typename createdAt label { name } }
-                        }
-                      }
-                    }
-                  }
-                }
-              }
-            `;
-
-            const records = [];
-            let cursor = null;
-            do {
-              const result = await github.graphql(QUERY, { owner, repo, since, cursor });
-              const { nodes, pageInfo } = result.repository.issues;
-
-              for (const issue of nodes) {
-                const events = issue.timelineItems.nodes
-                  .filter(e => e.label && STAGE_LABELS.has(e.label.name))
-                  .sort((a, b) => new Date(a.createdAt) - new Date(b.createdAt));
-
-                const labeledAt = {};
-                for (const ev of events) {
-                  const stage = ev.label.name;
-                  if (ev.__typename === 'LabeledEvent') {
-                    labeledAt[stage] = new Date(ev.createdAt);
-                  } else if (ev.__typename === 'UnlabeledEvent' && labeledAt[stage]) {
-                    const durationDays = Math.round((new Date(ev.createdAt) - labeledAt[stage]) / 864e5 * 10) / 10;
-                    records.push({ issueNumber: issue.number, stage, durationDays });
-                    delete labeledAt[stage];
-                  }
-                }
-              }
-
-              cursor = pageInfo.hasNextPage ? pageInfo.endCursor : null;
-            } while (cursor);
-
-            function isoWeek(d) {
-              const dt = new Date(Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()));
-              dt.setUTCDate(dt.getUTCDate() + 4 - (dt.getUTCDay() || 7));
-              const y = new Date(Date.UTC(dt.getUTCFullYear(), 0, 1));
-              return { year: dt.getUTCFullYear(), week: Math.ceil((((dt - y) / 86400000) + 1) / 7) };
-            }
-
-            const { year, week } = isoWeek(new Date());
-            const weekKey = `${year}-W${String(week).padStart(2, '0')}`;
-
-            fs.mkdirSync('.agentic-pdlc/metrics/raw', { recursive: true });
-            fs.writeFileSync(
-              `.agentic-pdlc/metrics/raw/${weekKey}.jsonl`,
-              records.map(r => JSON.stringify(r)).join('\n')
-            );
-
-            core.exportVariable('WEEK_KEY', weekKey);
-            console.log(`Collected ${records.length} stage transitions → week ${weekKey}`);
-
-      - name: Commit JSONL raw data
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git add .agentic-pdlc/metrics/raw/
-          git diff --staged --quiet && echo "No new stage data" && exit 0
-          git commit -m "metrics: raw stage data ${WEEK_KEY} [skip ci]"
-          git push
-
-      - name: Collect PR and Issue Insights
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const fs = require('fs');
-            const { owner, repo } = context.repo;
-            const weekKey = process.env.WEEK_KEY;
-
-            // ── Helper ──────────────────────────────────────────────────────
-            function daysSince(isoStr) {
-              return (Date.now() - new Date(isoStr).getTime()) / 864e5;
-            }
-            function round1(n) { return Math.round(n * 10) / 10; }
-
-            // Week date range for issue title (ISO week, Mon–Sun)
-            function weekDateRange(key) {
-              const [yr, wStr] = key.split('-W');
-              const week = parseInt(wStr, 10);
-              // Jan 4 is always in week 1
-              const jan4 = new Date(Date.UTC(parseInt(yr, 10), 0, 4));
-              const monday = new Date(jan4);
-              monday.setUTCDate(jan4.getUTCDate() - ((jan4.getUTCDay() + 6) % 7) + (week - 1) * 7);
-              const sunday = new Date(monday);
-              sunday.setUTCDate(monday.getUTCDate() + 6);
-              const months = ['Jan','Fev','Mar','Abr','Mai','Jun','Jul','Ago','Set','Out','Nov','Dez'];
-              const pad = n => String(n).padStart(2, '0');
-              const startMonth = months[monday.getUTCMonth()];
-              const endMonth   = months[sunday.getUTCMonth()];
-              const monthLabel = startMonth === endMonth ? startMonth : startMonth + '/' + endMonth;
-              return pad(monday.getUTCDate()) + '-' + pad(sunday.getUTCDate()) + '/' + monthLabel;
-            }
-
-            // ── Signal collection ───────────────────────────────────────────
-            const signals = [];
-
-            // 1. Orphan issues: open >14 days with no linked PR
-            const closeRe = /(?:closes?|fixes?|resolves?)\s+#(\d+)/gi;
-            const openIssues = await github.paginate(github.rest.issues.listForRepo, {
-              owner, repo, state: 'open', per_page: 100
-            });
-
-            const recentPRs = await github.paginate(github.rest.pulls.list, {
-              owner, repo, state: 'closed', per_page: 50,
-              sort: 'updated', direction: 'desc'
-            });
-
-            const linkedIssueNums = new Set();
-            for (const pr of recentPRs) {
-              const body = pr.body || '';
-              let m;
-              while ((m = closeRe.exec(body)) !== null) linkedIssueNums.add(parseInt(m[1]));
-              closeRe.lastIndex = 0;
-            }
-
-            const orphans = openIssues.filter(i =>
-              !i.pull_request &&
-              daysSince(i.created_at) > 14 &&
-              !linkedIssueNums.has(i.number)
-            );
-
-            if (orphans.length > 0) {
-              const names = orphans.slice(0, 5).map(i => `#${i.number} "${i.title}"`).join(', ');
-              const extra = orphans.length > 5 ? ` e mais ${orphans.length - 5}` : '';
-              signals.push({
-                level: 'red',
-                emoji: '🔴',
-                title: `**${orphans.length} issue${orphans.length > 1 ? 's abertas' : ' aberta'} há 14+ dias sem PR linkado**`,
-                body: `${names}${extra}\n→ Atribua, planeje ou feche se não for mais relevante.`
-              });
-            } else {
-              signals.push({
-                level: 'green',
-                emoji: '🟢',
-                title: '**Nenhuma issue esquecida**',
-                body: 'Todas as issues abertas têm menos de 14 dias ou têm PR linkado.'
-              });
-            }
-
-            // 2. PR merge time trend: last 10 merged PRs split 5+5
-            const mergedPRs = recentPRs
-              .filter(pr => pr.merged_at)
-              .slice(0, 10);
-
-            if (mergedPRs.length >= 4) {
-              const half = Math.floor(mergedPRs.length / 2);
-              const recent = mergedPRs.slice(0, half);
-              const older  = mergedPRs.slice(half);
-              const avgDays = prs => {
-                const total = prs.reduce((s, pr) =>
-                  s + (new Date(pr.merged_at) - new Date(pr.created_at)) / 864e5, 0);
-                return round1(total / prs.length);
-              };
-              const recentAvg = avgDays(recent);
-              const olderAvg  = avgDays(older);
-              const ratio = recentAvg / olderAvg;
-
-              if (ratio >= 1.5) {
-                signals.push({
-                  level: 'yellow',
-                  emoji: '🟡',
-                  title: `**Tempo de merge aumentou ${round1(ratio)}x esta semana**`,
-                  body: `Últimos ${half} PRs: **${recentAvg} dias** · ${half} anteriores: **${olderAvg} dias**\n→ Algo desacelerou o review. Verifique PRs pendentes de aprovação.`
-                });
-              } else if (ratio <= 0.67) {
-                signals.push({
-                  level: 'green',
-                  emoji: '🟢',
-                  title: `**Tempo de merge melhorou ${round1(1/ratio)}x esta semana**`,
-                  body: `Últimos ${half} PRs: **${recentAvg} dias** · ${half} anteriores: **${olderAvg} dias** ✅`
-                });
-              } else {
-                signals.push({
-                  level: 'neutral',
-                  emoji: '🔵',
-                  title: `**Tempo de merge estável: ${recentAvg} dias** (semana passada: ${olderAvg}d)`,
-                  body: ''
-                });
-              }
-            }
-
-            // 3. Rework rate: commits per PR — single push session = first-shot
-            const weekAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
-            const weekMerged = recentPRs.filter(pr => pr.merged_at && new Date(pr.merged_at) > weekAgo);
-
-            if (weekMerged.length > 0) {
-              let firstShots = 0;
-              for (const pr of weekMerged.slice(0, 10)) {
-                try {
-                  const commits = await github.rest.pulls.listCommits({
-                    owner, repo, pull_number: pr.number, per_page: 100
-                  });
-                  const times = commits.data.map(c => new Date(c.commit.committer.date).getTime()).sort();
-                  let sessions = 1;
-                  for (let i = 1; i < times.length; i++) {
-                    if (times[i] - times[i-1] > 10 * 60 * 1000) sessions++;
-                  }
-                  if (sessions === 1) firstShots++;
-                } catch (e) { /* skip if commits not accessible */ }
-              }
-              const total = Math.min(weekMerged.length, 10);
-              const pct = Math.round(firstShots / total * 100);
-
-              // Detect if repo uses an agent label (jules, sweep, codex, etc.)
-              const agentLabels = new Set(['jules', 'sweep', 'codex', 'copilot']);
-              const usesAgent = weekMerged.some(pr =>
-                (pr.labels || []).some(l => agentLabels.has(l.name.toLowerCase()))
-              );
-              const subject = usesAgent ? 'Agent first-shot rate' : 'PRs sem rework';
-              const verb = usesAgent ? 'acertaram de primeira' : 'foram mergeados sem rework';
-
-              if (pct >= 80) {
-                signals.push({
-                  level: 'green',
-                  emoji: '🟢',
-                  title: `**${subject}: ${pct}%**`,
-                  body: `${firstShots} de ${total} PRs ${verb} esta semana. ✅`
-                });
-              } else if (pct < 50) {
-                signals.push({
-                  level: 'yellow',
-                  emoji: '🟡',
-                  title: `**${subject}: ${pct}% — rework alto**`,
-                  body: `Apenas ${firstShots} de ${total} PRs sem commits extras.\n→ Specs incompletas ou mudanças de requisito durante implementação.`
-                });
-              } else {
-                signals.push({
-                  level: 'neutral',
-                  emoji: '🔵',
-                  title: `**${subject}: ${pct}%**`,
-                  body: `${firstShots} de ${total} PRs sem rework commits.`
-                });
-              }
-            }
-
-            // 4. Unlinked PRs: merged without Closes/Fixes #N
-            const unlinkRe = /(?:closes?|fixes?|resolves?)\s+#\d+/i;
-            const unlinked = weekMerged.filter(pr => !unlinkRe.test(pr.body || ''));
-            if (unlinked.length > 0) {
-              const nums = unlinked.map(pr => `#${pr.number}`).join(', ');
-              signals.push({
-                level: 'yellow',
-                emoji: '🔵',
-                title: `**${unlinked.length} PR${unlinked.length > 1 ? 's mergeados' : ' mergeado'} sem link de issue**`,
-                body: `${nums} não ${unlinked.length > 1 ? 'têm' : 'tem'} \`Closes #N\` no body. Difícil rastrear o que resolveram.\n→ Edite o body do PR ou feche as issues relacionadas manualmente.`
-              });
-            }
-
-            // ── Stage Residence Time section (conditional) ──────────────────
-            let stageSection = '';
-            const jsonlPath = `.agentic-pdlc/metrics/raw/${weekKey}.jsonl`;
-            if (fs.existsSync(jsonlPath)) {
-              const records = fs.readFileSync(jsonlPath, 'utf8').trim().split('\n').filter(Boolean).map(JSON.parse);
-              if (records.length > 0) {
-                const STAGES = [
-                  ['stage:brainstorming', 'Brainstorming'],
-                  ['stage:detailing',     'Detailing'],
-                  ['stage:approval',      'Approval'],
-                  ['stage:development',   'Development'],
-                  ['stage:testing',       'Testing'],
-                ];
-                const byStage = {};
-                for (const r of records) {
-                  if (!byStage[r.stage]) byStage[r.stage] = [];
-                  byStage[r.stage].push(r.durationDays);
-                }
-                const avg = arr => arr.reduce((a, b) => a + b, 0) / arr.length;
-
-                let maxStage = null, maxDays = -1;
-                const rows = [];
-                for (const [stage, label] of STAGES) {
-                  const days = byStage[stage];
-                  if (!days) {
-                    rows.push(`| **${label}** | — | — |`);
-                    continue;
-                  }
-                  const a = round1(avg(days));
-                  rows.push(`| **${label}** | ${a}d | ${days.length} |`);
-                  if (a > maxDays) { maxStage = label; maxDays = a; }
-                }
-
-                if (rows.length > 0) {
-                  stageSection = `\n---\n\n### 🔄 Stage Residence Time *(board ativo)*\n\n| Stage | Média | Issues |\n|---|---|---|\n${rows.join('\n')}\n\n> \`${maxStage}\` é o maior gargalo (${maxDays}d avg). Considere quebrar specs ou aumentar cadência de revisão nessa fase.\n`;
-                }
-              }
-            }
-
-            // ── Narrative ───────────────────────────────────────────────────
-            const reds    = signals.filter(s => s.level === 'red').length;
-            const yellows = signals.filter(s => s.level === 'yellow').length;
-
-            let narrative;
-            if (reds >= 2)             narrative = '⚠️ Fluxo sob pressão esta semana. Múltiplos bloqueios identificados. Priorize limpar issues orphans e revisar PRs pendentes antes de iniciar novas features.';
-            else if (reds === 1 && yellows >= 1) narrative = 'Semana mista. Um ponto crítico e sinais de desaceleração. Verifique os itens marcados em 🔴 antes de avançar.';
-            else if (reds === 0 && yellows === 0) narrative = '🟢 Fluxo saudável. Nenhum bloqueio identificado esta semana. Bom momento para avançar em novas features.';
-            else                        narrative = 'Fluxo normal. Alguns ajustes de processo podem melhorar rastreabilidade e velocidade.';
-
-            // ── Build issue body ────────────────────────────────────────────
-            const signalLines = signals.map(s =>
-              `${s.emoji} ${s.title}${s.body ? '\n' + s.body : ''}`
-            ).join('\n\n');
-
-            const nextWeekNum = (() => {
-              const d = new Date(); d.setDate(d.getDate() + 7);
-              const dt = new Date(Date.UTC(d.getFullYear(), d.getMonth(), d.getDate()));
-              dt.setUTCDate(dt.getUTCDate() + 4 - (dt.getUTCDay() || 7));
-              const y = new Date(Date.UTC(dt.getUTCFullYear(), 0, 1));
-              const w = Math.ceil((((dt - y) / 86400000) + 1) / 7);
-              return `${dt.getUTCFullYear()}-W${String(w).padStart(2, '0')}`;
-            })();
-
-            const body = [
-              '> Auto-generated by [agentic-pdlc](https://github.com/rafaeltcosta86/agentic-pdlc). Appears every Sunday.',
-              '',
-              narrative,
-              '',
-              '---',
-              '',
-              '### Sinais desta semana',
-              '',
-              signalLines,
-              stageSection,
-              '---',
-              '*Próximo pulse: ' + nextWeekNum + '*',
-              '',
-              '💬 Este pulse foi útil? [Conta pra gente](https://github.com/rafaeltcosta86/agentic-pdlc/issues/new?template=pulse-feedback.md&title=' + encodeURIComponent('[Pulse] ' + weekKey) + ') — 1 clique, sem formulário.'
-            ].join('\n');
-
-            const dateRange = weekDateRange(weekKey);
-            core.exportVariable('PULSE_TITLE', '📊 Agentic Pulse — ' + weekKey + ' (' + dateRange + ')');
-            core.exportVariable('PULSE_BODY', body);
-            console.log(`Built pulse issue for ${weekKey} — ${signals.length} signals, ${reds} red, ${yellows} yellow`);
-
-      - name: Create Weekly Pulse Issue
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const { owner, repo } = context.repo;
-            const title = process.env.PULSE_TITLE;
-            const body  = process.env.PULSE_BODY;
-            const LABEL = 'metrics:weekly';
-
-            // Ensure label exists
-            try {
-              await github.rest.issues.getLabel({ owner, repo, name: LABEL });
-            } catch (e) {
-              await github.rest.issues.createLabel({
-                owner, repo, name: LABEL,
-                color: '0075ca',
-                description: 'Auto-generated weekly metrics pulse'
-              });
-              console.log(`Created label ${LABEL}`);
-            }
-
-            // Close previous pulse issues; upsert if same week already exists
-            const prev = await github.rest.issues.listForRepo({
-              owner, repo, labels: LABEL, state: 'open', per_page: 20
-            });
-            let existingIssue = null;
-            for (const issue of prev.data) {
-              if (issue.title === title) {
-                existingIssue = issue;
-                console.log(`Found existing pulse for ${title}: #${issue.number} — will update body`);
-              } else {
-                await github.rest.issues.update({ owner, repo, issue_number: issue.number, state: 'closed' });
-                console.log(`Closed previous pulse: #${issue.number}`);
-              }
-            }
-
-            if (existingIssue) {
-              await github.rest.issues.update({ owner, repo, issue_number: existingIssue.number, body });
-              console.log(`✅ Updated pulse issue: #${existingIssue.number} — ${title}`);
-            } else {
-              const created = await github.rest.issues.create({
-                owner, repo, title, body, labels: [LABEL]
-              });
-              console.log(`✅ Created pulse issue: #${created.data.number} — ${title}`);
-            }