refactor(build): modernize tooling automation with spec-kit and agent-os

- Replace Python venv-based speckit with specify CLI (spec-kit target)
- Add agent-os installation with configurable agent selection
- Add Docker-based project initialization workflow (init target)
- Add interactive help system with color-coded command descriptions
- Remove semver validation logic in favor of simplified installation

BREAKING CHANGE: Removed speckit-install, speckit-init, speckit-check,
speckit-clean targets. Use 'make spec-kit' instead.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: kimchanhyung98

Makefile

@@ -1,41 +1,63 @@
-PYTHON ?= python3
-VENV ?= .venv
-PIP := $(VENV)/bin/pip
-SPECKIT_VERSION ?=
-SPECKIT_BIN := $(VENV)/bin/speckit
-SPECKIT_SPEC := speckit
-# Semver-like: major.minor.patch with optional dot-separated pre-release identifiers (numeric identifiers are allowed).
-SPECKIT_SEMVER_REGEX := ^[0-9]+\.[0-9]+\.[0-9]+(-[A-Za-z0-9]+(\.[A-Za-z0-9]+)*)?$$
-SPECKIT_VERSION_CLEAN := $(strip $(SPECKIT_VERSION))
-SPECKIT_VERSION_VALID := $(if $(SPECKIT_VERSION_CLEAN),$(shell echo "$(SPECKIT_VERSION_CLEAN)" | grep -E '$(SPECKIT_SEMVER_REGEX)' >/dev/null && echo valid),valid)
-
-ifneq ($(SPECKIT_VERSION_CLEAN),)
-# Require a semver-like value; optional suffix is dot-separated alphanumeric identifiers.
-ifneq ($(findstring ..,$(SPECKIT_VERSION_CLEAN)),)
-$(error SPECKIT_VERSION cannot contain consecutive dots)
-endif
-ifneq ($(SPECKIT_VERSION_VALID),valid)
-$(error SPECKIT_VERSION must be semver-like (e.g., 0.2.0 or 1.2.3-rc.1; suffix is dot-separated alphanumeric identifiers))
-endif
-SPECKIT_SPEC := speckit==$(SPECKIT_VERSION_CLEAN)
-endif
-
-.PHONY: speckit-install speckit-init speckit-check speckit-clean
-
-$(VENV)/bin/python:
-	$(PYTHON) -m venv $(VENV)
-	$(PIP) install --upgrade pip setuptools wheel
-
-$(SPECKIT_BIN): $(VENV)/bin/python
-	$(PIP) install $(SPECKIT_SPEC)
-
-speckit-install: $(SPECKIT_BIN)
-
-speckit-init: $(SPECKIT_BIN)
-	$(SPECKIT_BIN) init
-
-speckit-check: $(SPECKIT_BIN)
-	$(SPECKIT_BIN) check
-
-speckit-clean:
-	rm -rf $(VENV)
+.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
+
+%:
+	@: