feat: [US-009] - Remove old Makefile targets and update documentation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Ralph Agent

CLAUDE.md

@@ -9,10 +9,16 @@ Super-opinionated Python stack for fast development. Python >= 3.12 required. Us
 ## Common Commands
 
 ```bash
-# Setup & Run
-make init name=... description=... # Initialize project name and description
-make setup          # Create/update .venv and sync dependencies
-make all            # Run main.py with setup
+# Onboarding & Setup
+make onboard        # Interactive onboarding CLI (rename, deps, env, hooks, media)
+# Or run individual steps:
+uv run python onboard.py rename  # Rename project
+uv run python onboard.py deps    # Install dependencies
+uv run python onboard.py env     # Configure environment variables
+uv run python onboard.py hooks   # Activate pre-commit hooks
+uv run python onboard.py media   # Generate banner/logo assets
+
+make all            # Sync deps and run main.py
 
 # Testing
 make test           # Run pytest on tests/

Makefile

@@ -36,19 +36,9 @@ help: ## Show this help message
 ########################################################
 
 ### Initialization
-.PHONY: init banner logo
-init: ## Initialize project (usage: make init name=my-project description="my description")
-	@if [ -z "$(name)" ] || [ -z "$(description)" ]; then \
-		echo "$(RED)Error: Both 'name' and 'description' parameters are required$(RESET)"; \
-		echo "Usage: make init name=<project_name> description=<project_description>"; \
-		exit 1; \
-	fi
-	@echo "$(YELLOW)🚀 Initializing project $(name)...$(RESET)"
-	@sed -i.bak "s/name = \"python-template\"/name = \"$(name)\"/" pyproject.toml && rm pyproject.toml.bak
-	@sed -i.bak "s/description = \"Add your description here\"/description = \"$(description)\"/" pyproject.toml && rm pyproject.toml.bak
-	@sed -i.bak "s/# Python-Template/# $(name)/" README.md && rm README.md.bak
-	@sed -i.bak "s/<b>Opinionated Python project stack. 🔋 Batteries included. <\/b>/<b>$(description)<\/b>/" README.md && rm README.md.bak
-	@echo "$(GREEN)✅ Updated project name and description.$(RESET)"
+.PHONY: onboard banner logo
+onboard: check_uv ## Run interactive onboarding CLI
+	@$(PYTHON) onboard.py
 
 banner: check_uv ## Generate project banner image
 	@echo "$(YELLOW)🔍Generating banner...$(RESET)"
@@ -84,31 +74,10 @@ check_jq:
 		jq --version; \
 	fi
 
-########################################################
-# Setup githooks for linting
-########################################################
-setup_githooks:
-	@echo "$(YELLOW)🔨Setting up githooks on post-commit...$(RESET)"
-	chmod +x .githooks/post-commit
-	git config core.hooksPath .githooks
-
-
 ########################################################
 # Python dependency-related
 ########################################################
 
-### Setup & Dependencies
-setup: check_uv ## Create venv and sync dependencies
-	@echo "$(YELLOW)🔎Looking for .venv...$(RESET)"
-	@if [ ! -d ".venv" ]; then \
-		echo "$(YELLOW)VS Code is not detected. Creating a new one...$(RESET)"; \
-		uv venv; \
-	else \
-		echo "$(GREEN)✅.venv is detected.$(RESET)"; \
-	fi
-	@echo "$(YELLOW)🔄Updating python dependencies...$(RESET)"
-	@uv sync
-
 view_python_venv_size:
 	@echo "$(YELLOW)🔍Checking python venv size...$(RESET)"
 	@PYTHON_VERSION=$$(cat .python-version | cut -d. -f1,2) && \
@@ -126,7 +95,8 @@ view_python_venv_size_by_libraries:
 ########################################################
 
 ### Running
-all: setup setup_githooks ## Setup and run main application
+all: check_uv ## Sync dependencies and run main application
+	@uv sync
 	@echo "$(GREEN)🏁Running main application...$(RESET)"
 	@$(PYTHON) main.py
 	@echo "$(GREEN)✅ Main application run completed.$(RESET)"

README.md

@@ -55,13 +55,23 @@ Opinionated Python stack for fast development. The `saas` branch extends `main`
 
 ## Quick Start
 
-- `make init name=my-project description="My project description"` - initialize project
-- `make all` - runs `main.py`
+- `make onboard` - interactive onboarding CLI (rename, deps, env, hooks, media)
+- `make all` - sync deps and run `main.py`
 - `make fmt` - runs `ruff format` + JSON formatting
-- `make banner` - create a new banner that makes the README nice 😊
+- `make banner` - create a new banner that makes the README nice
 - `make test` - runs all tests in `tests/`
 - `make ci` - runs all CI checks (ruff, vulture, ty, etc.)
 
+Individual onboarding steps can also be run directly:
+
+```bash
+uv run python onboard.py rename  # Rename project and update metadata
+uv run python onboard.py deps    # Install dependencies
+uv run python onboard.py env     # Configure environment variables
+uv run python onboard.py hooks   # Activate pre-commit hooks
+uv run python onboard.py media   # Generate banner and logo assets
+```
+
 
 
 ## Configuration