@ngocsangairvds/vsaf 4.1.8 → 4.1.10

package/skills/vds-skill/create-bitbucket-pr/scripts/create-pr.js

@@ -1,125 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const { execFileSync } = require('child_process');
-const { existsSync, readdirSync } = require('fs');
-const { join } = require('path');
-// NOTE: path matches DEPLOYED location (.claude/skills/_shared/vds-skill/), not source repo
-const { loadCredentials, ensureEnv, requireCommand } = require('../../_shared/vds-skill/credentials.js');
-
-let dryRun = false;
-let targetBranch = 'master';
-let descFile = '';
-let title = '';
-
-const args = process.argv.slice(2);
-for (let i = 0; i < args.length; i++) {
-  switch (args[i]) {
-    case '--dry-run': dryRun = true; break;
-    case '--target': targetBranch = args[++i]; break;
-    case '--description-file': descFile = args[++i]; break;
-    case '--title': title = args[++i]; break;
-    default:
-      process.stderr.write(`Unknown arg: ${args[i]}\n`);
-      process.exit(2);
-  }
-}
-
-let remoteUrl;
-try {
-  remoteUrl = execFileSync('git', ['remote', 'get-url', 'origin'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
-} catch {
-  process.stderr.write('ERROR: No git remote \'origin\' configured\n');
-  process.exit(1);
-}
-
-if (!remoteUrl.includes('bitbucket.digital.vn')) {
-  process.stderr.write(`WARNING: Remote URL does not match bitbucket.digital.vn pattern:\n  ${remoteUrl}\n`);
-  process.stderr.write('  This skill is for Viettel Bitbucket. For GitHub, use \'gh pr create\'.\n');
-  process.exit(1);
-}
-
-const scmMatch = remoteUrl.match(/\/scm\/([^/]+)\/([^/]+?)(?:\.git)?$/);
-const sshMatch = remoteUrl.match(/\/([^/]+)\/([^/]+?)(?:\.git)?$/);
-const match = scmMatch || sshMatch;
-
-if (!match) {
-  process.stderr.write(`ERROR: Cannot parse PROJECT/REPO from remote URL: ${remoteUrl}\n`);
-  process.exit(1);
-}
-
-const project = match[1];
-const repo = match[2];
-
-let sourceBranch;
-try {
-  sourceBranch = execFileSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
-} catch {
-  process.stderr.write('ERROR: Cannot determine current branch\n');
-  process.exit(1);
-}
-
-if (!sourceBranch || sourceBranch === 'HEAD') {
-  process.stderr.write('ERROR: Not on a named branch\n');
-  process.exit(1);
-}
-
-if (!title) {
-  try {
-    title = execFileSync('git', ['log', '-1', '--pretty=%s'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
-  } catch { title = sourceBranch; }
-}
-
-if (!descFile) {
-  const searchPaths = [
-    { dir: join('.vsaf', 'docs', 'features'), file: '09-ship.md' },
-    { dir: join('.vsaf', 'docs', 'hotfixes'), file: '03-ship.md' },
-  ];
-  for (const { dir, file } of searchPaths) {
-    if (existsSync(dir)) {
-      for (const subdir of readdirSync(dir)) {
-        const candidate = join(dir, subdir, file);
-        if (existsSync(candidate)) { descFile = candidate; break; }
-      }
-    }
-    if (descFile) break;
-  }
-}
-
-const cmdArgs = ['bitbucket', 'pr', 'create', `${project}/${repo}`,
-  '--source', sourceBranch, '--target', targetBranch, '--title', title];
-if (descFile && existsSync(descFile)) cmdArgs.push('--description-file', descFile);
-
-if (dryRun) {
-  console.log('DRY-RUN — would execute:');
-  console.log(`  vds-cli ${cmdArgs.join(' ')} --yes --json-only`);
-  process.exit(0);
-}
-
-loadCredentials();
-
-const cmdCheck = requireCommand('vds-cli');
-if (!cmdCheck.found) {
-  process.stderr.write('ERROR: vds-cli not found in PATH\n');
-  if (cmdCheck.broken) process.stderr.write(`NOTE: ${cmdCheck.path} exists but fails to run\n`);
-  process.exit(127);
-}
-
-(async () => {
-  if (!await ensureEnv('BITBUCKET_TOKEN', 'Enter Bitbucket personal access token')) process.exit(1);
-
-  console.log('About to create PR:');
-  console.log(`  Project/Repo: ${project}/${repo}`);
-  console.log(`  Source:       ${sourceBranch}`);
-  console.log(`  Target:       ${targetBranch}`);
-  console.log(`  Title:        ${title}`);
-  console.log(`  Description:  ${descFile || '<empty>'}`);
-  console.log('');
-
-  try {
-    execFileSync('vds-cli', [...cmdArgs, '--yes', '--json-only'], { stdio: 'inherit' });
-  } catch (err) {
-    process.stderr.write(`ERROR: vds-cli failed: ${err.message}\n`);
-    process.exit(1);
-  }
-})();

package/skills/vds-skill/create-jira-epic/SKILL.md

@@ -1,55 +0,0 @@
----
-name: vds-skill-create-jira-epic
-description: Create a Jira Epic via `vds-cli jira create --issuetype Epic` from a PRD file. Use after /sdlc-prd has produced 02-prd.md. Auto-detects PRD location, lazy-prompts credentials. Viettel-only (requires vds-cli).
----
-
-# /vds-skill-create-jira-epic
-
-Create a Jira Epic on Viettel Jira based on a PRD markdown file.
-
-## Config Check (run FIRST)
-
-Before doing anything, run this check via Bash tool:
-
-```bash
-node .claude/skills/_shared/vds-skill/config-check.js --cmd vds-cli --env JIRA_TOKEN,VDS_JIRA_PROJECT_DEFAULT
-```
-
-If BLOCKED: tell the user exactly what's missing and how to fix, then STOP. Do NOT fabricate output. `--dry-run` mode skips credential + vds-cli checks.
-
-## Prerequisites
-
-- `vds-cli` installed (for non-dry-run)
-- A PRD file exists at `.vsaf/docs/features/{feature}/02-prd.md`
-- `JIRA_TOKEN` + `VDS_JIRA_PROJECT_DEFAULT` in `~/.vds/.env`
-
-## Usage
-
-```bash
-/vds-skill-create-jira-epic                                  # auto-detect latest PRD
-/vds-skill-create-jira-epic --feature user-management        # specific feature folder
-/vds-skill-create-jira-epic --project NTTC                   # override project key
-/vds-skill-create-jira-epic --dry-run                        # preview
-/vds-skill-create-jira-epic --description-file path/to.md    # custom description source
-```
-
-## Behavior
-
-1. Locate PRD file (or use `--description-file`)
-2. Extract summary from PRD's first H1 heading
-3. Lazy-prompt `JIRA_TOKEN` + `VDS_JIRA_PROJECT_DEFAULT` if missing
-4. Confirm with user
-5. Run `vds-cli jira create --project KEY --issuetype Epic --summary ... --description-file ... --yes --json-only`
-6. Save returned epic key to `<feature-dir>/jira-epic-key.txt`
-
-## Implementation
-
-```bash
-node .claude/skills/vds-skill-create-jira-epic/scripts/create-epic.js "$@"
-```
-
-## Notes
-
-- Dry-run prints constructed `vds-cli` command without executing
-- Dry-run skips `vds-cli` availability check — works on machines without vds-cli installed
-- Epic key written to `<feature-dir>/jira-epic-key.txt` for later cross-reference

package/skills/vds-skill/create-jira-epic/scripts/create-epic.js

@@ -1,120 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const { execFileSync } = require('child_process');
-const { existsSync, readFileSync, writeFileSync, readdirSync, statSync } = require('fs');
-const { join, dirname, basename } = require('path');
-// NOTE: path matches DEPLOYED location (.claude/skills/_shared/vds-skill/), not source repo
-const { loadCredentials, ensureEnv, requireCommand } = require('../../_shared/vds-skill/credentials.js');
-
-let dryRun = false;
-let projectKey = '';
-let descFile = '';
-let featureName = '';
-
-const args = process.argv.slice(2);
-for (let i = 0; i < args.length; i++) {
-  switch (args[i]) {
-    case '--dry-run': dryRun = true; break;
-    case '--project': projectKey = args[++i]; break;
-    case '--description-file': descFile = args[++i]; break;
-    case '--feature': featureName = args[++i]; break;
-    default:
-      process.stderr.write(`Unknown arg: ${args[i]}\n`);
-      process.exit(2);
-  }
-}
-
-if (!descFile) {
-  if (featureName) {
-    const candidate = join('.vsaf', 'docs', 'features', featureName, '02-prd.md');
-    if (existsSync(candidate)) descFile = candidate;
-  }
-  if (!descFile) {
-    const featuresDir = join('.vsaf', 'docs', 'features');
-    if (existsSync(featuresDir)) {
-      let newest = null;
-      let newestMtime = 0;
-      for (const dir of readdirSync(featuresDir)) {
-        const prd = join(featuresDir, dir, '02-prd.md');
-        if (existsSync(prd)) {
-          const mtime = statSync(prd).mtimeMs;
-          if (mtime > newestMtime) { newest = prd; newestMtime = mtime; }
-        }
-      }
-      if (newest) descFile = newest;
-    }
-  }
-}
-
-if (!descFile || !existsSync(descFile)) {
-  process.stderr.write('ERROR: PRD file not found. Run /sdlc-prd first or specify --description-file\n');
-  process.exit(1);
-}
-
-if (!featureName) featureName = basename(dirname(descFile));
-
-const prdContent = readFileSync(descFile, 'utf-8');
-const h1Match = prdContent.match(/^# (.+)/m);
-const summary = h1Match ? h1Match[1].trim() : featureName;
-
-if (dryRun) {
-  loadCredentials();
-  const displayProject = projectKey || process.env.VDS_JIRA_PROJECT_DEFAULT || '<VDS_JIRA_PROJECT_DEFAULT>';
-  console.log('DRY-RUN — would execute:');
-  console.log(`  vds-cli jira create --project ${displayProject} --issuetype Epic --summary "${summary}" --description-file ${descFile} --yes --json-only`);
-  process.exit(0);
-}
-
-loadCredentials();
-
-const cmdCheck = requireCommand('vds-cli');
-if (!cmdCheck.found) {
-  process.stderr.write('ERROR: vds-cli not found in PATH\n');
-  if (cmdCheck.broken) process.stderr.write(`NOTE: ${cmdCheck.path} exists but fails to run\n`);
-  process.exit(127);
-}
-
-(async () => {
-  if (!await ensureEnv('JIRA_TOKEN', 'Enter Jira personal access token')) process.exit(1);
-  if (!await ensureEnv('VDS_JIRA_PROJECT_DEFAULT', 'Enter default Jira project key (e.g. NTTC)', false)) process.exit(1);
-
-  projectKey = projectKey || process.env.VDS_JIRA_PROJECT_DEFAULT;
-
-  console.log('About to create Jira Epic:');
-  console.log(`  Project:      ${projectKey}`);
-  console.log(`  Summary:      ${summary}`);
-  console.log(`  Description:  ${descFile}`);
-  console.log(`  Feature:      ${featureName}`);
-  console.log('');
-
-  const cmdArgs = ['jira', 'create', '--project', projectKey, '--issuetype', 'Epic',
-    '--summary', summary, '--description-file', descFile, '--yes', '--json-only'];
-
-  let result;
-  try {
-    result = execFileSync('vds-cli', cmdArgs, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
-  } catch (err) {
-    process.stderr.write(`ERROR: vds-cli failed: ${err.stderr || err.message}\n`);
-    process.exit(1);
-  }
-
-  let epicKey;
-  try {
-    const parsed = JSON.parse(result);
-    epicKey = parsed.key || '';
-  } catch {
-    process.stderr.write(`ERROR: Failed to parse vds-cli response\nResponse: ${result}\n`);
-    process.exit(1);
-  }
-
-  if (!epicKey) {
-    process.stderr.write(`ERROR: No epic key in response\nResponse: ${result}\n`);
-    process.exit(1);
-  }
-
-  const epicKeyFile = join(dirname(descFile), 'jira-epic-key.txt');
-  writeFileSync(epicKeyFile, epicKey + '\n');
-  console.log(`Created Jira Epic: ${epicKey}`);
-  console.log(`  Saved key to: ${epicKeyFile}`);
-})();

package/skills/vds-skill/pull/SKILL.md

@@ -1,38 +0,0 @@
----
-name: vds-skill-pull
-description: Pull latest code via `git pull` then detect stale local knowledge index (`.gitnexus/`, `graphify-out/graph.json`) by comparing mtime with `.git/FETCH_HEAD`. Suggest `/sdlc-onboard-code` if stale. Use instead of bare `git pull` for projects using SDLC pack.
----
-
-# /vds-skill-pull
-
-Wrapper for `git pull` that detects stale local knowledge index after pull and suggests rebuild.
-
-## Usage
-
-```bash
-/vds-skill-pull              # equivalent to `git pull`
-/vds-skill-pull --rebase     # forwards args to git pull
-/vds-skill-pull origin main  # also forwards
-```
-
-## Behavior
-
-1. Run `git pull` with all passed args
-2. If pull succeeds, check `.gitnexus/` and `graphify-out/graph.json` mtime vs `.git/FETCH_HEAD`
-3. If any stale → print suggestion to run `/sdlc-onboard-code`
-4. Exit 0 (advisory, does not block workflow)
-
-## Implementation
-
-Invoke the bundled script:
-
-```bash
-node .claude/skills/vds-skill-pull/scripts/pull.js "$@"
-```
-
-## Notes
-
-- Works for both Viettel and non-Viettel projects (no vds-cli dependency).
-- If `.gitnexus/` or `graphify-out/` does not exist, that's OK — only flagged if present-but-stale.
-- Skill exits 0 even when knowledge is stale (advisory only — user decides whether to onboard now or later).
-- `.gitnexus/` staleness uses directory mtime — this catches new files but may miss in-place edits. If GitNexus rewrites files without re-creating them, the check could give a false "fresh" reading. Acceptable for advisory mode.

package/skills/vds-skill/pull/scripts/pull.js

@@ -1,59 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-/**
- * vds-skill-pull: git pull + detect stale local knowledge index.
- * Usage: node pull.js [...git pull args]
- * Exit: forwards git pull exit code. Advisory stale warnings never block.
- */
-
-const { execSync } = require('child_process');
-const { existsSync, statSync } = require('fs');
-
-const args = process.argv.slice(2);
-
-// Forward git pull with all args, inherit I/O
-let exitCode = 0;
-try {
-  execSync(`git pull ${args.map(a => JSON.stringify(a)).join(' ')}`, { stdio: 'inherit' });
-} catch (err) {
-  exitCode = err.status || 1;
-  process.exit(exitCode);
-}
-
-// Skip stale check if FETCH_HEAD doesn't exist
-if (!existsSync('.git/FETCH_HEAD')) {
-  process.exit(0);
-}
-
-const fetchMtime = statSync('.git/FETCH_HEAD').mtimeMs;
-const staleReasons = [];
-
-// Check .gitnexus/
-if (existsSync('.gitnexus')) {
-  const gnMtime = statSync('.gitnexus').mtimeMs;
-  if (gnMtime < fetchMtime) {
-    staleReasons.push('.gitnexus/ index older than fetched commits');
-  }
-}
-
-// Check graphify-out/graph.json
-if (existsSync('graphify-out/graph.json')) {
-  const gMtime = statSync('graphify-out/graph.json').mtimeMs;
-  if (gMtime < fetchMtime) {
-    staleReasons.push('graphify-out/graph.json older than fetched commits');
-  }
-}
-
-if (staleReasons.length > 0) {
-  console.log('');
-  console.log('  Knowledge index may be stale after pull:');
-  for (const reason of staleReasons) {
-    console.log(`   - ${reason}`);
-  }
-  console.log('');
-  console.log('   Recommend: run /sdlc-onboard-code to rebuild GitNexus + Graphify locally.');
-  console.log('');
-}
-
-process.exit(0);

package/skills/vds-skill/push-prd/SKILL.md

@@ -1,227 +0,0 @@
----
-name: vds-skill-push-prd
-description: Push PRD markdown to Viettel Confluence via vds-cli. Converts markdown → Confluence Storage Format (XHTML), searches for existing page, creates or updates. Use after /sdlc-prd has produced 02-prd.md. Viettel-only (requires vds-cli).
----
-
-# /vds-skill-push-prd
-
-Publish the current PRD to Viettel Confluence via `vds-cli` — create a new page if it doesn't exist, or update the existing one. The optional `[comment]` becomes the Confluence version note.
-
-## Input
-
-- `[file]` — optional path to a specific markdown file. Default: scan `.vsaf/docs/features/*/02-prd.md`
-- `[comment]` — optional version note (e.g., "Initial draft", "Updated after stakeholder review")
-
-## Config Check (run FIRST)
-
-Before doing anything, run this check via Bash tool:
-
-```bash
-node .claude/skills/_shared/vds-skill/config-check.js --cmd vds-cli --env INTERNAL_CONFLUENCE_TOKEN,VDS_CONFLUENCE_SPACE_DEFAULT
-```
-
-If BLOCKED: tell the user exactly what's missing and how to fix, then STOP. Do NOT fabricate output.
-
-## Prerequisites
-
-- `vds-cli` installed
-- A PRD markdown file must exist
-- `INTERNAL_CONFLUENCE_TOKEN` + `VDS_CONFLUENCE_SPACE_DEFAULT` in `~/.vds/.env`
-- Confluence parent page configured in `.vsaf/config.yaml` (or lazy-prompted)
-
-## Steps
-
-### Step 1 — Find PRD file
-
-- If `[file]` given: use directly
-- Otherwise: list `.vsaf/docs/features/*/02-prd.md`
-  - Multiple: ask user which one
-  - None: STOP — tell user to run `/sdlc-prd` first
-- Read full file content
-
-### Step 2 — Load Confluence config
-
-Read `.vsaf/config.yaml` (or `.vsaf/_bmad/bmm/config.yaml`) and extract:
-- `confluence_space_key`
-- `confluence_parent_page`
-
-If missing: lazy-prompt + persist via `_shared/credentials.js ensureEnv`.
-
-### Step 3 — Determine page title
-
-- For `02-prd.md` under `features/{feature-name}/`: title = `[PRD] {Feature Name}` (derived from folder name)
-- Otherwise: use first `# Heading` in file, or filename stem
-
-### Step 4 — Convert markdown → Confluence storage format (XHTML)
-
-**CRITICAL RULES:**
-
-1. **Never send raw markdown.** All content must be converted to Confluence Storage Format (XHTML).
-2. **Never wrap entire body in `<![CDATA[...]]>`.** CDATA is ONLY valid inside `<ac:plain-text-body>` within code macros.
-3. **All Confluence macro attributes MUST use `ac:` namespace prefix.** The tag is `<ac:parameter ac:name="...">`, never `<parameter name="...">`.
-4. **Escape HTML entities in regular text:** `&` → `&amp;`, `<` → `&lt;`, `>` → `&gt;`.
-5. **Every opened tag must be closed.** Confluence XML parser is strict.
-
-**Block elements:**
-
-```
-# Heading      → <h1>Heading</h1>
-## Heading     → <h2>Heading</h2>
-### Heading    → <h3>Heading</h3>
-#### Heading   → <h4>Heading</h4>
-paragraph      → <p>paragraph</p>
----            → <hr/>
-```
-
-**Inline elements:**
-
-```
-**bold**       → <strong>bold</strong>
-*italic*       → <em>italic</em>
-`code`         → <code>code</code>
-[text](url)    → <a href="url">text</a>
-```
-
-**Lists:**
-
-```
-- item         → <ul><li>item</li></ul>
-1. item        → <ol><li>item</li></ol>
-```
-
-**Tables:**
-
-```
-| H1 | H2 |   →  <table><tbody>
-|----|----|         <tr><th>H1</th><th>H2</th></tr>
-| a  | b  |          <tr><td>a</td><td>b</td></tr>
-                </tbody></table>
-```
-
-**Code blocks (ONLY place for CDATA):**
-
-```
-```lang        →  <ac:structured-macro ac:name="code">
-code here           <ac:parameter ac:name="language">lang</ac:parameter>
-```                 <ac:plain-text-body><![CDATA[code here]]></ac:plain-text-body>
-                  </ac:structured-macro>
-```
-
-**Info/warning/tip boxes:**
-
-```
-> [!NOTE]      →  <ac:structured-macro ac:name="info">
-> body              <ac:parameter ac:name="title">title</ac:parameter>
-                    <ac:rich-text-body><p>body</p></ac:rich-text-body>
-                  </ac:structured-macro>
-
-> [!WARNING]   →  ac:name="warning"
-> [!TIP]       →  ac:name="tip"
-```
-
-**Blockquote:**
-
-```
-> text         → <blockquote><p>text</p></blockquote>
-```
-
-Save converted XHTML to a temp file: `BODY_FILE=$(mktemp --suffix=.html)`.
-
-### Step 5 — Search for existing page
-
-Use Bash tool to run:
-
-```bash
-SPACE_KEY="<from config>"
-PAGE_TITLE="<title from Step 3>"
-
-SEARCH_RESULT=$(vds-cli confluence search \
-    --cql "space=$SPACE_KEY AND title = \"$PAGE_TITLE\"" \
-    --limit 1 --json-only)
-
-EXISTING_PAGE_ID=$(node -e \
-    "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')); process.stdout.write(d.results?.[0]?.id ?? '');" \
-    <<< "$SEARCH_RESULT")
-```
-
-If `$EXISTING_PAGE_ID` non-empty → Step 6 (update). Otherwise → Step 7 (create).
-
-### Step 6 — Update existing page (via vds-cli)
-
-```bash
-EXISTING_VERSION=$(node -e \
-    "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')); process.stdout.write(String(d.results?.[0]?.version?.number ?? 1));" \
-    <<< "$SEARCH_RESULT")
-
-VERSION_COMMENT="${COMMENT:-Updated via vds-skill-push-prd}"
-
-vds-cli confluence content update \
-    --page-id "$EXISTING_PAGE_ID" \
-    --body-file "$BODY_FILE" \
-    --version $((EXISTING_VERSION + 1)) \
-    --version-comment "$VERSION_COMMENT" \
-    --json-only
-
-rm -f "$BODY_FILE"
-```
-
-**Conflict handling:** if `vds-cli` returns version mismatch error, retry once with fresh version:
-
-```bash
-LATEST_VERSION=$(vds-cli confluence content page "$EXISTING_PAGE_ID" --json-only \
-    | node -e "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')); process.stdout.write(String(d.version.number));")
-
-vds-cli confluence content update \
-    --page-id "$EXISTING_PAGE_ID" \
-    --body-file "$BODY_FILE" \
-    --version $((LATEST_VERSION + 1)) \
-    --version-comment "$VERSION_COMMENT" \
-    --json-only
-```
-
-### Step 7 — Create new page (via vds-cli)
-
-```bash
-# Resolve parent page ID via search
-PARENT_ID=""
-if [[ -n "$CONFLUENCE_PARENT_PAGE" ]]; then
-    PARENT_ID=$(vds-cli confluence search \
-        --cql "space=$SPACE_KEY AND title = \"$CONFLUENCE_PARENT_PAGE\"" \
-        --limit 1 --json-only \
-        | node -e "const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')); process.stdout.write(d.results?.[0]?.id ?? '');")
-fi
-
-CREATE_ARGS=(vds-cli confluence content create-page
-    --space "$SPACE_KEY"
-    --title "$PAGE_TITLE"
-    --body-file "$BODY_FILE"
-    --version-comment "${COMMENT:-Initial PRD push via vds-skill-push-prd}"
-    --json-only)
-[[ -n "$PARENT_ID" ]] && CREATE_ARGS+=(--parent-id "$PARENT_ID")
-
-"${CREATE_ARGS[@]}"
-rm -f "$BODY_FILE"
-```
-
-### Step 8 — Output to user
-
-```
-## PRD pushed to Confluence
-
-- Page:    {page_title}
-- Action:  [Created / Updated]
-- Space:   {space_key}
-- Comment: {comment}
-- URL:     {confluence_page_url}
-
-## Next step
-Optionally run /vds-skill-create-jira-epic to create a Jira epic from this PRD,
-or continue with /sdlc-architecture (Phase 3).
-```
-
-## Notes
-
-- Never push a PRD that has failed validation
-- If `vds-cli` is not installed, tell user to install vds-scripts first
-- Do not modify the local file during this step
-- Conflict handling: version mismatch → auto-retry once with fresh version number