chore(build): automate Speckit installation with Make targets

Makefile

@@ -0,0 +1,63 @@
+.PHONY: spec-kit agent-os help init
+
+.DEFAULT_GOAL := help
+
+help: ## Show available commands
+	@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n  make \033[36m<target>\033[0m\n\nTargets:\n"} /^[a-zA-Z_-]+:.*?##/ { printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
+
+spec-kit: ## Install spec-kit (default: claude)
+	@agent=$(word 2,$(MAKECMDGOALS)); \
+	if [ -z "$$agent" ]; then \
+		agent="claude"; \
+		echo "Using default agent: claude"; \
+	fi; \
+	if ! command -v specify >/dev/null 2>&1; then \
+		echo "[spec-kit] 'specify' not found."; \
+		echo "RUN: uv tool install specify-cli --from git+https://github.com/github/spec-kit.git"; \
+		exit 1; \
+	fi; \
+	yes | specify init --here --ai $$agent --script sh
+
+agent-os: ## Install agent-os (default: claude)
+	@agent=$(word 2,$(MAKECMDGOALS)); \
+	script="$$HOME/agent-os/scripts/project-install.sh"; \
+	if [ -z "$$agent" ]; then \
+		agent="claude"; \
+		echo "Using default agent: claude"; \
+	fi; \
+	if [ ! -f "$$script" ]; then \
+		echo "[agent-os] 'agent-os' not found."; \
+		echo "RUN: curl -sSL https://raw.githubusercontent.com/buildermethods/agent-os/main/scripts/base-install.sh | bash"; \
+		exit 1; \
+	fi; \
+	echo "Installing agent-os with agent: $$agent"; \
+	if [ "$$agent" = "claude" ]; then \
+		yes | bash "$$script"; \
+	elif [ "$$agent" = "all" ]; then \
+		yes | bash "$$script" --agent-os-commands true --standards-as-claude-code-skills true; \
+	else \
+		yes | bash "$$script" --claude-code-commands false --use-claude-code-subagents false --standards-as-claude-code-skills true --agent-os-commands true; \
+	fi
+
+init: ## Setup Project environment (Docker required)
+	@if ! command -v docker >/dev/null 2>&1; then \
+		echo "[init] 'docker' not found"; \
+		exit 1; \
+	fi; \
+	if ! docker compose version >/dev/null 2>&1; then \
+		echo "[init] 'docker compose' not found"; \
+		exit 1; \
+	fi; \
+	if [ ! -f .env ]; then \
+		echo "Copying .env.example to .env"; \
+		cp .env.example .env; \
+	fi; \
+	echo "Starting Docker containers"; \
+	docker compose up -d; \
+	echo "Installing npm packages"; \
+	docker run --rm -v $$(pwd):/app -w /app node:22-alpine npm install; \
+	echo "Running database migrations and seeders"; \
+	docker compose exec laravel.test php artisan migrate --seed
+
+%:
+	@:

README.md

@@ -1 +1,52 @@
-# base
+# base
+
+## Speckit 사용 방법 / Quick Guide
+
+Speckit CLI를 프로젝트 내에서 동일하게 사용할 수 있도록 Makefile로 래핑했습니다. Python 3와 make만 있으면 됩니다.
+
+Speckit commands are wrapped in the Makefile so you can install and run them consistently with only Python 3 and make.
+
+### 설치
+
+로컬 가상환경(`.venv`)에 Speckit을 설치합니다. 필요 시 버전을 고정해 사용할 수 있습니다.
+
+```bash
+# 최신 버전
+make speckit-install
+
+# 특정 버전 설치
+SPECKIT_VERSION=0.2.0 make speckit-install
+
+# 사용 가능한 버전 확인 (예시)
+pip index versions speckit
+```
+
+### 초기화 및 검증
+
+```bash
+# 초기 설정 (예: 템플릿 생성)
+make speckit-init
+
+# 규칙 검증
+make speckit-check
+```
+
+### 정리
+
+```bash
+make speckit-clean
+```
+
+### CI/워크플로우 예시 (옵션)
+
+CI에서 동일한 명령을 재사용할 수 있습니다.
+
+```yaml
+steps:
+  - uses: actions/checkout@v4
+  - uses: actions/setup-python@v5
+    with:
+      python-version: '3.x'
+  - run: make speckit-install
+  - run: make speckit-check
+```