@bradygaster/squad-sdk 0.8.19 → 0.8.21

package/dist/config/init.d.ts

@@ -7,6 +7,7 @@
  *
  * @module config/init
  */
+import type { WorkstreamDefinition } from '../streams/types.js';
 /**
  * Get the SDK templates directory path.
  */
@@ -34,15 +35,15 @@ export interface InitOptions {
     projectDescription?: string;
     /** Agents to create */
     agents: InitAgentSpec[];
-    /** Config format (typescript or json) */
-    configFormat?: 'typescript' | 'json';
+    /** Config format (typescript or json for old format, sdk for new builder syntax, markdown for no config file) */
+    configFormat?: 'typescript' | 'json' | 'sdk' | 'markdown';
     /** User name for initial history entries */
     userName?: string;
     /** Skip files that already exist (default: true) */
     skipExisting?: boolean;
     /** Include GitHub workflows (default: true) */
     includeWorkflows?: boolean;
-    /** Include .squad-templates/ copy (default: true) */
+    /** Include .squad/templates/ copy (default: true) */
     includeTemplates?: boolean;
     /** Include sample MCP config (default: true) */
     includeMcpConfig?: boolean;
@@ -54,6 +55,8 @@ export interface InitOptions {
     prompt?: string;
     /** If true, disable extraction from consult sessions (read-only consultations) */
     extractionDisabled?: boolean;
+    /** Optional workstream definitions — generates .squad/workstreams.json when provided */
+    streams?: WorkstreamDefinition[];
 }
 /**
  * Initialization result.
@@ -72,25 +75,6 @@ export interface InitResult {
     /** Path to .squad/ directory */
     squadDir: string;
 }
-/**
- * Initialize a new Squad project.
- *
- * Creates:
- * - .squad/ directory structure (agents, casting, decisions, skills, identity, etc.)
- * - squad.config.ts or squad.config.json
- * - Agent directories with charter.md and history.md
- * - .gitattributes for merge drivers
- * - .gitignore entries for logs
- * - .github/agents/squad.agent.md
- * - .github/workflows/ (optional)
- * - .squad-templates/ (optional)
- * - .copilot/mcp-config.json (optional)
- * - Identity files (now.md, wisdom.md)
- * - ceremonies.md
- *
- * @param options - Initialization options
- * @returns Result with created file paths
- */
 export declare function initSquad(options: InitOptions): Promise<InitResult>;
 /**
  * Clean up orphan .init-prompt file.

package/dist/config/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/config/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAiBlD;AA0BD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB;IACvB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,yCAAyC;IACzC,YAAY,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IACrC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAChF,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mDAAmD;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAoSD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAkbzE;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7E"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/config/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAMhE;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAiBlD;AA0BD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB;IACvB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,iHAAiH;IACjH,YAAY,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;IAC1D,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAChF,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,wFAAwF;IACxF,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mDAAmD;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AA6WD,wBAAsB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA+dzE;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7E"}

package/dist/config/init.js

@@ -93,82 +93,82 @@ function formatModelArray(chain) {
  */
 function generateTypeScriptConfig(options) {
     const { projectName, projectDescription, agents } = options;
-    return `import type { SquadConfig } from '@bradygaster/squad';
-
-/**
- * Squad Configuration for ${projectName}
- * ${projectDescription ? `\n * ${projectDescription}` : ''}
- */
-const config: SquadConfig = {
-  version: '1.0.0',
-  
-  models: {
-    defaultModel: '${MODELS.DEFAULT}',
-    defaultTier: 'standard',
-    fallbackChains: {
-      premium: ${formatModelArray(MODELS.FALLBACK_CHAINS.premium)},
-      standard: ${formatModelArray(MODELS.FALLBACK_CHAINS.standard)},
-      fast: ${formatModelArray(MODELS.FALLBACK_CHAINS.fast)}
-    },
-    preferSameProvider: true,
-    respectTierCeiling: true,
-    nuclearFallback: {
-      enabled: false,
-      model: '${MODELS.NUCLEAR_FALLBACK}',
-      maxRetriesBeforeNuclear: ${MODELS.NUCLEAR_MAX_RETRIES}
-    }
-  },
-  
-  routing: {
-    rules: [
-      {
-        workType: 'feature-dev',
-        agents: ['@${agents[0]?.name || 'coordinator'}'],
-        confidence: 'high'
-      },
-      {
-        workType: 'bug-fix',
-        agents: ['@${agents.find(a => a.role === 'developer')?.name || agents[0]?.name || 'coordinator'}'],
-        confidence: 'high'
-      },
-      {
-        workType: 'testing',
-        agents: ['@${agents.find(a => a.role === 'tester')?.name || agents[0]?.name || 'coordinator'}'],
-        confidence: 'high'
-      },
-      {
-        workType: 'documentation',
-        agents: ['@${agents.find(a => a.role === 'scribe')?.name || agents[0]?.name || 'coordinator'}'],
-        confidence: 'high'
-      }
-    ],
-    governance: {
-      eagerByDefault: true,
-      scribeAutoRuns: false,
-      allowRecursiveSpawn: false
-    }
-  },
-  
-  casting: {
-    allowlistUniverses: [
-      'The Usual Suspects',
-      'Breaking Bad',
-      'The Wire',
-      'Firefly'
-    ],
-    overflowStrategy: 'generic',
-    universeCapacity: {}
-  },
-  
-  platforms: {
-    vscode: {
-      disableModelSelection: false,
-      scribeMode: 'sync'
-    }
-  }
-};
-
-export default config;
+    return `import type { SquadConfig } from '@bradygaster/squad';
+
+/**
+ * Squad Configuration for ${projectName}
+ * ${projectDescription ? `\n * ${projectDescription}` : ''}
+ */
+const config: SquadConfig = {
+  version: '1.0.0',
+  
+  models: {
+    defaultModel: '${MODELS.DEFAULT}',
+    defaultTier: 'standard',
+    fallbackChains: {
+      premium: ${formatModelArray(MODELS.FALLBACK_CHAINS.premium)},
+      standard: ${formatModelArray(MODELS.FALLBACK_CHAINS.standard)},
+      fast: ${formatModelArray(MODELS.FALLBACK_CHAINS.fast)}
+    },
+    preferSameProvider: true,
+    respectTierCeiling: true,
+    nuclearFallback: {
+      enabled: false,
+      model: '${MODELS.NUCLEAR_FALLBACK}',
+      maxRetriesBeforeNuclear: ${MODELS.NUCLEAR_MAX_RETRIES}
+    }
+  },
+  
+  routing: {
+    rules: [
+      {
+        workType: 'feature-dev',
+        agents: ['@${agents[0]?.name || 'coordinator'}'],
+        confidence: 'high'
+      },
+      {
+        workType: 'bug-fix',
+        agents: ['@${agents.find(a => a.role === 'developer')?.name || agents[0]?.name || 'coordinator'}'],
+        confidence: 'high'
+      },
+      {
+        workType: 'testing',
+        agents: ['@${agents.find(a => a.role === 'tester')?.name || agents[0]?.name || 'coordinator'}'],
+        confidence: 'high'
+      },
+      {
+        workType: 'documentation',
+        agents: ['@${agents.find(a => a.role === 'scribe')?.name || agents[0]?.name || 'coordinator'}'],
+        confidence: 'high'
+      }
+    ],
+    governance: {
+      eagerByDefault: true,
+      scribeAutoRuns: false,
+      allowRecursiveSpawn: false
+    }
+  },
+  
+  casting: {
+    allowlistUniverses: [
+      'The Usual Suspects',
+      'Breaking Bad',
+      'The Wire',
+      'Firefly'
+    ],
+    overflowStrategy: 'generic',
+    universeCapacity: {}
+  },
+  
+  platforms: {
+    vscode: {
+      disableModelSelection: false,
+      scribeMode: 'sync'
+    }
+  }
+};
+
+export default config;
 `;
 }
 /**
@@ -242,6 +242,42 @@ function generateJsonConfig(options) {
     };
     return JSON.stringify(config, null, 2);
 }
+/**
+ * Generate SDK builder config file content (new defineSquad() format).
+ */
+function generateSDKBuilderConfig(options) {
+    const { projectName, projectDescription, agents } = options;
+    // Generate imports
+    let code = `import {\n  defineSquad,\n  defineTeam,\n  defineAgent,\n} from '@bradygaster/squad-sdk';\n\n`;
+    code += `/**\n * Squad Configuration — ${projectName}\n`;
+    if (projectDescription) {
+        code += ` *\n * ${projectDescription}\n`;
+    }
+    code += ` */\n`;
+    // Generate agent definitions
+    for (const agent of agents) {
+        const displayName = agent.displayName || titleCase(agent.name);
+        code += `const ${agent.name} = defineAgent({\n`;
+        code += `  name: '${agent.name}',\n`;
+        code += `  role: '${agent.role}',\n`;
+        code += `  description: '${displayName}',\n`;
+        code += `  status: 'active',\n`;
+        code += `});\n\n`;
+    }
+    // Generate squad config
+    code += `export default defineSquad({\n`;
+    code += `  version: '1.0.0',\n\n`;
+    code += `  team: defineTeam({\n`;
+    code += `    name: '${projectName}',\n`;
+    if (projectDescription) {
+        code += `    description: '${projectDescription.replace(/'/g, "\\'")}',\n`;
+    }
+    code += `    members: [${agents.map(a => `'${a.name}'`).join(', ')}],\n`;
+    code += `  }),\n\n`;
+    code += `  agents: [${agents.map(a => a.name).join(', ')}],\n`;
+    code += `});\n`;
+    return code;
+}
 // ============================================================================
 // Agent Template Generation
 // ============================================================================
@@ -252,26 +288,26 @@ function generateCharter(agent, projectName, projectDescription) {
     const template = AGENT_TEMPLATES[agent.role];
     const displayName = agent.displayName || template?.displayName || titleCase(agent.name);
     const description = template?.description || 'Team member focused on their assigned responsibilities.';
-    return `# ${displayName} — ${titleCase(agent.role)}
-
-${description}
-
-## Project Context
-
-**Project:** ${projectName}
-${projectDescription ? `**Description:** ${projectDescription}\n` : ''}
-
-## Responsibilities
-
-- Collaborate with team members on assigned work
-- Maintain code quality and project standards
-- Document decisions and progress in history
-
-## Work Style
-
-- Read project context and team decisions before starting work
-- Communicate clearly with team members
-- Follow established patterns and conventions
+    return `# ${displayName} — ${titleCase(agent.role)}
+
+${description}
+
+## Project Context
+
+**Project:** ${projectName}
+${projectDescription ? `**Description:** ${projectDescription}\n` : ''}
+
+## Responsibilities
+
+- Collaborate with team members on assigned work
+- Maintain code quality and project standards
+- Document decisions and progress in history
+
+## Work Style
+
+- Read project context and team decisions before starting work
+- Communicate clearly with team members
+- Follow established patterns and conventions
 `;
 }
 /**
@@ -280,22 +316,22 @@ ${projectDescription ? `**Description:** ${projectDescription}\n` : ''}
 function generateInitialHistory(agent, projectName, projectDescription, userName) {
     const displayName = agent.displayName || AGENT_TEMPLATES[agent.role]?.displayName || titleCase(agent.name);
     const now = new Date().toISOString().split('T')[0];
-    return `# Project Context
-
-${userName ? `- **Owner:** ${userName}\n` : ''}- **Project:** ${projectName}
-${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Created:** ${now}
-
-## Core Context
-
-Agent ${displayName} initialized and ready for work.
-
-## Recent Updates
-
-📌 Team initialized on ${now}
-
-## Learnings
-
-Initial setup complete.
+    return `# Project Context
+
+${userName ? `- **Owner:** ${userName}\n` : ''}- **Project:** ${projectName}
+${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Created:** ${now}
+
+## Core Context
+
+Agent ${displayName} initialized and ready for work.
+
+## Recent Updates
+
+📌 Team initialized on ${now}
+
+## Learnings
+
+Initial setup complete.
 `;
 }
 /**
@@ -327,7 +363,7 @@ function stampVersionInContent(content, version) {
  * - .gitignore entries for logs
  * - .github/agents/squad.agent.md
  * - .github/workflows/ (optional)
- * - .squad-templates/ (optional)
+ * - .squad/templates/ (optional)
  * - .copilot/mcp-config.json (optional)
  * - Identity files (now.md, wisdom.md)
  * - ceremonies.md
@@ -335,6 +371,16 @@ function stampVersionInContent(content, version) {
  * @param options - Initialization options
  * @returns Result with created file paths
  */
+/**
+ * Workflow files that are part of the Squad framework and should always be installed.
+ * Other workflows in templates/workflows/ are generic CI/CD scaffolding and are opt-in.
+ */
+const FRAMEWORK_WORKFLOWS = [
+    'squad-heartbeat.yml',
+    'squad-issue-assign.yml',
+    'squad-triage.yml',
+    'sync-squad-labels.yml',
+];
 export async function initSquad(options) {
     const { teamRoot, projectName, projectDescription, agents, configFormat = 'typescript', userName, skipExisting = true, includeWorkflows = true, includeTemplates = true, includeMcpConfig = true, projectType = 'unknown', version = '0.0.0', } = options;
     const createdFiles = [];
@@ -425,12 +471,21 @@ export async function initSquad(options) {
     // -------------------------------------------------------------------------
     // Create configuration file
     // -------------------------------------------------------------------------
-    const configFileName = configFormat === 'typescript' ? 'squad.config.ts' : 'squad.config.json';
-    const configPath = join(teamRoot, configFileName);
-    const configContent = configFormat === 'typescript'
-        ? generateTypeScriptConfig(options)
-        : generateJsonConfig(options);
-    await writeIfNotExists(configPath, configContent);
+    // When configFormat is 'markdown', skip config file generation entirely
+    let configPath;
+    if (configFormat !== 'markdown') {
+        const configFileName = configFormat === 'sdk' ? 'squad.config.ts' :
+            configFormat === 'typescript' ? 'squad.config.ts' : 'squad.config.json';
+        configPath = join(teamRoot, configFileName);
+        const configContent = configFormat === 'sdk' ? generateSDKBuilderConfig(options) :
+            configFormat === 'typescript' ? generateTypeScriptConfig(options) :
+                generateJsonConfig(options);
+        await writeIfNotExists(configPath, configContent);
+    }
+    else {
+        // No config file for markdown-only mode
+        configPath = '';
+    }
     // -------------------------------------------------------------------------
     // Create agent directories and files
     // -------------------------------------------------------------------------
@@ -454,27 +509,27 @@ export async function initSquad(options) {
     const identityDir = join(squadDir, 'identity');
     const nowMdPath = join(identityDir, 'now.md');
     const wisdomMdPath = join(identityDir, 'wisdom.md');
-    const nowContent = `---
-updated_at: ${new Date().toISOString()}
-focus_area: Initial setup
-active_issues: []
----
-
-# What We're Focused On
-
-Getting started. Updated by coordinator at session start.
+    const nowContent = `---
+updated_at: ${new Date().toISOString()}
+focus_area: Initial setup
+active_issues: []
+---
+
+# What We're Focused On
+
+Getting started. Updated by coordinator at session start.
 `;
-    const wisdomContent = `---
-last_updated: ${new Date().toISOString()}
----
-
-# Team Wisdom
-
-Reusable patterns and heuristics learned through work. NOT transcripts — each entry is a distilled, actionable insight.
-
-## Patterns
-
-<!-- Append entries below. Format: **Pattern:** description. **Context:** when it applies. -->
+    const wisdomContent = `---
+last_updated: ${new Date().toISOString()}
+---
+
+# Team Wisdom
+
+Reusable patterns and heuristics learned through work. NOT transcripts — each entry is a distilled, actionable insight.
+
+## Patterns
+
+<!-- Append entries below. Format: **Pattern:** description. **Context:** when it applies. -->
 `;
     await writeIfNotExists(nowMdPath, nowContent);
     await writeIfNotExists(wisdomMdPath, wisdomContent);
@@ -489,42 +544,42 @@ Reusable patterns and heuristics learned through work. NOT transcripts — each
     // Create decisions.md (canonical location at squad root)
     // -------------------------------------------------------------------------
     const decisionsPath = join(squadDir, 'decisions.md');
-    const decisionsContent = `# Squad Decisions
-
-## Active Decisions
-
-No decisions recorded yet.
-
-## Governance
-
-- All meaningful changes require team consensus
-- Document architectural decisions here
-- Keep history focused on work, decisions focused on direction
+    const decisionsContent = `# Squad Decisions
+
+## Active Decisions
+
+No decisions recorded yet.
+
+## Governance
+
+- All meaningful changes require team consensus
+- Document architectural decisions here
+- Keep history focused on work, decisions focused on direction
 `;
     await writeIfNotExists(decisionsPath, decisionsContent);
     // -------------------------------------------------------------------------
     // Create team.md (required by shell lifecycle)
     // -------------------------------------------------------------------------
     const teamPath = join(squadDir, 'team.md');
-    const teamContent = `# Squad Team
-
-> ${projectDescription || projectName}
-
-## Coordinator
-
-| Name | Role | Notes |
-|------|------|-------|
-| Squad | Coordinator | Routes work, enforces handoffs and reviewer gates. |
-
-## Members
-
-| Name | Role | Charter | Status |
-|------|------|---------|--------|
-
-## Project Context
-
-- **Project:** ${projectName}
-${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Created:** ${new Date().toISOString().split('T')[0]}
+    const teamContent = `# Squad Team
+
+> ${projectDescription || projectName}
+
+## Coordinator
+
+| Name | Role | Notes |
+|------|------|-------|
+| Squad | Coordinator | Routes work, enforces handoffs and reviewer gates. |
+
+## Members
+
+| Name | Role | Charter | Status |
+|------|------|---------|--------|
+
+## Project Context
+
+- **Project:** ${projectName}
+${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Created:** ${new Date().toISOString().split('T')[0]}
 `;
     await writeIfNotExists(teamPath, teamContent);
     // -------------------------------------------------------------------------
@@ -535,17 +590,17 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
         await copyIfNotExists(join(templatesDir, 'routing.md'), routingPath);
     }
     else {
-        const routingContent = `# Squad Routing
-
-## Work Type Rules
-
-| Work Type | Primary Agent | Fallback |
-|-----------|---------------|----------|
-
-## Governance
-
-- Route based on work type and agent expertise
-- Update this file as team capabilities evolve
+        const routingContent = `# Squad Routing
+
+## Work Type Rules
+
+| Work Type | Primary Agent | Fallback |
+|-----------|---------------|----------|
+
+## Governance
+
+- Route based on work type and agent expertise
+- Update this file as team capabilities evolve
 `;
         await writeIfNotExists(routingPath, routingContent);
     }
@@ -584,12 +639,16 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
         createdFiles.push(toRelativePath(gitattributesPath));
     }
     // -------------------------------------------------------------------------
-    // Create .gitignore entries for logs
+    // Create .gitignore entries for runtime state (logs, inbox, sessions)
+    // These paths are written during normal squad operation but should not be
+    // committed to version control (they are runtime state).
     // -------------------------------------------------------------------------
     const gitignorePath = join(teamRoot, '.gitignore');
     const ignoreEntries = [
         '.squad/orchestration-log/',
         '.squad/log/',
+        '.squad/decisions/inbox/',
+        '.squad/sessions/',
     ];
     let existingIgnore = '';
     if (existsSync(gitignorePath)) {
@@ -598,7 +657,7 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
     const missingIgnore = ignoreEntries.filter(entry => !existingIgnore.includes(entry));
     if (missingIgnore.length > 0) {
         const block = (existingIgnore && !existingIgnore.endsWith('\n') ? '\n' : '')
-            + '# Squad: ignore generated logs\n'
+            + '# Squad: ignore runtime state (logs, inbox, sessions)\n'
             + missingIgnore.join('\n') + '\n';
         await appendFile(gitignorePath, block);
         createdFiles.push(toRelativePath(gitignorePath));
@@ -620,10 +679,10 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
         skippedFiles.push(toRelativePath(agentFile));
     }
     // -------------------------------------------------------------------------
-    // Copy .squad-templates/ (optional)
+    // Copy .squad/templates/ (optional)
     // -------------------------------------------------------------------------
     if (includeTemplates && templatesDir) {
-        const templatesDest = join(teamRoot, '.squad-templates');
+        const templatesDest = join(teamRoot, '.squad', 'templates');
         if (!existsSync(templatesDest)) {
             cpSync(templatesDir, templatesDest, { recursive: true });
             createdFiles.push(toRelativePath(templatesDest));
@@ -639,7 +698,8 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
         const workflowsSrc = join(templatesDir, 'workflows');
         const workflowsDest = join(teamRoot, '.github', 'workflows');
         if (statSync(workflowsSrc).isDirectory()) {
-            const workflowFiles = readdirSync(workflowsSrc).filter(f => f.endsWith('.yml'));
+            const allWorkflowFiles = readdirSync(workflowsSrc).filter(f => f.endsWith('.yml'));
+            const workflowFiles = allWorkflowFiles.filter(f => FRAMEWORK_WORKFLOWS.includes(f));
             await mkdir(workflowsDest, { recursive: true });
             for (const file of workflowFiles) {
                 const destFile = join(workflowsDest, file);
@@ -680,6 +740,34 @@ ${projectDescription ? `- **Description:** ${projectDescription}\n` : ''}- **Cre
         }
     }
     // -------------------------------------------------------------------------
+    // Generate .squad/workstreams.json (when streams provided)
+    // -------------------------------------------------------------------------
+    if (options.streams && options.streams.length > 0) {
+        const workstreamsConfig = {
+            workstreams: options.streams,
+            defaultWorkflow: 'branch-per-issue',
+        };
+        const workstreamsPath = join(squadDir, 'workstreams.json');
+        await writeIfNotExists(workstreamsPath, JSON.stringify(workstreamsConfig, null, 2) + '\n');
+    }
+    // -------------------------------------------------------------------------
+    // Add .squad-workstream to .gitignore
+    // -------------------------------------------------------------------------
+    {
+        const workstreamIgnoreEntry = '.squad-workstream';
+        let currentIgnore = '';
+        if (existsSync(gitignorePath)) {
+            currentIgnore = readFileSync(gitignorePath, 'utf-8');
+        }
+        if (!currentIgnore.includes(workstreamIgnoreEntry)) {
+            const block = (currentIgnore && !currentIgnore.endsWith('\n') ? '\n' : '')
+                + '# Squad: workstream activation file (local to this machine)\n'
+                + workstreamIgnoreEntry + '\n';
+            await appendFile(gitignorePath, block);
+            createdFiles.push(toRelativePath(gitignorePath));
+        }
+    }
+    // -------------------------------------------------------------------------
     // Create .first-run marker
     // -------------------------------------------------------------------------
     const firstRunMarker = join(squadDir, '.first-run');