Session Loader Skill

You load the feature specification and prepare the next implementation task at the start of each session.

When to Use This Skill

User asks to "implement spec" or "реализуй ТЗ"
User asks to "continue work" or "продолжи работу"
Starting a new session after /clear
User references a feature spec file

Workflow

Step 1: Identify Current Branch

git branch --show-current

If on master or main:

⚠️ Вы находитесь в защищённой ветке: {branch}

Для реализации фичи:
1. Запустите /plan для создания ТЗ и ветки
2. Или переключитесь на существующую feature-ветку:
   git checkout feature/{name}

STOP — do not proceed.

Step 2: Find Spec File

Convert branch name to spec path:

{branch-name} → .ai/specs/{branch-name}.md

Examples:

feature/user-auth → .ai/specs/feature-user-auth.md
bugfix/123-fix → .ai/specs/bugfix-123-fix.md

Check if file exists:

test -f .ai/specs/{branch-name}.md && echo "EXISTS" || echo "NOT FOUND"

If NOT FOUND:

❌ ТЗ не найдено для ветки: {branch}

Ожидаемый файл: .ai/specs/{branch-name}.md

Действия:
1. Запустите /plan для создания ТЗ
2. Или создайте файл вручную

STOP — do not proceed.

Step 3: Load and Parse Spec

Read the spec file and extract:

Feature name — from title
Current status — 🟡 В работе / ✅ Завершён
All stages — with their statuses
Next incomplete stage — first with ⬜ or 🔄

Step 4: Determine Next Task

Find the first stage that is:

⬜ Не начат, OR
🔄 В работе (resume)

If all stages are ✅:

✅ Все этапы завершены!

Фича готова к мержу.
Запустите: "merge в main" или используйте merge-helper

STOP — feature complete.

Step 5: Present Task to User

Output the session context:

📋 Загружено ТЗ: .ai/specs/{branch-name}.md
🌿 Ветка: {branch-name}

═══════════════════════════════════════════════════
📌 ТЕКУЩИЙ ЭТАП: {stage_number}. {stage_name}
═══════════════════════════════════════════════════

**Цель:** {stage_goal}

**Задачи:**
- [ ] Task 1
- [ ] Task 2
- [ ] Task 3

**Файлы:**
- `path/to/file1.py` (создать)
- `path/to/file2.py` (изменить)

**Критерий приёмки:** {acceptance_criteria}

═══════════════════════════════════════════════════

📊 Прогресс: {completed}/{total} этапов
[████████░░░░░░░░] {percent}%

Готов к реализации. Подтвердите начало работы.

Step 6: Update Stage Status

When user confirms, update spec file:

Change stage status: ⬜ → 🔄
Add timestamp to history table

Step 7: Execute Task

Implement the stage tasks:

Create/modify files as specified
Follow project conventions
Write tests if required
Keep changes ≤250 lines

Step 8: After Implementation

When stage is complete:

Run tests: uv run pytest
Use commit-helper for commit
Update spec file:
- Change stage status: 🔄 → ✅
- Check off completed tasks
- Add commit hash to history

Spec File Updates

Marking Stage In-Progress

### Этап 2: Service Layer (~150 строк)
**Статус:** 🔄 В работе  ← Changed from ⬜

Marking Stage Complete

### Этап 2: Service Layer (~150 строк)
**Статус:** ✅ Завершён  ← Changed from 🔄

**Задачи:**
- [x] Task 1  ← Checked
- [x] Task 2  ← Checked

History Entry

## История изменений

| Дата       | Этап | Коммит  | Описание                  |
| ---------- | ---- | ------- | ------------------------- |
| 2026-01-07 | 2    | abc1234 | Service layer implemented | ← New row |
| 2026-01-06 | 1    | def5678 | Models and schemas        |
| 2026-01-06 | -    | -       | ТЗ создано                |

Error Handling

Branch Mismatch

If spec branch doesn't match current branch:

⚠️ Несоответствие веток

Текущая ветка: feature/other-feature
ТЗ ветка: feature/user-auth

Переключитесь на нужную ветку:
git checkout feature/user-auth

Spec Corruption

If spec file is malformed:

⚠️ Ошибка парсинга ТЗ

Файл .ai/specs/{branch}.md повреждён или имеет неверный формат.

Проверьте структуру файла или создайте новый через /plan

References

See commit-helper for commit workflow. See plan-mode for spec creation.

session-loader