mirror of
https://github.com/daffy0208/ai-dev-standards.git
synced 2026-09-14 20:49:49 +08:00
204db226e5
BREAKING: Setup now automatically creates START-HERE.md with exact next steps This addresses user feedback: "I had to prompt this but I want this to start automatically when I start a new project after following the quick start guide" Changes: 1. scripts/analyze-project.sh (295 lines added): - Creates START-HERE.md with project-specific recommendations - Includes exact prompt to copy/paste to Claude - Lists priority tasks based on project stage (empty/early/growing/established) - Provides quick wins (15-min tasks with immediate value) - Framework-specific recommendations (React, Next.js, React Native) - Explains all 103 available resources - Auto-generated and can be deleted after use 2. setup-project.sh: - Adds START-HERE.md to .gitignore automatically - Updates final message to point users to START-HERE.md - Emphasizes: "Open START-HERE.md and follow the instructions" 3. META/relationship-mapping.json: - Updated scripts/analyze-project.sh: medium → high priority - Now depends on all 5 registries (was only skill-registry) - Updated statistics: high_priority_files 6 → 7, medium 8 → 7 User Experience: Before: 1. Run setup 2. User: "Ok, so where do we start with this project?" 3. Claude has to analyze and respond After: 1. Run setup 2. START-HERE.md automatically created with exact prompt 3. User copies prompt from file → immediate personalized guidance Example START-HERE.md contents: - Project Analysis (stage, health score, detected frameworks) - "START HERE - Tell Claude This" (exact prompt to copy) - Priority Tasks (1-3 priorities based on stage) - Quick Wins (small tasks with time estimates) - Framework-Specific Recommendations - What You Have Access To (103 resources explained) - Next Steps checklist Result: Users get immediate, actionable guidance without prompting
144 lines
4.4 KiB
Bash
144 lines
4.4 KiB
Bash
#!/bin/bash
|
|
|
|
#
|
|
# AI Dev Standards - Project Setup Script
|
|
#
|
|
# This script sets up ai-dev-standards in any project (new or existing).
|
|
# Works with the local installation (not published to npm yet).
|
|
#
|
|
# Usage:
|
|
# cd /path/to/your/project
|
|
# bash /path/to/ai-dev-standards/setup-project.sh
|
|
#
|
|
# Or from ai-dev-standards directory:
|
|
# ./setup-project.sh /path/to/your/project
|
|
#
|
|
|
|
set -e
|
|
|
|
# Colors
|
|
BLUE='\033[0;34m'
|
|
GREEN='\033[0;32m'
|
|
YELLOW='\033[1;33m'
|
|
RED='\033[0;31m'
|
|
GRAY='\033[0;90m'
|
|
NC='\033[0m' # No Color
|
|
|
|
# Get the directory where this script is located
|
|
SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
|
|
AI_DEV_STANDARDS_DIR="$SCRIPT_DIR"
|
|
|
|
# Get target project directory (default to current directory)
|
|
PROJECT_DIR="${1:-.}"
|
|
PROJECT_DIR="$(cd "$PROJECT_DIR" && pwd)"
|
|
|
|
echo -e "${BLUE}🚀 AI Dev Standards Setup${NC}\n"
|
|
|
|
# Check if ai-dev CLI is installed
|
|
echo -e "${BLUE}Checking installation...${NC}"
|
|
if ! command -v ai-dev &> /dev/null; then
|
|
echo -e "${YELLOW}⚠️ ai-dev CLI not found. Installing...${NC}\n"
|
|
|
|
cd "$AI_DEV_STANDARDS_DIR/CLI"
|
|
npm install
|
|
npm link
|
|
|
|
echo -e "${GREEN}✅ ai-dev CLI installed!${NC}\n"
|
|
else
|
|
echo -e "${GREEN}✅ ai-dev CLI already installed${NC}\n"
|
|
fi
|
|
|
|
# Navigate to project
|
|
cd "$PROJECT_DIR"
|
|
|
|
echo -e "${BLUE}Setting up project: ${PROJECT_DIR}${NC}\n"
|
|
|
|
# Check if project is already initialized
|
|
if [ -f ".ai-dev.json" ]; then
|
|
echo -e "${GREEN}✅ Project already initialized${NC}\n"
|
|
echo -e "${BLUE}🔄 Running sync...${NC}\n"
|
|
ai-dev sync --yes
|
|
else
|
|
# Detect project type and recommend template
|
|
echo -e "${BLUE}📋 Selecting template...${NC}"
|
|
|
|
TEMPLATE="cursorrules-minimal.md"
|
|
|
|
if [ -f "package.json" ]; then
|
|
if grep -q "next" package.json 2>/dev/null; then
|
|
TEMPLATE="cursorrules-saas.md"
|
|
echo -e "${GRAY} Detected: Next.js project${NC}"
|
|
elif grep -q "react" package.json 2>/dev/null; then
|
|
TEMPLATE="cursorrules-saas.md"
|
|
echo -e "${GRAY} Detected: React project${NC}"
|
|
fi
|
|
fi
|
|
|
|
if [ -d ".git" ] && [ "$(find . -name '*.ts' -o -name '*.js' | wc -l)" -gt "10" ]; then
|
|
TEMPLATE="cursorrules-existing-project.md"
|
|
echo -e "${GRAY} Detected: Existing project${NC}"
|
|
fi
|
|
|
|
echo -e "${GRAY} Using template: $TEMPLATE${NC}\n"
|
|
|
|
# Copy template
|
|
if [ ! -f ".cursorrules" ]; then
|
|
cp "$AI_DEV_STANDARDS_DIR/TEMPLATES/$TEMPLATE" .cursorrules
|
|
echo -e "${GREEN}✅ Created .cursorrules${NC}"
|
|
|
|
# Update path in .cursorrules to absolute path
|
|
if [[ "$OSTYPE" == "darwin"* ]] || [[ "$OSTYPE" == "linux-gnu"* ]]; then
|
|
sed -i.bak "s|~/ai-dev-standards/|$AI_DEV_STANDARDS_DIR/|g" .cursorrules
|
|
sed -i.bak "s|/path/to/ai-dev-standards/|$AI_DEV_STANDARDS_DIR/|g" .cursorrules
|
|
rm .cursorrules.bak
|
|
fi
|
|
else
|
|
echo -e "${YELLOW}⚠️ .cursorrules already exists, skipping${NC}"
|
|
fi
|
|
|
|
# Initialize sync
|
|
echo -e "\n${BLUE}🔄 Initializing ai-dev sync...${NC}\n"
|
|
ai-dev sync --yes
|
|
|
|
echo -e "${GREEN}✅ Setup complete!${NC}\n"
|
|
fi
|
|
|
|
# Run project analysis
|
|
echo -e "${BLUE}🔍 Analyzing your project...${NC}\n"
|
|
if [ -x "$AI_DEV_STANDARDS_DIR/scripts/analyze-project.sh" ]; then
|
|
"$AI_DEV_STANDARDS_DIR/scripts/analyze-project.sh" "$PROJECT_DIR"
|
|
|
|
# Add START-HERE.md to .gitignore if it exists
|
|
if [ -f ".gitignore" ]; then
|
|
if ! grep -q "START-HERE.md" .gitignore; then
|
|
echo "START-HERE.md" >> .gitignore
|
|
echo -e "${GRAY} Added START-HERE.md to .gitignore${NC}"
|
|
fi
|
|
fi
|
|
else
|
|
echo -e "${YELLOW}⚠️ Analysis script not found, skipping analysis${NC}"
|
|
fi
|
|
|
|
echo ""
|
|
|
|
# Show summary
|
|
echo -e "${BLUE}📊 Summary:${NC}"
|
|
echo -e "${GRAY} Project: $PROJECT_DIR${NC}"
|
|
echo -e "${GRAY} Standards: $AI_DEV_STANDARDS_DIR${NC}"
|
|
echo -e "${GRAY} Template: $TEMPLATE${NC}"
|
|
|
|
# Check what was installed
|
|
if [ -f ".ai-dev.json" ]; then
|
|
SKILLS_COUNT=$(grep -o "\"skills\": \[" .ai-dev.json | wc -l)
|
|
echo -e "${GRAY} Resources: Available via registries${NC}"
|
|
fi
|
|
|
|
echo ""
|
|
echo -e "${GREEN}${BOLD}✨ Setup Complete!${NC}\n"
|
|
echo -e "${BLUE}📚 What to do next:${NC}"
|
|
echo ""
|
|
echo -e "${YELLOW} 👉 Open START-HERE.md and follow the instructions${NC}"
|
|
echo -e "${GRAY} It contains your personalized roadmap and exact prompt for Claude${NC}"
|
|
echo ""
|
|
echo -e "${GREEN}✅ All 37 skills, 34 MCPs, and 103 resources are now available!${NC}\n"
|