specweave 0.33.4 → 0.33.6

package/plugins/specweave-github/lib/github-sync-bidirectional.js

@@ -5,6 +5,11 @@ import {
   loadIncrementMetadata,
   detectRepo
 } from "./github-issue-updater.js";
+import { getGitHubAuthFromProject } from "../../../src/utils/auth-helpers.js";
+function getGhEnv() {
+  const { token } = getGitHubAuthFromProject(process.cwd());
+  return token ? { ...process.env, GH_TOKEN: token } : process.env;
+}
 async function syncFromGitHub(incrementId) {
   console.log(`
 \u{1F504} Syncing from GitHub for increment: ${incrementId}`);
@@ -47,7 +52,7 @@ async function fetchGitHubIssueState(issueNumber, owner, repo) {
     `${owner}/${repo}`,
     "--json",
     "number,title,body,state,labels,assignees,milestone,updatedAt"
-  ]);
+  ], { env: getGhEnv() });
   if (issueResult.exitCode !== 0) {
     throw new Error(`Failed to fetch issue: ${issueResult.stderr}`);
   }
@@ -57,7 +62,7 @@ async function fetchGitHubIssueState(issueNumber, owner, repo) {
     `repos/${owner}/${repo}/issues/${issueNumber}/comments`,
     "--jq",
     ".[] | {id: .id, author: .user.login, body: .body, created_at: .created_at}"
-  ]);
+  ], { env: getGhEnv() });
   let comments = [];
   if (commentsResult.exitCode === 0 && commentsResult.stdout.trim()) {
     const commentLines = commentsResult.stdout.trim().split("\n");
@@ -108,7 +113,7 @@ async function resolveStatusConflict(incrementId, metadata, githubState) {
   if (githubStatus === "closed" && specweaveStatus === "active") {
     console.log(`
 \u26A0\uFE0F  **CONFLICT**: GitHub issue closed but SpecWeave increment still active!`);
-    console.log(`   Recommendation: Run /specweave:done ${incrementId} to close increment`);
+    console.log(`   Recommendation: Run /sw:done ${incrementId} to close increment`);
     console.log(`   Or reopen issue on GitHub if work is not complete`);
   }
   if (githubStatus === "open" && specweaveStatus === "completed") {

package/plugins/specweave-github/lib/github-sync-bidirectional.ts

@@ -24,6 +24,17 @@ import {
   IncrementMetadata,
   detectRepo
 } from './github-issue-updater.js';
+import { getGitHubAuthFromProject } from '../../../src/utils/auth-helpers.js';
+
+/**
+ * Get environment object with GH_TOKEN for gh CLI commands.
+ */
+function getGhEnv(): NodeJS.ProcessEnv {
+  const { token } = getGitHubAuthFromProject(process.cwd());
+  return token
+    ? { ...process.env, GH_TOKEN: token }
+    : process.env;
+}
 
 export interface GitHubIssueState {
   number: number;
@@ -124,7 +135,7 @@ async function fetchGitHubIssueState(
     `${owner}/${repo}`,
     '--json',
     'number,title,body,state,labels,assignees,milestone,updatedAt'
-  ]);
+  ], { env: getGhEnv() });
 
   if (issueResult.exitCode !== 0) {
     throw new Error(`Failed to fetch issue: ${issueResult.stderr}`);
@@ -138,7 +149,7 @@ async function fetchGitHubIssueState(
     `repos/${owner}/${repo}/issues/${issueNumber}/comments`,
     '--jq',
     '.[] | {id: .id, author: .user.login, body: .body, created_at: .created_at}'
-  ]);
+  ], { env: getGhEnv() });
 
   let comments: GitHubComment[] = [];
   if (commentsResult.exitCode === 0 && commentsResult.stdout.trim()) {
@@ -222,7 +233,7 @@ async function resolveStatusConflict(
   // GitHub closed but SpecWeave active
   if (githubStatus === 'closed' && specweaveStatus === 'active') {
     console.log(`\n⚠️  **CONFLICT**: GitHub issue closed but SpecWeave increment still active!`);
-    console.log(`   Recommendation: Run /specweave:done ${incrementId} to close increment`);
+    console.log(`   Recommendation: Run /sw:done ${incrementId} to close increment`);
     console.log(`   Or reopen issue on GitHub if work is not complete`);
   }
 

package/plugins/specweave-github/lib/github-sync-increment-changes.js

@@ -7,6 +7,11 @@ import {
   postScopeChangeComment
 } from "./github-issue-updater.js";
 import { execFileNoThrow } from "../../../src/utils/execFileNoThrow.js";
+import { getGitHubAuthFromProject } from "../../../src/utils/auth-helpers.js";
+function getGhEnv() {
+  const { token } = getGitHubAuthFromProject(process.cwd());
+  return token ? { ...process.env, GH_TOKEN: token } : process.env;
+}
 async function syncIncrementChanges(incrementId, changedFile) {
   console.log(`
 \u{1F504} Syncing ${changedFile} changes to GitHub...`);
@@ -181,7 +186,7 @@ async function updateIssueTitle(issueNumber, title, owner, repo) {
     `${owner}/${repo}`,
     "--title",
     title
-  ]);
+  ], { env: getGhEnv() });
   if (result.exitCode !== 0) {
     console.warn(`\u26A0\uFE0F  Could not update issue title: ${result.stderr}`);
   }
@@ -197,7 +202,7 @@ async function updateIssueTaskChecklist(issueNumber, tasks, owner, repo) {
     "body",
     "-q",
     ".body"
-  ]);
+  ], { env: getGhEnv() });
   if (result.exitCode !== 0) {
     throw new Error(`Failed to get issue body: ${result.stderr}`);
   }
@@ -224,7 +229,7 @@ ${taskChecklist}
     `${owner}/${repo}`,
     "--body",
     updatedBody
-  ]);
+  ], { env: getGhEnv() });
   if (updateResult.exitCode !== 0) {
     throw new Error(`Failed to update issue body: ${updateResult.stderr}`);
   }
@@ -238,7 +243,7 @@ async function postComment(issueNumber, comment, owner, repo) {
     `${owner}/${repo}`,
     "--body",
     comment
-  ]);
+  ], { env: getGhEnv() });
   if (result.exitCode !== 0) {
     throw new Error(`Failed to post comment: ${result.stderr}`);
   }

package/plugins/specweave-github/lib/github-sync-increment-changes.ts

@@ -16,6 +16,17 @@ import {
   postScopeChangeComment
 } from './github-issue-updater.js';
 import { execFileNoThrow } from '../../../src/utils/execFileNoThrow.js';
+import { getGitHubAuthFromProject } from '../../../src/utils/auth-helpers.js';
+
+/**
+ * Get environment object with GH_TOKEN for gh CLI commands.
+ */
+function getGhEnv(): NodeJS.ProcessEnv {
+  const { token } = getGitHubAuthFromProject(process.cwd());
+  return token
+    ? { ...process.env, GH_TOKEN: token }
+    : process.env;
+}
 
 export interface SpecChanges {
   added: string[];
@@ -289,7 +300,7 @@ async function updateIssueTitle(
     `${owner}/${repo}`,
     '--title',
     title
-  ]);
+  ], { env: getGhEnv() });
 
   if (result.exitCode !== 0) {
     console.warn(`⚠️  Could not update issue title: ${result.stderr}`);
@@ -316,7 +327,7 @@ async function updateIssueTaskChecklist(
     'body',
     '-q',
     '.body'
-  ]);
+  ], { env: getGhEnv() });
 
   if (result.exitCode !== 0) {
     throw new Error(`Failed to get issue body: ${result.stderr}`);
@@ -348,7 +359,7 @@ async function updateIssueTaskChecklist(
     `${owner}/${repo}`,
     '--body',
     updatedBody
-  ]);
+  ], { env: getGhEnv() });
 
   if (updateResult.exitCode !== 0) {
     throw new Error(`Failed to update issue body: ${updateResult.stderr}`);
@@ -372,7 +383,7 @@ async function postComment(
     `${owner}/${repo}`,
     '--body',
     comment
-  ]);
+  ], { env: getGhEnv() });
 
   if (result.exitCode !== 0) {
     throw new Error(`Failed to post comment: ${result.stderr}`);

package/plugins/specweave-github/lib/increment-issue-builder.js

@@ -154,14 +154,30 @@ class IncrementIssueBuilder {
     const incrementId = incrementData.frontmatter.increment;
     const title = `[${featureId}][${story.id}] ${story.title}`;
     let body = "";
-    body += `**Feature**: ${featureId}
+    const completedACs = story.acceptanceCriteria.filter((ac) => ac.completed).length;
+    const totalACs = story.acceptanceCriteria.length;
+    const storyTasks = incrementData.tasks.filter(
+      (t) => t.userStories.includes(story.id) || t.userStories.some((us) => us.toUpperCase() === story.id.toUpperCase())
+    );
+    const completedTasks = storyTasks.filter((t) => t.completed).length;
+    const totalTasks = storyTasks.length;
+    const overallPercentage = totalACs + totalTasks > 0 ? Math.round((completedACs + completedTasks) / (totalACs + totalTasks) * 100) : 0;
+    body += `## Progress
+
 `;
-    body += `**Status**: ${incrementData.frontmatter.status || "planning"}
+    body += `**Acceptance Criteria**: ${completedACs}/${totalACs} (${totalACs > 0 ? Math.round(completedACs / totalACs * 100) : 0}%)
 `;
-    body += `**Priority**: P1
+    body += `**Tasks**: ${completedTasks}/${totalTasks} (${totalTasks > 0 ? Math.round(completedTasks / totalTasks * 100) : 0}%)
 `;
-    body += `
----
+    body += `**Overall**: ${overallPercentage}%
+
+`;
+    const filledBlocks = Math.floor(overallPercentage / 5);
+    const emptyBlocks = 20 - filledBlocks;
+    body += `${"\u2588".repeat(filledBlocks)}${"\u2591".repeat(emptyBlocks)} ${overallPercentage}%
+
+`;
+    body += `---
 
 `;
     body += `## User Story
@@ -207,15 +223,12 @@ class IncrementIssueBuilder {
     body += `---
 
 `;
-    const storyTasks = incrementData.tasks.filter(
-      (t) => t.userStories.includes(story.id) || t.userStories.some((us) => us.toUpperCase() === story.id.toUpperCase())
-    );
     if (storyTasks.length > 0) {
       body += `## Tasks
 
 `;
-      const completedTasks = storyTasks.filter((t) => t.completed).length;
-      body += `Progress: ${completedTasks}/${storyTasks.length} tasks
+      const completedTasks2 = storyTasks.filter((t) => t.completed).length;
+      body += `Progress: ${completedTasks2}/${storyTasks.length} tasks
 
 `;
       for (const task of storyTasks) {

package/plugins/specweave-github/lib/increment-issue-builder.ts

@@ -287,11 +287,34 @@ export class IncrementIssueBuilder {
     // Build body
     let body = '';
 
-    // Header with metadata
-    body += `**Feature**: ${featureId}\n`;
-    body += `**Status**: ${incrementData.frontmatter.status || 'planning'}\n`;
-    body += `**Priority**: P1\n`;
-    body += `\n---\n\n`;
+    // ❌ REMOVED: Metadata header (Feature, Status, Priority)
+    // WHY: GitHub has NATIVE fields for this (labels, milestones)
+    // Body should contain ONLY actual work content (ACs, tasks, user story)
+    // See: .specweave/docs/internal/troubleshooting/CRITICAL-remove-metadata-header-from-github-issues.md
+
+    // Progress section (consistency with user-story-issue-builder.ts)
+    const completedACs = story.acceptanceCriteria.filter(ac => ac.completed).length;
+    const totalACs = story.acceptanceCriteria.length;
+    const storyTasks = incrementData.tasks.filter(t =>
+      t.userStories.includes(story.id) ||
+      t.userStories.some(us => us.toUpperCase() === story.id.toUpperCase())
+    );
+    const completedTasks = storyTasks.filter(t => t.completed).length;
+    const totalTasks = storyTasks.length;
+    const overallPercentage = (totalACs + totalTasks) > 0
+      ? Math.round(((completedACs + completedTasks) / (totalACs + totalTasks)) * 100)
+      : 0;
+
+    body += `## Progress\n\n`;
+    body += `**Acceptance Criteria**: ${completedACs}/${totalACs} (${totalACs > 0 ? Math.round((completedACs / totalACs) * 100) : 0}%)\n`;
+    body += `**Tasks**: ${completedTasks}/${totalTasks} (${totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0}%)\n`;
+    body += `**Overall**: ${overallPercentage}%\n\n`;
+
+    // Progress bar
+    const filledBlocks = Math.floor(overallPercentage / 5);
+    const emptyBlocks = 20 - filledBlocks;
+    body += `${'█'.repeat(filledBlocks)}${'░'.repeat(emptyBlocks)} ${overallPercentage}%\n\n`;
+    body += `---\n\n`;
 
     // User Story description
     body += `## User Story\n\n`;
@@ -324,12 +347,7 @@ export class IncrementIssueBuilder {
 
     body += `---\n\n`;
 
-    // Tasks for this user story
-    const storyTasks = incrementData.tasks.filter(t =>
-      t.userStories.includes(story.id) ||
-      t.userStories.some(us => us.toUpperCase() === story.id.toUpperCase())
-    );
-
+    // Tasks for this user story (already calculated above for Progress section)
     if (storyTasks.length > 0) {
       body += `## Tasks\n\n`;
       const completedTasks = storyTasks.filter(t => t.completed).length;

package/plugins/specweave-github/lib/user-story-content-builder.js

@@ -40,25 +40,28 @@ class UserStoryContentBuilder {
   async buildIssueBody(githubRepo) {
     const content = await this.parse();
     let body = "";
-    const priority = this.extractPriorityFromACs(content.acceptanceCriteria);
     const repo = githubRepo || await this.detectGitHubRepo();
-    if (repo) {
-      const pathMatch = this.userStoryPath.match(/specs\/([^/]+)\/FS-\d+\//);
-      const projectFolder = pathMatch ? pathMatch[1] : "default";
-      body += `**Feature**: [${content.featureId}](https://github.com/${repo}/tree/develop/.specweave/docs/internal/specs/${projectFolder}/${content.featureId})
+    const completedACs = content.acceptanceCriteria.filter((ac) => ac.completed).length;
+    const totalACs = content.acceptanceCriteria.length;
+    const completedTasks = content.tasks.filter((t) => t.status).length;
+    const totalTasks = content.tasks.length;
+    const overallPercentage = totalACs + totalTasks > 0 ? Math.round((completedACs + completedTasks) / (totalACs + totalTasks) * 100) : 0;
+    body += `## Progress
+
 `;
-    } else {
-      body += `**Feature**: ${content.featureId}
+    body += `**Acceptance Criteria**: ${completedACs}/${totalACs} (${totalACs > 0 ? Math.round(completedACs / totalACs * 100) : 0}%)
 `;
-    }
-    body += `**Status**: ${content.frontmatter.status}
+    body += `**Tasks**: ${completedTasks}/${totalTasks} (${totalTasks > 0 ? Math.round(completedTasks / totalTasks * 100) : 0}%)
 `;
-    if (priority) {
-      body += `**Priority**: ${priority}
+    body += `**Overall**: ${overallPercentage}%
+
 `;
-    }
-    body += `
----
+    const filledBlocks = Math.floor(overallPercentage / 5);
+    const emptyBlocks = 20 - filledBlocks;
+    body += `${"\u2588".repeat(filledBlocks)}${"\u2591".repeat(emptyBlocks)} ${overallPercentage}%
+
+`;
+    body += `---
 
 `;
     body += `## User Story
@@ -99,9 +102,9 @@ class UserStoryContentBuilder {
 `;
       for (const ac of content.acceptanceCriteria) {
         const checkbox = ac.completed ? "[x]" : "[ ]";
-        const priority2 = ac.priority ? ` (${ac.priority})` : "";
+        const priority = ac.priority ? ` (${ac.priority})` : "";
         const testable = ac.testable ? " [testable]" : "";
-        body += `- ${checkbox} **${ac.id}**: ${ac.description}${priority2}${testable}
+        body += `- ${checkbox} **${ac.id}**: ${ac.description}${priority}${testable}
 `;
       }
       body += "\n";

package/plugins/specweave-github/lib/user-story-content-builder.ts

@@ -116,28 +116,33 @@ export class UserStoryContentBuilder {
 
     let body = '';
 
-    // Extract priority from ACs (highest priority wins)
-    const priority = this.extractPriorityFromACs(content.acceptanceCriteria);
-
     // Detect GitHub repo from git remote if not provided
     const repo = githubRepo || await this.detectGitHubRepo();
 
-    // Header with metadata
-    // v5.0.0+: Features live in project folders, NOT _features
-    // Extract project from path: specs/{project}/FS-XXX/us-*.md
-    if (repo) {
-      const pathMatch = this.userStoryPath.match(/specs\/([^/]+)\/FS-\d+\//);
-      const projectFolder = pathMatch ? pathMatch[1] : 'default';
-      body += `**Feature**: [${content.featureId}](https://github.com/${repo}/tree/develop/.specweave/docs/internal/specs/${projectFolder}/${content.featureId})\n`;
-    } else {
-      body += `**Feature**: ${content.featureId}\n`;
-    }
-    body += `**Status**: ${content.frontmatter.status}\n`;
-    if (priority) {
-      body += `**Priority**: ${priority}\n`;
-    }
-
-    body += `\n---\n\n`;
+    // ❌ REMOVED: Metadata header (Feature, Status, Priority)
+    // WHY: GitHub has NATIVE fields for this (labels, milestones)
+    // Body should contain ONLY actual work content (ACs, tasks, user story)
+    // See: .specweave/docs/internal/troubleshooting/CRITICAL-remove-metadata-header-from-github-issues.md
+
+    // Progress section (consistency with user-story-issue-builder.ts)
+    const completedACs = content.acceptanceCriteria.filter(ac => ac.completed).length;
+    const totalACs = content.acceptanceCriteria.length;
+    const completedTasks = content.tasks.filter(t => t.status).length;
+    const totalTasks = content.tasks.length;
+    const overallPercentage = (totalACs + totalTasks) > 0
+      ? Math.round(((completedACs + completedTasks) / (totalACs + totalTasks)) * 100)
+      : 0;
+
+    body += `## Progress\n\n`;
+    body += `**Acceptance Criteria**: ${completedACs}/${totalACs} (${totalACs > 0 ? Math.round((completedACs / totalACs) * 100) : 0}%)\n`;
+    body += `**Tasks**: ${completedTasks}/${totalTasks} (${totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0}%)\n`;
+    body += `**Overall**: ${overallPercentage}%\n\n`;
+
+    // Progress bar
+    const filledBlocks = Math.floor(overallPercentage / 5);
+    const emptyBlocks = 20 - filledBlocks;
+    body += `${'█'.repeat(filledBlocks)}${'░'.repeat(emptyBlocks)} ${overallPercentage}%\n\n`;
+    body += `---\n\n`;
 
     // User Story description
     body += `## User Story\n\n`;

package/plugins/specweave-github/lib/user-story-issue-builder.js

@@ -12,10 +12,10 @@ This prevents incorrect issue titles like [undefined][US-XXX] or [SP-US-XXX].
 Provide the correct Feature ID (e.g., "FS-047") when constructing this builder.`
       );
     }
-    if (!/^FS-\d{3,}$/.test(featureId)) {
+    if (!/^FS-\d{3,}E?$/.test(featureId)) {
       throw new Error(
         `UserStoryIssueBuilder: Invalid featureId format "${featureId}".
-Expected format: FS-XXX (e.g., "FS-047", "FS-123", "FS-1000").
+Expected format: FS-XXX or FS-XXXE (e.g., "FS-047", "FS-123E", "FS-1000").
 This prevents incorrect issue titles like [SP-US-XXX] or [${featureId}][US-XXX].`
       );
     }
@@ -43,11 +43,11 @@ This prevents incorrect issue titles like [SP-US-XXX] or [${featureId}][US-XXX].
     const acceptanceCriteria = this.extractAcceptanceCriteria(bodyContent);
     const tasks = await this.extractTasks(bodyContent, frontmatter.id);
     const title = `[${this.featureId}][${frontmatter.id}] ${frontmatter.title}`;
-    const titlePattern = /^\[FS-\d{3,}\]\[US-\d{3,}\] .+$/;
+    const titlePattern = /^\[FS-\d{3,}E?\]\[US-\d{3,}E?\] .+$/;
     if (!titlePattern.test(title)) {
       throw new Error(
         `Generated issue title has incorrect format: "${title}"
-Expected: [FS-XXX][US-YYY] Title (3+ digits each)
+Expected: [FS-XXX][US-YYY] or [FS-XXXE][US-YYYE] Title (3+ digits each, E-suffix for external)
 This indicates a bug in UserStoryIssueBuilder or invalid frontmatter.
 Feature ID: ${this.featureId}
 User Story ID: ${frontmatter.id}`
@@ -235,13 +235,6 @@ User Story ID: ${frontmatter.id}`
       data.acceptanceCriteria,
       data.tasks
     );
-    sections.push(`**Feature**: ${this.featureId}`);
-    sections.push(`**Status**: ${this.capitalize(data.frontmatter.status)}`);
-    sections.push(`**Priority**: ${data.frontmatter.priority || "P2"}`);
-    if (data.frontmatter.project && data.frontmatter.project !== "default") {
-      sections.push(`**Project**: ${data.frontmatter.project}`);
-    }
-    sections.push("");
     sections.push(IssueStateManager.formatProgressMarkdown(progress));
     sections.push("");
     if (data.userStoryStatement) {
@@ -356,6 +349,9 @@ User Story ID: ${frontmatter.id}`
    *
    * CRITICAL: Label names must match repository labels exactly!
    * Repository uses: status:complete, status:active, status:not_started
+   *
+   * v0.35.0: Project derived from frontmatter.project in us-*.md files.
+   * Living docs sync transforms spec.md **Project**: → us-*.md frontmatter project:
    */
   buildLabels(frontmatter) {
     const labels = ["user-story", "specweave"];
@@ -382,8 +378,9 @@ User Story ID: ${frontmatter.id}`
     if (frontmatter.priority) {
       labels.push(frontmatter.priority.toLowerCase());
     }
-    if (frontmatter.project && frontmatter.project !== "default") {
-      labels.push(`project:${frontmatter.project}`);
+    const project = frontmatter.project?.toLowerCase();
+    if (project && project !== "default") {
+      labels.push(`project:${project}`);
     }
     return labels;
   }

package/plugins/specweave-github/lib/user-story-issue-builder.ts

@@ -65,11 +65,11 @@ export class UserStoryIssueBuilder {
       );
     }
 
-    // ✅ VALIDATION: Ensure featureId matches expected pattern (FS-XXX, 3+ digits)
-    if (!/^FS-\d{3,}$/.test(featureId)) {
+    // ✅ VALIDATION: Ensure featureId matches expected pattern (FS-XXX or FS-XXXE for external)
+    if (!/^FS-\d{3,}E?$/.test(featureId)) {
       throw new Error(
         `UserStoryIssueBuilder: Invalid featureId format "${featureId}".\n` +
-        `Expected format: FS-XXX (e.g., "FS-047", "FS-123", "FS-1000").\n` +
+        `Expected format: FS-XXX or FS-XXXE (e.g., "FS-047", "FS-123E", "FS-1000").\n` +
         `This prevents incorrect issue titles like [SP-US-XXX] or [${featureId}][US-XXX].`
       );
     }
@@ -115,11 +115,11 @@ export class UserStoryIssueBuilder {
     const title = `[${this.featureId}][${frontmatter.id}] ${frontmatter.title}`;
 
     // ✅ SAFETY CHECK: Ensure title matches expected pattern (3+ digits)
-    const titlePattern = /^\[FS-\d{3,}\]\[US-\d{3,}\] .+$/;
+    const titlePattern = /^\[FS-\d{3,}E?\]\[US-\d{3,}E?\] .+$/;
     if (!titlePattern.test(title)) {
       throw new Error(
         `Generated issue title has incorrect format: "${title}"\n` +
-        `Expected: [FS-XXX][US-YYY] Title (3+ digits each)\n` +
+        `Expected: [FS-XXX][US-YYY] or [FS-XXXE][US-YYYE] Title (3+ digits each, E-suffix for external)\n` +
         `This indicates a bug in UserStoryIssueBuilder or invalid frontmatter.\n` +
         `Feature ID: ${this.featureId}\n` +
         `User Story ID: ${frontmatter.id}`
@@ -135,7 +135,7 @@ export class UserStoryIssueBuilder {
       bodyContent
     });
 
-    // 5. Determine labels
+    // 5. Determine labels (v0.35.0: project from frontmatter, not body)
     const labels = this.buildLabels(frontmatter);
 
     return {
@@ -397,17 +397,12 @@ export class UserStoryIssueBuilder {
       data.tasks
     );
 
-    // Header with metadata
-    sections.push(`**Feature**: ${this.featureId}`);
-    sections.push(`**Status**: ${this.capitalize(data.frontmatter.status)}`);
-    sections.push(`**Priority**: ${data.frontmatter.priority || 'P2'}`);
-    // ✅ FIX: Only output Project if defined and not "default"
-    if (data.frontmatter.project && data.frontmatter.project !== 'default') {
-      sections.push(`**Project**: ${data.frontmatter.project}`);
-    }
-    sections.push('');
+    // ❌ REMOVED: Metadata header (Feature, Status, Priority, Project)
+    // WHY: GitHub has NATIVE fields for this (labels, milestones)
+    // Body should contain ONLY actual work content (ACs, tasks, user story)
+    // See: .specweave/docs/internal/troubleshooting/CRITICAL-remove-metadata-header-from-github-issues.md
 
-    // Progress section (NEW)
+    // Progress section
     sections.push(IssueStateManager.formatProgressMarkdown(progress));
     sections.push('');
 
@@ -568,6 +563,9 @@ export class UserStoryIssueBuilder {
    *
    * CRITICAL: Label names must match repository labels exactly!
    * Repository uses: status:complete, status:active, status:not_started
+   *
+   * v0.35.0: Project derived from frontmatter.project in us-*.md files.
+   * Living docs sync transforms spec.md **Project**: → us-*.md frontmatter project:
    */
   private buildLabels(frontmatter: UserStoryFrontmatter): string[] {
     const labels: string[] = ['user-story', 'specweave'];
@@ -607,9 +605,12 @@ export class UserStoryIssueBuilder {
       labels.push(frontmatter.priority.toLowerCase());
     }
 
-    // Add project label
-    if (frontmatter.project && frontmatter.project !== 'default') {
-      labels.push(`project:${frontmatter.project}`);
+    // Add project label (v0.35.0: extract from frontmatter.project in us-*.md files)
+    // Living docs sync transforms spec.md **Project**: → us-*.md frontmatter project:
+    // See CLAUDE.md "Two File Formats for Project Field" for architecture
+    const project = frontmatter.project?.toLowerCase();
+    if (project && project !== 'default') {
+      labels.push(`project:${project}`);
     }
 
     return labels;

package/plugins/specweave-github/reference/github-specweave-mapping.md

@@ -295,7 +295,7 @@ Body: We need OAuth2 authentication with Google and GitHub providers...
 
 ### Example 3: Close Increment → Close Issue
 
-**SpecWeave**: `/specweave:done 0004` (all 48 tasks complete)
+**SpecWeave**: `/sw:done 0004` (all 48 tasks complete)
 
 **GitHub**: Close issue #130 with comment:
 ```markdown

package/plugins/specweave-github/skills/github-issue-standard/SKILL.md

@@ -190,9 +190,9 @@ All GitHub issue content is generated by these builders:
 
 All GitHub sync commands use the Universal Hierarchy:
 
-- `/specweave-github:sync` - Sync increments via Feature/UserStory hierarchy
-- `/specweave-github:create-issue` - Create issue using standard format
-- `/specweave-github:update-user-story` - Update user story issue
+- `/sw-github:sync` - Sync increments via Feature/UserStory hierarchy
+- `/sw-github:create-issue` - Create issue using standard format
+- `/sw-github:update-user-story` - Update user story issue
 
 ## Validation Checklist
 

package/plugins/specweave-github/skills/github-issue-tracker/SKILL.md

@@ -14,7 +14,7 @@ description: Task-level GitHub issue tracking for SpecWeave increments. Provides
 - Blocking issue tracking
 - Task-level comments and discussions
 
-**Integration**: Works with `github-sync` skill and `/specweave:github:*` commands
+**Integration**: Works with `github-sync` skill and `/sw:github:*` commands
 
 ---
 
@@ -171,7 +171,7 @@ plugins:
 ### Check Task Status
 
 ```bash
-/specweave:github:status 0004
+/sw:github:status 0004
 ```
 
 Output:
@@ -196,7 +196,7 @@ Week 1: Foundation
 ### Sync Task Checklist
 
 ```bash
-/specweave:github:sync 0004 --tasks
+/sw:github:sync 0004 --tasks
 ```
 
 Updates GitHub issue checklist to match current increment progress.
@@ -204,7 +204,7 @@ Updates GitHub issue checklist to match current increment progress.
 ### Comment on Task
 
 ```bash
-/specweave:github:comment 0004 T-008 "Cursor adapter completed, moving to testing phase"
+/sw:github:comment 0004 T-008 "Cursor adapter completed, moving to testing phase"
 ```
 
 Posts custom comment to GitHub issue for specific task.
@@ -308,7 +308,7 @@ tasks:
 Generate time reports:
 
 ```bash
-/specweave:github:time-report 0004
+/sw:github:time-report 0004
 ```
 
 Output:
@@ -458,7 +458,7 @@ Warn when tasks are behind schedule:
 **Checklist not updating?**
 - Verify `update_checklist: true` in config
 - Check GitHub API permissions (repo write access)
-- Manually sync: `/specweave:github:sync 0004 --tasks`
+- Manually sync: `/sw:github:sync 0004 --tasks`
 
 **Comments not posting?**
 - Check `post_task_comments: true`
@@ -468,7 +468,7 @@ Warn when tasks are behind schedule:
 **Time tracking inaccurate?**
 - Verify task timestamps in `.metadata.yaml`
 - Check for manual edits to metadata
-- Re-sync: `/specweave:github:sync 0004 --force`
+- Re-sync: `/sw:github:sync 0004 --force`
 
 ---
 
@@ -488,7 +488,7 @@ Warn when tasks are behind schedule:
 
 - **github-sync**: High-level increment ↔ issue synchronization
 - **github-manager agent**: AI agent for GitHub operations
-- **Commands**: All `/specweave:github:*` commands
+- **Commands**: All `/sw:github:*` commands
 
 ---