session-create

Files (1)

• SKILL.md

SKILL.md (first lines)

# Session Create

Create a new aigentry ecosystem project with full session bootstrapping in one shot.

## Why This Exists

Every new aigentry project needs the same 7 steps. Missing any one causes problems — orphan windows, missing CLAUDE.md, telepty not connected, grid misaligned. This skill ensures nothing is forgotten.

## Arguments

The user provides the project name (without `aigentry-` prefix). Examples:
- "design" → `aigentry-design`
- "forum" → `aigentry-forum`
- "aterm" → `aigentry-aterm`

If no name is provided, ask the user.

## Prerequisites

`$AIGENTRY_ORCH_DIR` = your aigentry orchestrator project root (cloned by `aigentry-devkit setup --profile orchestrator`); `$AIGENTRY_PROJECTS_ROOT` = where your `aigentry-*` repos live. Both resolve the same way `install.sh` does, so unset is fine — Step 1 derives the defaults.

Steps 4/5/7 execute scripts that live in the orchestrator repo. If `$ORCH_DIR` does not exist (you don't run an aigentry orchestrator), skip those three steps and spawn the session with your terminal's own tooling — steps 1-3, 6 and 8 still apply.

## Workflow

Execute ALL 7 steps in order. Do not skip any.

### Step 1: Validate & Create Folder

```bash
NAME="<user-provided-name>"
PROJECTS_ROOT="${AIGENTRY_PROJECTS_ROOT:-$HOME/projects}"
ORCH_DIR="${AIGENTRY_ORCH_DIR:-$PROJECTS_ROOT/aigentry-orchestrator}"
PROJECT_DIR="$PROJECTS_ROOT/aigentry-${NAME}"
SESSION_ID="aigentry-${NAME}-claude"

# Check if already exists
if [ -d "$PROJECT_DIR" ]; then
  echo "⚠️ Folder already exists: $PROJECT_DIR"
  # Ask user: continue with existing folder or abort?
fi

mkdir -p "$PROJECT_DIR"
```

### Step 2: Generate CLAUDE.md

Write a CLAUDE.md to `$PROJECT_DIR/CLAUDE.md` with:

```markdown
# aigentry-{name}

이 프로젝트는 aigentry 에코시스템의 **{role description}** 입니다.

## 에코시스템 위치
- 오케스트레이터: aigentry-orchestrator-claude
- 통신: telepty inject/reply

## 통신 방법
- 오케스트레이터에게 보고: `telepty reply "내용"`
- 다른 세션에 요청: `telepty inject --from {session_id} <target> "내용"`
- 브로드캐스트 수신 시 응답 필수

## 자율 재귀적 오케스트레이션
작업 복잡도가 높거나 독립 도메인이 식별되면 자율적으로:
1. 하위 폴더 생성
2. CLAUDE.md 작성
3. telepty allow로 하위 세션 생성
4. 하위 세션 오케스트레이션

## 주요 명령어
- 빌드: (프로젝트에 맞게 작성)
- 테스트: (프로젝트에 맞게 작성)
```

The role description should be inferred from the project name, or ask the user if unclear.

### Step 3: Request Devkit Bootstrap

```bash
telepty inject --from aigentry-orchestrator-claude aigentry-devkit-claude \
  "${PROJECT_DIR}/ 프로젝트에 .claude/settings.json 생성해주세요. MCP 설정(deliberation, brain) + 권한 설정 포함."
```

Do not wait for devkit response — continue to next step.

### Step 4: Check & Clean Orphan Windows

```bash
# Cross-terminal orphan teardown — delegate to the atomic script layer.
# session-cleanup.sh routes to wh_close_for_sid (cmux lookup falls back to
# title==sid), so a stale surface named $SESSION_ID is closed on ANY host
# (cmux/aterm/tmux/wezterm/iterm/warp/headless). Idempotent no-op if none.
if telepty list 2>/dev/null | grep -q "${SESSION_ID}"; then
  "$ORCH_DIR/bin/session-cleanup.sh" "${SESSION_ID}" || true
fi
```

### Step 5: Spawn Session (terminal-agnostic)

```bash
# Terminal-agnostic spawn — delegate to open-session.sh, which auto-detects the
# host terminal (cmux/aterm/tmux/wezterm/iterm/warp/headless), spawns a VISIBLE
# foreground surface in the orchestrator's own terminal, wraps the CLI in
# `telepty allow --id <sid> --auto-restart`, and blocks on a readiness gate.
# SID convention: open-session.sh derives sid = "<track>-<name>", so
# --track aigentry --name "${NAME}-claude" yields sid = "${SESSION_ID}".
# NEVER hardcode kitty/cmux here.
"$ORCH_DIR/bin/open-session.sh" \
  --track aigentry \
  --name "${NAME}-claude" \
  --cwd "${PROJECT_DIR}" \
  --cli claude
```

### Step 6: Verify Registration

```bash
sleep 3

From dmsdc-ai/aigentry-devkit, MIT.

More from dmsdc-ai/aigentry-devkit