sequant 1.0.0

package/templates/memory/constitution.md

@@ -0,0 +1,60 @@
+# {{PROJECT_NAME}} Constitution
+
+This document defines the core principles and patterns for AI-assisted development in this project.
+
+## Core Principles
+
+1. **Quality First** - Never sacrifice code quality for speed
+2. **Test Everything** - All features must have appropriate test coverage
+3. **Document Decisions** - Important decisions should be captured in issue comments
+4. **Incremental Progress** - Break large tasks into small, reviewable chunks
+5. **Respect Existing Patterns** - Follow established project conventions
+
+## Workflow Phases
+
+### Phase 1: Planning (`/spec`)
+- Understand requirements and acceptance criteria
+- Identify potential risks and dependencies
+- Draft implementation plan for approval
+
+### Phase 2: Implementation (`/exec`)
+- Work in feature worktree
+- Follow established patterns
+- Keep commits atomic and well-described
+
+### Phase 3: Quality (`/qa`)
+- Review against acceptance criteria
+- Run all quality checks
+- Address feedback before merge
+
+## Code Standards
+
+### Naming Conventions
+- Use descriptive variable and function names
+- Follow language-specific conventions (camelCase, snake_case, etc.)
+
+### Error Handling
+- Handle errors gracefully
+- Log meaningful error messages
+- Don't swallow exceptions silently
+
+### Testing
+- Write tests for new features
+- Update tests when modifying existing code
+- Test edge cases and error paths
+
+## Commands Available
+
+| Command | Purpose |
+|---------|---------|
+| `/spec` | Plan implementation for an issue |
+| `/exec` | Implement a planned feature |
+| `/test` | Run browser-based UI tests |
+| `/qa` | Quality review before merge |
+| `/loop` | Fix iteration when tests fail |
+| `/docs` | Generate feature documentation |
+
+## Project-Specific Notes
+
+<!-- Add your project-specific guidelines below -->
+

package/templates/scripts/cleanup-worktree.sh

@@ -0,0 +1,78 @@
+#!/bin/bash
+
+# Clean up a worktree after PR is merged
+# Usage: ./scripts/cleanup-worktree.sh <branch-name>
+# Example: ./scripts/cleanup-worktree.sh feature/4-build-shop-detail-pages
+
+set -e
+
+# Colors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+BRANCH_NAME=$1
+
+# Check if branch name provided
+if [ -z "$BRANCH_NAME" ]; then
+    echo -e "${RED}❌ Error: Branch name required${NC}"
+    echo "Usage: ./scripts/cleanup-worktree.sh <branch-name>"
+    echo ""
+    echo "Active worktrees:"
+    git worktree list
+    exit 1
+fi
+
+# Find worktree path
+WORKTREE_PATH=$(git worktree list | grep "$BRANCH_NAME" | awk '{print $1}')
+
+if [ -z "$WORKTREE_PATH" ]; then
+    echo -e "${RED}❌ Error: Worktree not found for branch: $BRANCH_NAME${NC}"
+    echo ""
+    echo "Active worktrees:"
+    git worktree list
+    exit 1
+fi
+
+echo -e "${BLUE}🧹 Cleaning up worktree for: $BRANCH_NAME${NC}"
+echo -e "${BLUE}Path: $WORKTREE_PATH${NC}"
+echo ""
+
+# Check if PR is merged
+PR_STATUS=$(gh pr list --head "$BRANCH_NAME" --state merged --json number,state --jq '.[0].state' 2>/dev/null || echo "")
+
+if [ "$PR_STATUS" != "MERGED" ]; then
+    echo -e "${YELLOW}⚠️  Warning: PR for this branch is not merged${NC}"
+    read -p "Are you sure you want to delete this worktree? (y/n) " -n 1 -r
+    echo
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+        echo -e "${BLUE}Cancelled.${NC}"
+        exit 0
+    fi
+fi
+
+# Remove worktree
+echo -e "${BLUE}📂 Removing worktree...${NC}"
+git worktree remove "$WORKTREE_PATH" --force
+
+# Delete local branch
+echo -e "${BLUE}🌿 Deleting local branch...${NC}"
+git branch -D "$BRANCH_NAME" 2>/dev/null || true
+
+# Delete remote branch
+echo -e "${BLUE}☁️  Deleting remote branch...${NC}"
+git push origin --delete "$BRANCH_NAME" 2>/dev/null || true
+
+# Update main
+echo -e "${BLUE}📥 Updating main branch...${NC}"
+git checkout main
+git pull origin main
+
+echo ""
+echo -e "${GREEN}✅ Cleanup complete!${NC}"
+echo ""
+echo -e "${BLUE}🗂️  Remaining worktrees:${NC}"
+git worktree list
+echo ""

package/templates/scripts/list-worktrees.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+
+# List all active worktrees with their status
+# Usage: ./scripts/list-worktrees.sh
+
+# Colors
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+echo -e "${BLUE}🗂️  Active Worktrees${NC}"
+echo ""
+
+# Get worktree list
+WORKTREES=$(git worktree list --porcelain)
+
+# Parse and display
+echo "$WORKTREES" | awk '
+BEGIN {
+    path = ""
+    branch = ""
+    commit = ""
+}
+/^worktree / {
+    if (path != "") {
+        printf "📁 \033[0;32m%s\033[0m\n", path
+        printf "   Branch: \033[0;34m%s\033[0m\n", branch
+        printf "   Commit: %s\n\n", substr(commit, 1, 7)
+    }
+    path = substr($0, 10)
+}
+/^branch / {
+    branch = substr($0, index($0, "refs/heads/") + 11)
+}
+/^HEAD / {
+    commit = substr($0, 6)
+}
+END {
+    if (path != "") {
+        printf "📁 \033[0;32m%s\033[0m\n", path
+        printf "   Branch: \033[0;34m%s\033[0m\n", branch
+        printf "   Commit: %s\n\n", substr(commit, 1, 7)
+    }
+}'
+
+# Count
+WORKTREE_COUNT=$(git worktree list | wc -l | xargs)
+echo -e "${YELLOW}Total: $WORKTREE_COUNT worktree(s)${NC}"
+echo ""

package/templates/scripts/new-feature.sh

@@ -0,0 +1,156 @@
+#!/bin/bash
+
+# Create a new feature worktree from a GitHub issue
+# Usage: ./scripts/new-feature.sh <issue-number>
+# Example: ./scripts/new-feature.sh 4
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+BLUE='\033[0;34m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Check if issue number is provided
+if [ -z "$1" ]; then
+    echo -e "${RED}❌ Error: Issue number required${NC}"
+    echo "Usage: ./scripts/new-feature.sh <issue-number>"
+    echo "Example: ./scripts/new-feature.sh 4"
+    exit 1
+fi
+
+ISSUE_NUMBER=$1
+
+# Check if gh CLI is installed
+if ! command -v gh &> /dev/null; then
+    echo -e "${RED}❌ GitHub CLI not found. Install from: https://cli.github.com${NC}"
+    exit 1
+fi
+
+# Clear invalid GITHUB_TOKEN if set
+export GITHUB_TOKEN=""
+
+# Check if authenticated
+if ! gh auth status &> /dev/null; then
+    echo -e "${RED}❌ Not authenticated with GitHub. Run: unset GITHUB_TOKEN && gh auth login${NC}"
+    exit 1
+fi
+
+echo -e "${BLUE}📋 Fetching issue #${ISSUE_NUMBER}...${NC}"
+
+# Fetch issue details
+ISSUE_ERROR=$(mktemp)
+if ! ISSUE_DATA=$(gh issue view "$ISSUE_NUMBER" --json title,labels,number 2>"$ISSUE_ERROR"); then
+    echo -e "${RED}❌ Failed to fetch issue #${ISSUE_NUMBER}${NC}"
+    if [ -s "$ISSUE_ERROR" ]; then
+        echo -e "${YELLOW}   Error: $(cat "$ISSUE_ERROR")${NC}"
+    fi
+    rm -f "$ISSUE_ERROR"
+    exit 1
+fi
+rm -f "$ISSUE_ERROR"
+
+# Extract issue title and create branch name
+ISSUE_TITLE=$(echo "$ISSUE_DATA" | jq -r '.title')
+BRANCH_NAME=$(echo "$ISSUE_TITLE" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/--*/-/g' | sed 's/^-//' | sed 's/-$//')
+BRANCH_NAME="feature/${ISSUE_NUMBER}-${BRANCH_NAME}"
+
+# Truncate branch name if too long (max 50 chars after feature/)
+if [ ${#BRANCH_NAME} -gt 58 ]; then
+    BRANCH_NAME=$(echo "$BRANCH_NAME" | cut -c1-58)
+fi
+
+# Get the git repo root (works even if run from subdirectory)
+MAIN_REPO_DIR="$(git rev-parse --show-toplevel 2>/dev/null)"
+if [ -z "$MAIN_REPO_DIR" ]; then
+    echo -e "${RED}❌ Not in a git repository${NC}"
+    exit 1
+fi
+
+# Change to repo root for consistent behavior
+cd "$MAIN_REPO_DIR"
+
+# Worktree directory
+WORKTREE_DIR="../worktrees/${BRANCH_NAME}"
+
+echo -e "${GREEN}✨ Creating worktree for issue #${ISSUE_NUMBER}${NC}"
+echo -e "${BLUE}Branch: ${BRANCH_NAME}${NC}"
+echo -e "${BLUE}Worktree: ${WORKTREE_DIR}${NC}"
+echo ""
+
+# Check for uncommitted changes before switching branches
+if ! git diff-index --quiet HEAD -- 2>/dev/null; then
+    echo -e "${RED}❌ Working tree has uncommitted changes${NC}"
+    echo -e "${YELLOW}   Commit or stash your changes first:${NC}"
+    echo -e "   git stash push -m 'WIP before issue #${ISSUE_NUMBER}'"
+    exit 1
+fi
+
+# Check if branch already exists
+if git show-ref --verify --quiet "refs/heads/${BRANCH_NAME}"; then
+    echo -e "${YELLOW}⚠️  Branch ${BRANCH_NAME} already exists${NC}"
+
+    # Check if worktree exists too
+    EXISTING_WORKTREE=$(git worktree list | grep "${BRANCH_NAME}" | awk '{print $1}')
+    if [ -n "$EXISTING_WORKTREE" ]; then
+        echo -e "${GREEN}✅ Worktree already exists at: ${EXISTING_WORKTREE}${NC}"
+        echo -e "${BLUE}   cd ${EXISTING_WORKTREE}${NC}"
+        exit 0
+    else
+        echo -e "${RED}❌ Branch exists but no worktree found${NC}"
+        echo -e "${YELLOW}   To create worktree from existing branch:${NC}"
+        echo -e "   git worktree add ../worktrees/${BRANCH_NAME} ${BRANCH_NAME}"
+        echo -e "${YELLOW}   Or delete the branch first:${NC}"
+        echo -e "   git branch -D ${BRANCH_NAME}"
+        exit 1
+    fi
+fi
+
+# Update main branch
+echo -e "${BLUE}📥 Updating main branch...${NC}"
+git fetch origin main
+git checkout main
+git pull origin main
+
+# Create worktree
+echo -e "${BLUE}🌿 Creating new worktree...${NC}"
+git worktree add "$WORKTREE_DIR" -b "$BRANCH_NAME"
+
+# Navigate to worktree
+cd "$WORKTREE_DIR"
+
+# Copy .env.local if it exists (use absolute path from main repo)
+if [ -f "${MAIN_REPO_DIR}/.env.local" ]; then
+    echo -e "${BLUE}📋 Copying .env.local...${NC}"
+    cp "${MAIN_REPO_DIR}/.env.local" .env.local
+fi
+
+# Copy .claude/settings.local.json for auto-approved permissions
+if [ -f "${MAIN_REPO_DIR}/.claude/settings.local.json" ]; then
+    echo -e "${BLUE}📋 Copying .claude/settings.local.json...${NC}"
+    mkdir -p .claude
+    cp "${MAIN_REPO_DIR}/.claude/settings.local.json" .claude/settings.local.json
+fi
+
+# Install dependencies if needed
+if [ ! -d "node_modules" ]; then
+    echo -e "${BLUE}📦 Installing dependencies...${NC}"
+    npm install --silent
+fi
+
+echo ""
+echo -e "${GREEN}✅ Worktree created successfully!${NC}"
+echo ""
+echo -e "${YELLOW}📍 Next steps:${NC}"
+echo -e "  1. cd ${WORKTREE_DIR}"
+echo -e "  2. npm run dev"
+echo -e "  3. Work on issue #${ISSUE_NUMBER}: ${ISSUE_TITLE}"
+echo -e "  4. git add . && git commit -m \"Your message\""
+echo -e "  5. git push -u origin ${BRANCH_NAME}"
+echo -e "  6. ./scripts/create-pr.sh ${ISSUE_NUMBER}"
+echo ""
+echo -e "${BLUE}🗂️  Active worktrees:${NC}"
+git worktree list
+echo ""

package/templates/settings.json

@@ -0,0 +1,26 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/pre-tool.sh"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/post-tool.sh"
+          }
+        ]
+      }
+    ]
+  }
+}