# Sessions Init

> Organize and synchronize session directory structure based on project architecture

- Skill: `manastalukdar/sessions-init` (Agent Skill)
- Install (CLI): `npx skillmds@latest add manastalukdar/sessions-init`
- Raw SKILL.md: https://api.skillmd.com/api/skills/manastalukdar/sessions-init/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: manastalukdar (https://skillmd.com/u/manastalukdar)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/manastalukdar/sessions-init

---


# Procedure for Organizing Claude Session Directories:

1. Analyze the Project
   - Perform a thorough analysis of the project's codebase and overall architecture to understand its components.
2. Define the Directory Structure
   - Based on your analysis, create a flat or hierarchical list of the project's key features and product areas. This list will serve as the blueprint for your session directory structure.
3. Synchronize Directories in `.claude/sessions`
Once you have the ideal structure defined, navigate to the `.claude/sessions` directory and perform the following actions:
   - Reconcile Existing Directories: Compare the current sub-directories against your new blueprint.
     - Rename, move, or delete existing directories to match the new structure.
     - Relocate session files from any old or incorrect directories into their proper new locations.
   - Create New Directories: For any features or areas in your blueprint that do not yet have a corresponding directory, create them now.
4. Ensure Directory Persistence
   - In any sub-directory that is empty (whether newly created or after moving files), add a `.gitkeep` file. This ensures the directory structure is committed to version control.
5. Add or update `.claude/sessions/README.md` as relevant.

---

## Token Optimization

**Expected range**: 100–400 tokens (initial), 50 tokens (already initialized)

**Caching**: Caches init state in `.claude/sessions/.init_cache.json` for 7 days.

**Early exit**: Returns immediately if session tracking is already initialized.

**Patterns used**: Grep-before-Read, early exit, caching