bootstrap

name	bootstrap
description	Idempotent project setup — fresh install, update, or verify via convergence engine
version	5.1.0
allowed-tools	["Read","Write","Edit","Bash","Grep","Glob"]
trigger	프로젝트 초기화, 프로젝트 셋업, 처음 설정, 업데이트, 갱신, project setup, initialize project, after cloning, update, refresh

Quick Reference

• 시작: bash .hxsk/scripts/bootstrap.sh (멱등 — 반복 실행 안전)
• 모드: fresh(초기) / verify(검증) / update(갱신) — .hxsk/.bootstrap-version으로 자동 감지
• Output: [NEW] [UPDATED] [OK] [PASS] [FAIL] [WARN] [SKIP] 태그
• 2-hop: [NEW]/[UPDATED] 항목에 관련 컴포넌트 자동 표시
• 메모리 저장: md-store-memory.sh 로 .hxsk/memories/bootstrap/에 기록

---

Skill: Bootstrap

Goal: Idempotent project setup — detect state, converge to target, report delta. Scope: 순수 bash 스크립트 기반. 외부 종속성 없음. 모든 에이전트에서 실행 가능.

You are a bootstrap orchestrator. Your job is to make an HExoskeleton project fully operational, whether it's a fresh clone or an existing installation being updated.

Core responsibilities:

• Detect install mode (fresh / verify / update) via .hxsk/.bootstrap-version
• Verify system prerequisites and project structure
• Report changes with [NEW]/[UPDATED]/[OK] tags
• Provide 2-hop context for new or changed components
• Store bootstrap state in .hxsk/memories/

---

Procedure

Step 0: 모드 감지

test -f .hxsk/.bootstrap-version && echo "EXISTS" || echo "FRESH"

• 파일 없음 → 초기 설치 모드. Step 1~7 전체 실행.
• 파일 있음 → bash .hxsk/scripts/bootstrap.sh 실행. 스크립트가 자동으로 verify/update 판별.
  • 모든 항목 [OK] → 완료
  • [NEW]/[UPDATED] 있음 → Step 6 (메모리 저장) + Step 7 (보고) 실행

---

Step 1: System Prerequisites Check

Run the idempotent convergence engine:

bash .hxsk/scripts/bootstrap.sh

bootstrap.sh v5.1.0 출력 태그:

• [NEW] — 새로 생성된 컴포넌트 (↳ 관련: 2-hop 컨텍스트)
• [UPDATED] — 변경 감지된 컴포넌트 (↳ 관련: 2-hop 컨텍스트)
• [OK] — 변경 없음, 정상
• [PASS] — 시스템 요구사항 충족
• [FAIL] — 필수 요구사항 미충족
• [WARN] — 선택 요구사항 미충족
• [SKIP] — 해당 없음

If exit code 1: STOP. Display the failing checks and provide installation instructions.

If exit code 0: Continue. .hxsk/.bootstrap-version 자동 생성/갱신됨.

---

Step 2: Environment Setup

Copy .env.example to .env if .env does not already exist:

if [ ! -f .env ]; then
    cp .env.example .env
    echo "Created .env from .env.example"
else
    echo ".env already exists"
fi

bootstrap.sh가 이미 이 작업을 수행합니다. Step 1에서 [NEW] .env가 출력되었으면 건너뛰세요.

---

Step 3: Memory Directory Verification

Verify .hxsk/memories/ 디렉토리 구조:

ls .hxsk/memories/ | wc -l  # 14 directories + _schema expected

If missing: Create directories:

mkdir -p .hxsk/memories/{architecture-decision,root-cause,debug-eliminated,debug-blocked,health-event,session-handoff,execution-summary,deviation,pattern-discovery,bootstrap,session-summary,session-snapshot,security-finding,general,_schema}

bootstrap.sh가 이미 이 작업을 수행합니다. Step 1에서 [NEW] .hxsk/memories/가 출력되었으면 건너뛰세요.

---

Step 4: Context Structure Initialization

Verify context management structure:

.hxsk/
├── reports/           # Analysis reports (REPORT-*.md)
├── research/          # Research documents (RESEARCH-*.md)
├── archive/           # Monthly archives
├── issues/archive/    # Completed issue archive
├── PATTERNS.md        # Core patterns (2KB limit)
└── context-config.yaml # Cleanup rules

bootstrap.sh가 자동 생성합니다.

---

Step 5: Codebase Analysis

Delegate to the codebase-mapper skill to analyze the project:

• .hxsk/ARCHITECTURE.md
• .hxsk/STACK.md

If codebase-mapper fails: Mark FAIL. Continue to Step 6.

---

Step 6: Memory Storage

Store the bootstrap record:

bash .hxsk/hooks/md-store-memory.sh \
  "Project Bootstrap" \
  "Bootstrap completed. System prerequisites verified. Memory initialized." \
  "bootstrap,init,setup" \
  "bootstrap" \
  "bootstrap,init,setup,project" \
  "Initial project bootstrap completed successfully"

If memory store fails: Mark WARN. Continue to Step 7.

---

Step 7: Status Report

bootstrap.sh가 이미 구조화된 보고서를 출력합니다:

================================================================
 BOOTSTRAP v5.1.0
 MODE: fresh | verify | update (vX.X.X → v5.1.0)
================================================================
...
 MODE: {mode}  |  PASS: N  FAIL: N  WARN: N  SKIP: N  NEW: N  UPDATED: N
 RESULT: ALL REQUIRED CHECKS PASSED / FAILED
================================================================

RESULT = PASSED → 프로젝트 READY. RESULT = FAILED → NEEDS ATTENTION.

---

Error Handling

Error	Action
System prerequisite missing	STOP at Step 1. Print install commands
Memory directory missing	Auto-create (bootstrap.sh handles)
Schema files missing	Copy from templates or create minimal versions
codebase-mapper fails	FAIL the step, continue
Memory store fails	WARN the step, continue

---

Scripts

• .hxsk/scripts/bootstrap.sh: Idempotent convergence engine (fresh/verify/update 3-mode)
• .hxsk/scripts/detect-language.sh: Language, package manager detection functions (optional)