gh-anthemflynn-ccmp-plugins-session-management/skills/session-management/references/config-reference.md

Configuration Reference

Complete reference for .session/config.yaml configuration options.

Session Configuration

session:
  auto_track: true
  auto_checkpoint: false
  checkpoint_interval: 30m
  handoff_on_end: true
  archive_after_days: 30

auto_track

Type: boolean
Default: true
Description: Automatically track file changes during session

auto_checkpoint

Type: boolean
Default: false
Description: Create automatic checkpoints at intervals

checkpoint_interval

Type: string
Default: 30m
Description: Interval for automatic checkpoints (30m, 1h, etc.)

handoff_on_end

Type: boolean
Default: true
Description: Generate handoff document when ending session

archive_after_days

Type: integer
Default: 30
Description: Archive completed sessions after N days

---

Context Configuration

context:
  architecture: hexagonal
  patterns:
    - ports-and-adapters
    - repository-pattern
  conventions:
    - type-hints-required
    - docstrings-required

architecture

Type: string
Options: hexagonal, layered, microservices, mvc, clean, ddd
Description: Primary architecture pattern for the project

patterns

Type: list of strings
Description: Code patterns to detect and enforce
Common values:

• ports-and-adapters
• repository-pattern
• dependency-injection
• factory-pattern
• cqrs
• event-sourcing

conventions

Type: list of strings
Description: Project conventions
Common values:

• type-hints-required
• docstrings-required
• snake-case
• pep8-compliant
• test-coverage-required

---

Tracking Configuration

tracking:
  watch_patterns:
    - "src/**/*.py"
    - "tests/**/*.py"
  ignore_patterns:
    - "**/__pycache__/**"
    - "**/node_modules/**"
  annotations:
    - "TODO:"
    - "FIXME:"
    - "DECISION:"

watch_patterns

Type: list of glob patterns
Description: Files to watch for changes

ignore_patterns

Type: list of glob patterns
Description: Files to ignore

annotations

Type: list of strings
Description: Code annotations to track

---

Quality Configuration

quality:
  coverage_threshold: 85
  new_code_coverage_threshold: 90
  require_tests: true
  block_merge_on_quality: true

coverage_threshold

Type: integer (0-100)
Default: 85
Description: Minimum overall test coverage percentage

new_code_coverage_threshold

Type: integer (0-100)
Default: 90
Description: Minimum coverage for new code

require_tests

Type: boolean
Default: true
Description: Require tests for new features

block_merge_on_quality

Type: boolean
Default: true
Description: Prevent merge if quality thresholds not met

---

Display Configuration

display:
  color: true
  verbose: false
  emoji: true
  date_format: "%Y-%m-%d %H:%M"

color

Type: boolean
Default: true
Description: Use colored terminal output

verbose

Type: boolean
Default: false
Description: Enable verbose output by default

emoji

Type: boolean
Default: true
Description: Use emoji in output

date_format

Type: string
Default: "%Y-%m-%d %H:%M"
Description: Date/time format string (Python strftime format)

---

Complete Example

# Session Management Configuration

session:
  auto_track: true
  auto_checkpoint: false
  checkpoint_interval: 30m
  handoff_on_end: true
  archive_after_days: 30

context:
  architecture: hexagonal
  patterns:
    - ports-and-adapters
    - repository-pattern
    - dependency-injection
  conventions:
    - type-hints-required
    - docstrings-required
    - snake-case
    - max-line-length-100

tracking:
  watch_patterns:
    - "src/**/*.py"
    - "tests/**/*.py"
    - "docs/**/*.md"
  ignore_patterns:
    - "**/__pycache__/**"
    - "**/.venv/**"
    - "**/dist/**"
  annotations:
    - "TODO:"
    - "FIXME:"
    - "DECISION:"
    - "BLOCKER:"

quality:
  coverage_threshold: 85
  new_code_coverage_threshold: 90
  require_tests: true
  block_merge_on_quality: true

display:
  color: true
  verbose: false
  emoji: true
  date_format: "%Y-%m-%d %H:%M"