Skip to content

Fix session names to use repo-number-slug convention #82

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dhilgaertner merged 2 commits into from
Apr 5, 2026
Merged

Fix session names to use repo-number-slug convention #82

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0a1fc59
Fix session names to use repo-number-slug convention
dhilgaertner Apr 5, 2026
0470c06
Merge branch 'main' into feature/crow-79-session-naming
dhilgaertner Apr 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 16 additions & 5 deletions skills/crow-workspace/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -197,12 +197,23 @@ git -C {repo_path} worktree add {path} \

All `crow` commands require `dangerouslyDisableSandbox: true`.

### Session Naming Convention

The session name **MUST** match the worktree directory name (which is the branch slug without the `feature/` prefix):

- **Ticket-based:** `{repo}-{ticket_number}-{slug}` (e.g., `crow-51-drag-drop-photo`)
- **PR-based:** `{repo}-{pr_branch_slug}` (e.g., `citadel-45-jwt-validation`)
- **Natural language:** `{repo}-{feature-slug}` (e.g., `citadel-update-auth`)

This keeps session names, worktree paths, and branch names consistent.

### Complete Step-by-Step Flow

```bash
# 1. Create session (parse session_id from JSON output)
crow new-session --name "{feature_name}"
# Output: {"session_id":"<uuid>","name":"feature_name"}
# The name MUST match the worktree directory name
crow new-session --name "{repo}-{ticket_number}-{slug}"
# Output: {"session_id":"<uuid>","name":"crow-51-drag-drop-photo"}

# 2. Set ticket metadata (only if URL was provided)
crow set-ticket --session {session_id} \
Expand Down Expand Up @@ -259,7 +270,7 @@ gh issue edit {ticket_url} --add-assignee @me
# IMPORTANT: Write to {devRoot}/.claude/prompts/ — NOT $TMPDIR (which differs per session)
# The prompt MUST start with /plan to enter plan mode
mkdir -p {devRoot}/.claude/prompts
cat > {devRoot}/.claude/prompts/crow-prompt-{feature_name}.md << 'PROMPT'
cat > {devRoot}/.claude/prompts/crow-prompt-{session_name}.md << 'PROMPT'
{prompt content — see template below}
PROMPT

Expand All @@ -282,14 +293,14 @@ sleep 3
# Use single quotes so the shell doesn't expand $(cat ...).
# Use --permission-mode plan to start Claude in plan mode.
# Use full path to claude binary.
crow send --session {session_id} --terminal {terminal_id} 'cd {primary_worktree_path} && {claude_binary_path} --permission-mode plan "$(cat {devRoot}/.claude/prompts/crow-prompt-{feature_name}.md)"\n'
crow send --session {session_id} --terminal {terminal_id} 'cd {primary_worktree_path} && {claude_binary_path} --permission-mode plan "$(cat {devRoot}/.claude/prompts/crow-prompt-{session_name}.md)"\n'
```

## First Prompt Template

IMPORTANT: Always use full absolute paths, never abbreviated (`...`) or home-relative (`~`) paths.

The prompt is written to `{devRoot}/.claude/prompts/crow-prompt-{feature_name}.md`. It starts with `/plan` to enter plan mode.
The prompt is written to `{devRoot}/.claude/prompts/crow-prompt-{session_name}.md`. It starts with `/plan` to enter plan mode.

**Repo descriptions for the prompt table:**

Expand Down
Loading