create-sessions-dir 0.2.0 → 0.3.1

package/README.md

@@ -21,7 +21,9 @@ npx create-sessions-dir
 This creates:
 - `.sessions/` directory with context files
 - `.claude/commands/` with slash commands for Claude Code
+- `.claude/scripts/` with helper scripts
 - Templates and workflow guide
+- Optionally creates or updates CLAUDE.md to document the pattern
 
 Then start your first session:
 ```bash
@@ -34,14 +36,21 @@ Then start your first session:
 .sessions/
   index.md          # Your living context document
   archive/          # For completed work
+  plans/            # Implementation plans
+  prep/             # Pre-session context
   README.md         # Workflow guide and examples
+  .gitignore        # Ignores data/, scratch/ directories
+  WORKSPACE.md      # Monorepo guide (if detected)
 
 .claude/
   commands/
     start-session.md    # /start-session command
     end-session.md      # /end-session command
     document.md         # /document <topic> command
+    plan.md             # /plan command
     archive-session.md  # /archive-session command
+  scripts/
+    should-archive.sh   # PR detection for smart archiving
 ```
 
 ## Usage
@@ -50,19 +59,25 @@ Then start your first session:
 ```
 /start-session
 ```
-Claude reads your context and asks what you want to work on.
+Claude reads your context and asks what you want to work on. You can provide a GitHub/Linear URL and Claude will fetch details automatically.
 
 ### End a Session
 ```
 /end-session
 ```
-Claude updates your context with what happened and commits the changes.
+Claude updates your context with what happened. If you referenced PRs (like #123) and they're merged, Claude will offer to archive automatically. Then commits the changes.
+
+### Plan Implementation
+```
+/plan
+```
+Claude launches a planning agent to design your implementation, creating a structured plan in `.sessions/plans/`.
 
 ### Document a Topic
 ```
 /document architecture
 ```
-Claude creates topic-specific documentation in `.sessions/docs/`. Use this for architectural decisions, API patterns, testing strategies, or other deep context.
+Claude launches an exploration agent to understand the topic, then creates documentation in `.sessions/docs/`.
 
 ### Archive Completed Work
 ```
@@ -70,11 +85,41 @@ Claude creates topic-specific documentation in `.sessions/docs/`. Use this for a
 ```
 Claude moves finished work to the archive to keep your context file clean.
 
+### Change Git Strategy
+```
+/change-git-strategy
+```
+Change how .sessions/ is handled in git (hybrid, commit all, or ignore all). Useful if you want to share more/less with your team.
+
 ## Requirements
 
 - Any project (works with any language/framework)
 - Claude Code CLI (optional but recommended for slash commands)
 
+## Updating
+
+Already have a Sessions Directory from v0.1 or v0.2? Just run:
+
+```bash
+npx create-sessions-dir
+```
+
+It will detect your existing setup and update it to v0.3.0 **without touching your work**. All your session notes, archive, and docs are preserved. Only the commands and structure are updated.
+
+## Interactive Setup
+
+During installation, you'll be prompted for:
+
+1. **Git strategy** - How .sessions/ should be handled in git
+   - **Ignore all** (default) - Keep sessions completely local
+   - **Hybrid** - Commit docs/plans, keep notes private
+   - **Commit all** - Share everything with team
+
+2. **CLAUDE.md documentation** - Document the pattern for your team
+   - Creates new CLAUDE.md if none exists
+   - Appends to existing CLAUDE.md if detected
+   - Skips if Sessions Pattern already documented
+
 ## Why This Works
 
 AI coding agents are stateless - they don't remember previous sessions. The Sessions Directory Pattern solves this by:
@@ -86,6 +131,10 @@ AI coding agents are stateless - they don't remember previous sessions. The Sess
 
 Read the full story: [vieko.dev/sessions](https://vieko.dev/sessions)
 
+## Acknowledgments
+
+Thanks to [Aman Azad](https://github.com/namadaza) for the nudge to turn the pattern into a tool.
+
 ## License
 
 MIT © [Vieko Franetovic](https://vieko.dev)

package/dist/index.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
-import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, chmodSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { execSync } from 'child_process';
+import prompts from 'prompts';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 // Colors for terminal output
@@ -20,6 +21,212 @@ function log(message, color = colors.reset) {
 function checkExistingSessions() {
     return existsSync('.sessions');
 }
+function detectVersion() {
+    // Try to detect version from existing setup
+    if (!existsSync('.sessions'))
+        return null;
+    // Check for v0.3-specific files (not just directories users might create)
+    const hasArchiveScript = existsSync('.claude/scripts/should-archive.sh');
+    const hasPlanCommand = existsSync('.claude/commands/plan.md');
+    const hasHybridGitignore = existsSync('.sessions/.gitignore') &&
+        readFileSync('.sessions/.gitignore', 'utf-8').includes('!docs/');
+    // If any v0.3-specific feature exists, consider it v0.3+
+    if (hasArchiveScript || hasPlanCommand || hasHybridGitignore) {
+        return 'v0.3+';
+    }
+    return 'v0.1-0.2'; // Old version
+}
+async function promptGitStrategy() {
+    const response = await prompts({
+        type: 'select',
+        name: 'strategy',
+        message: 'How should .sessions/ be handled in git?',
+        choices: [
+            {
+                title: 'Ignore all (recommended)',
+                value: 'ignore',
+                description: 'Keep sessions completely local (start solo, share later if needed)'
+            },
+            {
+                title: 'Hybrid',
+                value: 'hybrid',
+                description: 'Commit docs/plans, keep working notes private'
+            },
+            {
+                title: 'Commit all',
+                value: 'commit',
+                description: 'Share session notes with team, preserve history'
+            }
+        ],
+        initial: 0
+    });
+    return response.strategy || 'ignore';
+}
+async function promptClaudeMdUpdate() {
+    // Check if CLAUDE.md exists
+    if (!existsSync('CLAUDE.md')) {
+        const response = await prompts({
+            type: 'confirm',
+            name: 'create',
+            message: 'Create CLAUDE.md to document Sessions Pattern for your team?',
+            initial: true
+        });
+        return response.create ?? false;
+    }
+    // CLAUDE.md exists - check if Sessions Pattern already documented
+    const existing = readFileSync('CLAUDE.md', 'utf-8');
+    if (existing.includes('Sessions Pattern') || existing.includes('.sessions/')) {
+        log('✓ CLAUDE.md already mentions Sessions Pattern', colors.green);
+        return false;
+    }
+    // Ask to append
+    const response = await prompts({
+        type: 'confirm',
+        name: 'append',
+        message: 'Add Sessions Pattern documentation to existing CLAUDE.md?',
+        initial: true
+    });
+    return response.append ?? false;
+}
+function createOrUpdateClaudeMd(isNew) {
+    const sessionsSection = `
+## Sessions Pattern (Optional)
+
+If you've set up the Sessions Directory Pattern (\`npx create-sessions-dir\`):
+
+- \`/start-session\` - Read context, fetch GitHub/Linear issues
+- \`/end-session\` - Update context, detect merged PRs, auto-archive
+- \`/plan\` - Create structured implementation plans
+- \`/document\` - Topic-specific documentation with sub-agents
+- \`/change-git-strategy\` - Change git strategy for .sessions/
+
+Learn more: https://vieko.dev/sessions
+
+## External Tools (Optional)
+
+**For GitHub integration:**
+\`\`\`bash
+gh auth login    # Required for PR/issue fetching
+\`\`\`
+
+**For Linear integration:**
+\`\`\`bash
+npm install -g linearis
+echo "your-api-token" > ~/.linear_api_token
+# Or: export LINEAR_API_TOKEN=your-token
+\`\`\`
+
+Get token: Linear Settings → Security & Access → Personal API keys
+
+Commands will gracefully handle missing tools and prompt for manual input.
+`;
+    if (isNew) {
+        // Create new CLAUDE.md
+        const content = `# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+${sessionsSection}`;
+        writeFileSync('CLAUDE.md', content);
+        log('✓ Created CLAUDE.md with Sessions Pattern documentation', colors.green);
+    }
+    else {
+        // Append to existing CLAUDE.md
+        const existing = readFileSync('CLAUDE.md', 'utf-8');
+        const updated = existing + '\n' + sessionsSection;
+        writeFileSync('CLAUDE.md', updated);
+        log('✓ Added Sessions Pattern section to CLAUDE.md', colors.green);
+    }
+}
+function createGitignore(strategy) {
+    const templateMap = {
+        commit: 'sessions/.gitignore-commit',
+        ignore: 'sessions/.gitignore-ignore',
+        hybrid: 'sessions/.gitignore-hybrid'
+    };
+    const template = templateMap[strategy] || templateMap.hybrid;
+    const gitignoreContent = getTemplateContent(template);
+    writeFileSync('.sessions/.gitignore', gitignoreContent);
+    const strategyLabels = {
+        commit: 'commit strategy (team-shared)',
+        ignore: 'ignore strategy (personal)',
+        hybrid: 'hybrid strategy (docs committed, notes private)'
+    };
+    log(`✓ Created .sessions/.gitignore (${strategyLabels[strategy]})`, colors.green);
+}
+function updateExistingSetup() {
+    log('\n📦 Updating existing Sessions Directory...', colors.cyan);
+    const version = detectVersion();
+    if (version === 'v0.3+') {
+        log('✓ Already on latest version', colors.green);
+        return;
+    }
+    // Create new directories (safe - won't overwrite)
+    if (!existsSync('.sessions/plans')) {
+        mkdirSync('.sessions/plans', { recursive: true });
+        log('✓ Created .sessions/plans/', colors.green);
+    }
+    if (!existsSync('.sessions/prep')) {
+        mkdirSync('.sessions/prep', { recursive: true });
+        log('✓ Created .sessions/prep/', colors.green);
+    }
+    if (!existsSync('.claude/scripts')) {
+        mkdirSync('.claude/scripts', { recursive: true });
+        log('✓ Created .claude/scripts/', colors.green);
+    }
+    // Update .gitignore to ignore if it only has basic content
+    if (existsSync('.sessions/.gitignore')) {
+        const existing = readFileSync('.sessions/.gitignore', 'utf-8');
+        // If it's the old basic version, update to ignore (safest for updates)
+        if (existing.includes('data/') && existing.includes('scratch/') && existing.split('\n').length < 10) {
+            createGitignore('ignore');
+            log('✓ Updated .sessions/.gitignore to ignore strategy', colors.cyan);
+        }
+    }
+    else {
+        // No gitignore exists, create ignore (safest for updates - prevents accidental commits)
+        createGitignore('ignore');
+    }
+    // Update or create commands
+    const commands = ['start-session', 'end-session', 'document', 'archive-session'];
+    for (const cmd of commands) {
+        const content = getTemplateContent(`claude/commands/${cmd}.md`);
+        writeFileSync(`.claude/commands/${cmd}.md`, content);
+        log(`✓ Updated .claude/commands/${cmd}.md`, colors.green);
+    }
+    // Create new v0.3 commands
+    const newCommands = ['plan', 'change-git-strategy'];
+    for (const cmd of newCommands) {
+        if (!existsSync(`.claude/commands/${cmd}.md`)) {
+            const content = getTemplateContent(`claude/commands/${cmd}.md`);
+            writeFileSync(`.claude/commands/${cmd}.md`, content);
+            log(`✓ Created .claude/commands/${cmd}.md`, colors.green);
+        }
+    }
+    // Create scripts
+    if (!existsSync('.claude/scripts/should-archive.sh')) {
+        const shouldArchiveScript = getTemplateContent('claude/scripts/should-archive.sh');
+        writeFileSync('.claude/scripts/should-archive.sh', shouldArchiveScript);
+        chmodSync('.claude/scripts/should-archive.sh', 0o755);
+        log('✓ Created .claude/scripts/should-archive.sh', colors.green);
+    }
+    if (!existsSync('.claude/scripts/untrack-sessions.sh')) {
+        const untrackScript = getTemplateContent('claude/scripts/untrack-sessions.sh');
+        writeFileSync('.claude/scripts/untrack-sessions.sh', untrackScript);
+        chmodSync('.claude/scripts/untrack-sessions.sh', 0o755);
+        log('✓ Created .claude/scripts/untrack-sessions.sh', colors.green);
+    }
+    // Check for monorepo and add workspace support if needed
+    const monorepo = detectMonorepo();
+    if (monorepo.isMonorepo && !existsSync('.sessions/WORKSPACE.md')) {
+        mkdirSync('.sessions/packages', { recursive: true });
+        log('✓ Detected monorepo - created .sessions/packages/', colors.cyan);
+        const workspaceContent = getTemplateContent('sessions/WORKSPACE.md')
+            .replace('{{PACKAGES}}', monorepo.packages.map(p => `- ${p}`).join('\n'));
+        writeFileSync('.sessions/WORKSPACE.md', workspaceContent);
+        log('✓ Created .sessions/WORKSPACE.md', colors.green);
+    }
+    log('\n✓ Update complete! Your existing work is preserved.', colors.green + colors.bright);
+}
 function checkClaudeCLI() {
     try {
         execSync('which claude', { stdio: 'ignore' });
@@ -68,17 +275,87 @@ function getTemplateContent(filename) {
     const filePath = join(templatesDir, filename);
     return readFileSync(filePath, 'utf-8');
 }
+function detectMonorepo() {
+    // Check for pnpm workspace
+    if (existsSync('pnpm-workspace.yaml')) {
+        try {
+            const yaml = readFileSync('pnpm-workspace.yaml', 'utf-8');
+            // Simple YAML parsing for packages array
+            const packagesMatch = yaml.match(/packages:\s*\n((?:\s*-\s*.+\n?)+)/);
+            if (packagesMatch) {
+                const packages = packagesMatch[1]
+                    .split('\n')
+                    .filter(line => line.trim().startsWith('-'))
+                    .map(line => line.trim().substring(1).trim());
+                return { isMonorepo: true, root: process.cwd(), packages };
+            }
+        }
+        catch {
+            // Fall through
+        }
+    }
+    // Check for npm/yarn/bun workspaces (also used by Turborepo)
+    if (existsSync('package.json')) {
+        try {
+            const pkg = JSON.parse(readFileSync('package.json', 'utf-8'));
+            if (pkg.workspaces) {
+                const packages = Array.isArray(pkg.workspaces)
+                    ? pkg.workspaces
+                    : pkg.workspaces.packages || [];
+                return { isMonorepo: true, root: process.cwd(), packages };
+            }
+        }
+        catch {
+            // Fall through
+        }
+    }
+    // Check for Lerna
+    if (existsSync('lerna.json')) {
+        try {
+            const lerna = JSON.parse(readFileSync('lerna.json', 'utf-8'));
+            const packages = lerna.packages || ['packages/*'];
+            return { isMonorepo: true, root: process.cwd(), packages };
+        }
+        catch {
+            // Fall through
+        }
+    }
+    // Check for Turborepo (fallback if no workspace config found yet)
+    // Turborepo uses underlying workspace configs, so this is a hint to check deeper
+    if (existsSync('turbo.json') || existsSync('turbo.jsonc')) {
+        // Turborepo detected but no workspace config - might be misconfigured or minimal setup
+        // Default to common patterns
+        return { isMonorepo: true, root: process.cwd(), packages: ['apps/*', 'packages/*'] };
+    }
+    return { isMonorepo: false, root: process.cwd(), packages: [] };
+}
 function createSessionsDirectory() {
     const projectName = getProjectName();
     const currentDate = getCurrentDate();
-    // Create directories
+    const monorepo = detectMonorepo();
+    // Create base directories
     mkdirSync('.sessions', { recursive: true });
     mkdirSync('.sessions/archive', { recursive: true });
+    mkdirSync('.sessions/plans', { recursive: true });
+    mkdirSync('.sessions/prep', { recursive: true });
     mkdirSync('.claude', { recursive: true });
     mkdirSync('.claude/commands', { recursive: true });
+    mkdirSync('.claude/scripts', { recursive: true });
     log('\n✓ Created .sessions/ directory', colors.green);
     log('✓ Created .sessions/archive/ directory', colors.green);
+    log('✓ Created .sessions/plans/ directory', colors.green);
+    log('✓ Created .sessions/prep/ directory', colors.green);
     log('✓ Created .claude/commands/ directory', colors.green);
+    log('✓ Created .claude/scripts/ directory', colors.green);
+    // Handle monorepo setup
+    if (monorepo.isMonorepo) {
+        mkdirSync('.sessions/packages', { recursive: true });
+        log('✓ Detected monorepo - created .sessions/packages/', colors.cyan);
+        const workspaceContent = getTemplateContent('sessions/WORKSPACE.md')
+            .replace('{{PACKAGES}}', monorepo.packages.map(p => `- ${p}`).join('\n'));
+        writeFileSync('.sessions/WORKSPACE.md', workspaceContent);
+        log('✓ Created .sessions/WORKSPACE.md', colors.green);
+    }
     // Create index.md
     const indexContent = getTemplateContent('sessions/index.md')
         .replace('{{PROJECT_NAME}}', projectName)
@@ -89,6 +366,7 @@ function createSessionsDirectory() {
     const readmeContent = getTemplateContent('sessions/README.md');
     writeFileSync('.sessions/README.md', readmeContent);
     log('✓ Created .sessions/README.md', colors.green);
+    // Git strategy will be set in main() after user prompt
     // Create slash commands
     const startSessionContent = getTemplateContent('claude/commands/start-session.md');
     writeFileSync('.claude/commands/start-session.md', startSessionContent);
@@ -102,18 +380,73 @@ function createSessionsDirectory() {
     const documentContent = getTemplateContent('claude/commands/document.md');
     writeFileSync('.claude/commands/document.md', documentContent);
     log('✓ Created .claude/commands/document.md', colors.green);
+    const planContent = getTemplateContent('claude/commands/plan.md');
+    writeFileSync('.claude/commands/plan.md', planContent);
+    log('✓ Created .claude/commands/plan.md', colors.green);
+    const changeGitStrategyContent = getTemplateContent('claude/commands/change-git-strategy.md');
+    writeFileSync('.claude/commands/change-git-strategy.md', changeGitStrategyContent);
+    log('✓ Created .claude/commands/change-git-strategy.md', colors.green);
+    // Create scripts
+    const shouldArchiveScript = getTemplateContent('claude/scripts/should-archive.sh');
+    writeFileSync('.claude/scripts/should-archive.sh', shouldArchiveScript);
+    chmodSync('.claude/scripts/should-archive.sh', 0o755);
+    log('✓ Created .claude/scripts/should-archive.sh', colors.green);
+    const untrackScript = getTemplateContent('claude/scripts/untrack-sessions.sh');
+    writeFileSync('.claude/scripts/untrack-sessions.sh', untrackScript);
+    chmodSync('.claude/scripts/untrack-sessions.sh', 0o755);
+    log('✓ Created .claude/scripts/untrack-sessions.sh', colors.green);
 }
-function main() {
+async function main() {
     log('\n✨ create-sessions-dir', colors.cyan + colors.bright);
     log('   Setting up Sessions Directory Pattern\n', colors.cyan);
     // Check for existing .sessions directory
     if (checkExistingSessions()) {
-        log('⚠️  .sessions/ directory already exists!', colors.yellow);
-        log('   Aborting to avoid overwriting existing files.\n', colors.yellow);
-        process.exit(1);
+        const version = detectVersion();
+        if (version === 'v0.3+') {
+            log('✓ Sessions Directory already exists and is up to date', colors.green);
+            log('   No updates needed.\n', colors.cyan);
+            process.exit(0);
+        }
+        else {
+            log('📦 Existing Sessions Directory detected (older version)', colors.cyan);
+            log('   Updating to v0.3.0 with new features...\n', colors.cyan);
+            updateExistingSetup();
+            // Check for Claude CLI
+            const hasClaudeCLI = checkClaudeCLI();
+            log('\n' + '─'.repeat(50), colors.blue);
+            log('\n🎉 Update complete!\n', colors.green + colors.bright);
+            log('What\'s new in v0.3.0:', colors.bright);
+            log('  • Smart PR detection and archiving (.claude/scripts/should-archive.sh)');
+            log('  • GitHub/Linear issue integration (/start-session)');
+            log('  • Implementation planning (/plan)');
+            log('  • Enhanced documentation with sub-agents (/document)');
+            log('  • Monorepo support (auto-detected)');
+            log('  • New directories: plans/, prep/\n');
+            if (!hasClaudeCLI) {
+                log('⚠️  Claude CLI not detected', colors.yellow);
+                log('   Install it to use slash commands:', colors.yellow);
+                log('   npm install -g @anthropic-ai/claude-code\n', colors.cyan);
+            }
+            log('Next steps:', colors.bright);
+            log('  1. Check updated commands in .claude/commands/');
+            log('  2. Try /plan to create an implementation plan');
+            log('  3. Learn more: https://vieko.dev/sessions\n');
+            return;
+        }
     }
-    // Create the structure
+    // Create the structure (fresh install)
     createSessionsDirectory();
+    // Prompt for git strategy
+    log('');
+    const gitStrategy = await promptGitStrategy();
+    createGitignore(gitStrategy);
+    // Prompt for CLAUDE.md documentation
+    log('');
+    const shouldUpdateClaudeMd = await promptClaudeMdUpdate();
+    if (shouldUpdateClaudeMd) {
+        const isNew = !existsSync('CLAUDE.md');
+        createOrUpdateClaudeMd(isNew);
+    }
     // Check for Claude CLI
     const hasClaudeCLI = checkClaudeCLI();
     log('\n' + '─'.repeat(50), colors.blue);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-sessions-dir",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Scaffold a Sessions Directory for working with AI coding agents",
   "type": "module",
   "bin": {

package/templates/claude/commands/change-git-strategy.md

@@ -0,0 +1,115 @@
+---
+description: Change how .sessions/ is handled in git
+---
+
+Change the git strategy for .sessions/ directory.
+
+**Current Strategies:**
+
+1. **Hybrid (recommended)**
+   - Commits: docs/, plans/, packages/, README.md, WORKSPACE.md
+   - Ignores: index.md, archive/, prep/, data/, scratch/
+   - Use case: Share architecture/decisions, keep personal notes private
+
+2. **Commit all (team-shared)**
+   - Commits: Everything except data/, scratch/
+   - Ignores: Only temporary data
+   - Use case: Full team collaboration, shared session history
+
+3. **Ignore all (personal)**
+   - Commits: Nothing in .sessions/
+   - Ignores: Everything
+   - Use case: Solo dev or completely private workflow
+
+**Steps:**
+
+1. Ask: "Which git strategy do you want?"
+   - Show current strategy if detectable from .sessions/.gitignore
+   - Options: hybrid, commit, ignore
+
+2. Based on choice, update .sessions/.gitignore:
+
+   **For hybrid:**
+   ```
+   # Personal working notes (not committed)
+   index.md
+   archive/
+   prep/
+
+   # Temporary data
+   data/
+   scratch/
+   *.tmp
+   *.local
+
+   # Team documentation (committed)
+   !docs/
+   !plans/
+   !packages/
+   !README.md
+   !WORKSPACE.md
+   !.gitignore
+   ```
+
+   **For commit:**
+   ```
+   # Temporary and local data
+   data/
+   scratch/
+   *.tmp
+   *.local
+   ```
+
+   **For ignore:**
+   ```
+   # Keep all sessions local (not committed)
+   # Remove this file if you want to commit sessions to git
+   *
+   ```
+
+3. Show what changed:
+   - "Changed from [old strategy] to [new strategy]"
+   - "Run 'git status .sessions/' to see current state"
+
+4. Check if any .sessions/ files are already tracked in git:
+   ```bash
+   git ls-files .sessions/
+   ```
+
+   If files are found AND new strategy is more restrictive:
+   - **Switching to "ignore all"**: Warn that previously committed files are still tracked
+   - **Switching to "hybrid"**: Warn that personal files (index.md, archive/) are still tracked
+
+   Provide the command to untrack them:
+   ```bash
+   # For ignore all:
+   git rm --cached -r .sessions/
+
+   # For hybrid (untrack personal files only):
+   git rm --cached .sessions/index.md .sessions/archive/ .sessions/prep/
+   ```
+
+   **Important**: This removes files from git tracking but keeps them on disk.
+
+   Provide two options:
+
+   **Option A: Use helper script (recommended)**
+   ```bash
+   .claude/scripts/untrack-sessions.sh [ignore|hybrid]
+   ```
+
+   **Option B: Manual git command**
+   ```bash
+   git rm --cached -r .sessions/                    # For ignore all
+   git rm --cached .sessions/index.md ...           # For hybrid
+   ```
+
+   Ask user: "Do you want me to run the helper script now? [y/N]"
+   - If yes: Run `.claude/scripts/untrack-sessions.sh [strategy]`, show result
+   - If no: Show both options they can run manually
+
+5. Remind user to commit the .gitignore change:
+   ```bash
+   git add .sessions/.gitignore
+   git commit -m "Change sessions git strategy to [new strategy]"
+   ```

package/templates/claude/commands/document.md

@@ -1,16 +1,32 @@
+---
+description: Create topic-specific documentation
+---
+
 Create or update documentation for a specific topic in .sessions/docs/
 
 The user will provide a topic name (e.g., "authentication", "api-design", "testing-strategy").
 
 Steps:
 1. If .sessions/docs/ doesn't exist, create it first
-2. Create or update .sessions/docs/<topic>.md
-3. Ask me what should be documented about this topic
-4. Structure the documentation with:
+2. Ask: "What should be documented about [topic]?"
+3. Launch an Explore agent with:
+   "Thoroughly explore the codebase to understand [topic].
+
+   Focus on:
+   - Architecture and patterns
+   - Key implementation details
+   - Important decisions and trade-offs
+   - Critical files and code locations
+
+   Return a structured summary suitable for documentation."
+
+4. Use the agent's findings to create .sessions/docs/<topic>.md with:
    - Overview of the topic
    - Current decisions and rationale
    - Implementation details or patterns
+   - Key files and code references (use file:line format)
    - Open questions or considerations
-   - Links to relevant code or resources
 
-Keep the documentation scannable and focused. Use clear headings and bullet points.
+5. Add reference to this doc in index.md under relevant section
+
+Keep documentation scannable with clear headings and bullet points.

package/templates/claude/commands/end-session.md

@@ -1,4 +1,16 @@
-Update .sessions/index.md with what we accomplished this session.
+---
+allowed-tools: Bash(git:*), Bash(.claude/scripts/*:*)
+description: End session and update context
+---
+
+## Context
+
+- Current git status: !`git status --short`
+- Archive recommendation: !`.claude/scripts/should-archive.sh`
+
+## Your task
+
+Update .sessions/index.md with session accomplishments.
 
 Include:
 - Today's date
@@ -6,4 +18,17 @@ Include:
 - Any blockers or open questions
 - Next session priorities
 
-Then commit the changes with a descriptive message.
+Check the archive recommendation output above.
+
+If the script output contains "ARCHIVE_RECOMMENDED":
+  - The listed PRs have been merged
+  - Ask: "Archive this session's work? [Y/n]"
+  - If yes:
+    - Move relevant session notes to .sessions/archive/YYYY-MM-DD-<description>.md
+    - Remove completed items from index.md
+    - Keep ongoing/next work in place
+
+If the script output is "NO_ARCHIVE":
+  - Skip archiving (no merged PRs detected)
+
+Commit changes with a descriptive message about the session.

package/templates/claude/commands/plan.md

@@ -0,0 +1,53 @@
+---
+description: Create implementation plan
+---
+
+Create or update a plan in .sessions/plans/
+
+Steps:
+1. If .sessions/plans/ doesn't exist, create it first
+2. Ask: "What are you planning to implement?"
+3. Launch a Plan agent with:
+   "Help design the implementation for [description].
+
+   Analyze the codebase and provide:
+   - Requirements breakdown
+   - Architecture decisions and trade-offs
+   - Files that need changes (with file:line references)
+   - Implementation steps
+   - Risks and open questions"
+
+4. Create .sessions/plans/YYYY-MM-DD-<name>.md with structured plan:
+
+```markdown
+# Plan: [Feature Name]
+**Date**: YYYY-MM-DD
+**Status**: Draft
+
+## Goal
+[What we're building and why]
+
+## Requirements
+- [ ] Requirement 1
+- [ ] Requirement 2
+
+## Architecture Decisions
+- **Decision**: Choice made
+- **Rationale**: Why we chose this approach
+- **Trade-offs**: What we're optimizing for
+
+## Implementation Steps
+1. [ ] Step 1 (file:line references)
+2. [ ] Step 2 (file:line references)
+
+## Risks & Open Questions
+- What we're unsure about
+- What could go wrong
+
+## Related
+- Links to issues, PRs, other plans
+```
+
+5. Add reference to plan in index.md: "Planning: [Feature] (see plans/YYYY-MM-DD-<name>.md)"
+
+Then ask: "Ready to start implementing?"

package/templates/claude/commands/start-session.md

@@ -1,8 +1,31 @@
+---
+allowed-tools: Bash(gh:*), Bash(linearis:*)
+description: Start a new session
+---
+
 Read .sessions/index.md and report when ready.
 
+Check if .sessions/WORKSPACE.md exists (don't error if missing). If it exists, mention that monorepo support is active and show detected packages.
+
 Summarize:
 - Current state
 - Recent work
 - Next priorities
 
-Then ask what I want to work on this session.
+Then ask: "What do you want to work on this session?"
+
+**Only fetch external context if user provides a new URL or issue ID:**
+
+If user provides a GitHub/Linear URL or issue ID:
+  - **GitHub**: gh pr view [URL] --json title,body,state,labels
+  - **GitHub**: gh issue view [URL] --json title,body,state,labels
+  - **Linear**: linearis issues read [ID] (e.g., DEV-456, GTMENG-304)
+  - Summarize the fetched context
+  - Store in .sessions/prep/YYYY-MM-DD-topic.md
+  - Add reference to index.md
+
+Otherwise (continuing work, ad-hoc task, etc.):
+  - Proceed with existing session context
+  - Session notes are the source of truth for ongoing work
+
+Confirm understanding and ask how to proceed.

package/templates/claude/scripts/should-archive.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+
+# should-archive.sh
+# Detects merged PRs referenced in session notes and recommends archiving
+
+set -euo pipefail
+
+# Check if gh CLI is installed
+if ! command -v gh &> /dev/null; then
+  echo "NO_ARCHIVE: gh CLI not found (install: brew install gh)"
+  exit 0
+fi
+
+# Check if .sessions/index.md exists
+if [ ! -f ".sessions/index.md" ]; then
+  echo "NO_ARCHIVE: .sessions/index.md not found"
+  exit 0
+fi
+
+# Extract PR numbers from session notes (#xxx format)
+pr_numbers=$(grep -oE '#[0-9]+' .sessions/index.md 2>/dev/null | grep -oE '[0-9]+' | sort -u || true)
+
+if [ -z "$pr_numbers" ]; then
+  echo "NO_ARCHIVE: No PR references found in session notes"
+  exit 0
+fi
+
+merged_prs=()
+
+# Check each PR's status
+for pr in $pr_numbers; do
+  # Query PR state, handle errors gracefully
+  state=$(gh pr view "$pr" --json state --jq '.state' 2>/dev/null || echo "NOT_FOUND")
+
+  if [ "$state" = "MERGED" ]; then
+    title=$(gh pr view "$pr" --json title --jq '.title' 2>/dev/null || echo "Unknown")
+    merged_prs+=("#$pr: $title")
+  fi
+done
+
+# Output recommendation
+if [ ${#merged_prs[@]} -eq 0 ]; then
+  echo "NO_ARCHIVE: No merged PRs found"
+else
+  echo "ARCHIVE_RECOMMENDED: Found merged PRs:"
+  for pr in "${merged_prs[@]}"; do
+    echo "  - $pr"
+  done
+fi

package/templates/claude/scripts/untrack-sessions.sh

@@ -0,0 +1,78 @@
+#!/bin/bash
+
+# untrack-sessions.sh
+# Helper script to untrack .sessions/ files from git after changing strategy
+
+set -euo pipefail
+
+strategy="${1:-}"
+
+if [ -z "$strategy" ]; then
+  echo "Usage: .claude/scripts/untrack-sessions.sh [ignore|hybrid]"
+  echo ""
+  echo "  ignore  - Untrack all .sessions/ files"
+  echo "  hybrid  - Untrack only personal files (index.md, archive/, prep/)"
+  exit 1
+fi
+
+# Check if in git repo
+if ! git rev-parse --git-dir > /dev/null 2>&1; then
+  echo "[ERROR] Not in a git repository"
+  exit 1
+fi
+
+# Check if .sessions/ exists
+if [ ! -d ".sessions" ]; then
+  echo "[ERROR] .sessions/ directory not found"
+  exit 1
+fi
+
+# Check what's currently tracked
+tracked_files=$(git ls-files .sessions/ | wc -l | tr -d ' ')
+
+if [ "$tracked_files" -eq 0 ]; then
+  echo "[OK] No .sessions/ files are tracked in git"
+  exit 0
+fi
+
+echo "[INFO] Found $tracked_files tracked files in .sessions/"
+echo ""
+
+case "$strategy" in
+  ignore)
+    echo "Untracking ALL .sessions/ files..."
+    git rm --cached -r .sessions/ 2>/dev/null || true
+    echo "[OK] All .sessions/ files untracked"
+    echo ""
+    echo "Files removed from git but kept on disk."
+    echo "Run 'git status' to see changes."
+    ;;
+
+  hybrid)
+    echo "Untracking personal files (index.md, archive/, prep/)..."
+
+    # Untrack specific files/directories
+    git rm --cached .sessions/index.md 2>/dev/null || true
+    git rm --cached -r .sessions/archive/ 2>/dev/null || true
+    git rm --cached -r .sessions/prep/ 2>/dev/null || true
+    git rm --cached -r .sessions/data/ 2>/dev/null || true
+    git rm --cached -r .sessions/scratch/ 2>/dev/null || true
+
+    echo "[OK] Personal files untracked"
+    echo ""
+    echo "Kept tracked: docs/, plans/, packages/"
+    echo "Files removed from git but kept on disk."
+    echo "Run 'git status' to see changes."
+    ;;
+
+  *)
+    echo "[ERROR] Unknown strategy: $strategy"
+    echo "Use 'ignore' or 'hybrid'"
+    exit 1
+    ;;
+esac
+
+echo ""
+echo "Next steps:"
+echo "  1. Review: git status .sessions/"
+echo "  2. Commit: git commit -m 'Change sessions strategy to $strategy'"

package/templates/sessions/.gitignore-commit

@@ -0,0 +1,5 @@
+# Temporary and local data
+data/
+scratch/
+*.tmp
+*.local

package/templates/sessions/.gitignore-hybrid

@@ -0,0 +1,18 @@
+# Personal working notes (not committed)
+index.md
+archive/
+prep/
+
+# Temporary data
+data/
+scratch/
+*.tmp
+*.local
+
+# Team documentation (committed)
+!docs/
+!plans/
+!packages/
+!README.md
+!WORKSPACE.md
+!.gitignore

package/templates/sessions/.gitignore-ignore

@@ -0,0 +1,3 @@
+# Keep all sessions local (not committed)
+# Remove this file if you want to commit sessions to git
+*

package/templates/sessions/README.md

@@ -167,15 +167,35 @@ Clean up .sessions/index.md by removing completed items.
 
 ---
 
+## Optional Directories
+
+The Sessions Directory supports extensions:
+
+- `docs/` - Topic-specific documentation (use `/document`)
+- `plans/` - Implementation plans (use `/plan`)
+- `prep/` - Pre-session context gathering (created by `/start-session`)
+- `archive/` - Completed work (use `/end-session` auto-detect)
+- `data/` - Sample/test data for tasks (git-ignored)
+- `scratch/` - Temporary experiments (git-ignored)
+
+A `.gitignore` is included to exclude temporary directories.
+
 ## Customizing
 
 This structure is a starting point. Adapt it to your needs:
 
-- Add topic-specific docs (`.sessions/architecture.md`, `.sessions/api-decisions.md`)
+- Add more topic-specific docs in `.sessions/docs/`
 - Create templates for recurring documentation
 - Structure the archive however makes sense for your project
 - Modify slash commands in `.claude/commands/` to match your workflow
 
+## Monorepo Support
+
+If you're in a monorepo, check for `.sessions/WORKSPACE.md` which provides guidance on:
+- Shared sessions at the root level
+- Package-specific notes in `.sessions/packages/`
+- Cross-package work tracking
+
 ---
 
 ## Why This Works

package/templates/sessions/WORKSPACE.md

@@ -0,0 +1,46 @@
+# Workspace Configuration
+
+**Detected Monorepo Packages:**
+{{PACKAGES}}
+
+## Monorepo Sessions Pattern
+
+This repository uses a shared sessions directory at the root level.
+
+### Structure
+
+- `.sessions/index.md` - Main session context (cross-package work)
+- `.sessions/packages/<name>.md` - Package-specific notes (optional)
+- `.sessions/plans/` - Implementation plans (can span packages)
+- `.sessions/archive/` - Completed work from all packages
+
+### Usage
+
+**Starting a session:**
+```bash
+/start-session
+# Claude reads root index.md and asks what you're working on
+```
+
+**Working across packages:**
+Reference related work in your session notes:
+```markdown
+## Current Work
+- Working on auth in app-a
+- Related: API changes in app-b (see .sessions/packages/app-b.md)
+```
+
+**Ending a session:**
+```bash
+/end-session
+# Updates root index.md with work across all packages
+```
+
+### Package-Specific Notes (Optional)
+
+Create `.sessions/packages/<package-name>.md` for detailed package context:
+- Deep technical decisions specific to that package
+- Package-specific architecture notes
+- Dependencies and interactions with other packages
+
+The root `index.md` ties everything together at a high level.