ai-sprint-kit 1.3.1 → 2.0.0

package/templates/.claude/skills/quality-assurance/scripts/check-size.py

@@ -1,333 +0,0 @@
-#!/usr/bin/env python3
-"""
-Design principles size checker.
-Detects files >500 lines and functions >50 lines.
-Supports: Python, JavaScript, TypeScript, Go, Java, Rust
-Exit code: 0 = no violations (pass), 1 = violations found (warn only)
-"""
-
-import argparse
-import ast
-import os
-import re
-import sys
-from pathlib import Path
-from dataclasses import dataclass
-from typing import List
-
-@dataclass
-class Violation:
-    file: str
-    line: int
-    type: str  # 'file' or 'function'
-    name: str
-    actual: int
-    limit: int
-
-
-def count_file_lines(path: Path) -> int:
-    """Count non-empty, non-comment lines."""
-    try:
-        with open(path, 'r', encoding='utf-8', errors='ignore') as f:
-            lines = [l for l in f.readlines() if l.strip()
-                     and not l.strip().startswith(('#', '//', '--', '/*', '*'))]
-            return len(lines)
-    except Exception:
-        return 0
-
-
-def check_python_functions(path: Path, max_lines: int) -> List[Violation]:
-    """Check Python function lengths using AST."""
-    violations = []
-    try:
-        with open(path, 'r', encoding='utf-8') as f:
-            tree = ast.parse(f.read())
-        for node in ast.walk(tree):
-            if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)):
-                length = (node.end_lineno or node.lineno) - node.lineno + 1
-                if length > max_lines:
-                    violations.append(Violation(
-                        file=str(path), line=node.lineno, type='function',
-                        name=node.name, actual=length, limit=max_lines
-                    ))
-    except (SyntaxError, Exception):
-        pass
-    return violations
-
-
-def check_js_functions(path: Path, max_lines: int) -> List[Violation]:
-    """Check JS/TS function lengths using brace counting."""
-    violations = []
-    try:
-        with open(path, 'r', encoding='utf-8') as f:
-            lines = f.readlines()
-
-        func_pattern = re.compile(
-            r'(function\s+(\w+)|(\w+)\s*=\s*(async\s+)?\([^)]*\)\s*=>|'
-            r'(async\s+)?(\w+)\s*\([^)]*\)\s*\{)'
-        )
-
-        in_func = False
-        func_start = 0
-        func_name = 'anonymous'
-        brace_count = 0
-
-        for i, line in enumerate(lines, 1):
-            if not in_func:
-                match = func_pattern.search(line)
-                if match and '{' in line:
-                    in_func = True
-                    func_start = i
-                    func_name = match.group(2) or match.group(3) or match.group(6) or 'anonymous'
-                    brace_count = line.count('{') - line.count('}')
-            else:
-                brace_count += line.count('{') - line.count('}')
-                if brace_count <= 0:
-                    length = i - func_start + 1
-                    if length > max_lines:
-                        violations.append(Violation(
-                            file=str(path), line=func_start, type='function',
-                            name=func_name, actual=length, limit=max_lines
-                        ))
-                    in_func = False
-                    brace_count = 0
-    except Exception:
-        pass
-    return violations
-
-
-def check_go_functions(path: Path, max_lines: int) -> List[Violation]:
-    """Check Go function lengths."""
-    violations = []
-    try:
-        with open(path, 'r', encoding='utf-8') as f:
-            lines = f.readlines()
-
-        func_pattern = re.compile(r'^func\s+(\w+|\([^)]+\)\s+\w+)\s*\(')
-        in_func = False
-        func_start = 0
-        func_name = ''
-        brace_count = 0
-
-        for i, line in enumerate(lines, 1):
-            if not in_func:
-                match = func_pattern.match(line)
-                if match:
-                    in_func = True
-                    func_start = i
-                    func_name = match.group(1).split()[-1]
-                    brace_count = line.count('{') - line.count('}')
-            else:
-                brace_count += line.count('{') - line.count('}')
-                if brace_count <= 0:
-                    length = i - func_start + 1
-                    if length > max_lines:
-                        violations.append(Violation(
-                            file=str(path), line=func_start, type='function',
-                            name=func_name, actual=length, limit=max_lines
-                        ))
-                    in_func = False
-    except Exception:
-        pass
-    return violations
-
-
-def check_java_functions(path: Path, max_lines: int) -> List[Violation]:
-    """Check Java method lengths."""
-    violations = []
-    try:
-        with open(path, 'r', encoding='utf-8') as f:
-            lines = f.readlines()
-
-        method_pattern = re.compile(
-            r'(public|private|protected|static|\s)+[\w<>\[\]]+\s+(\w+)\s*\([^)]*\)\s*(\{|throws)'
-        )
-        in_method = False
-        method_start = 0
-        method_name = ''
-        brace_count = 0
-
-        for i, line in enumerate(lines, 1):
-            if not in_method:
-                match = method_pattern.search(line)
-                if match and '{' in line:
-                    in_method = True
-                    method_start = i
-                    method_name = match.group(2)
-                    brace_count = line.count('{') - line.count('}')
-            else:
-                brace_count += line.count('{') - line.count('}')
-                if brace_count <= 0:
-                    length = i - method_start + 1
-                    if length > max_lines:
-                        violations.append(Violation(
-                            file=str(path), line=method_start, type='function',
-                            name=method_name, actual=length, limit=max_lines
-                        ))
-                    in_method = False
-    except Exception:
-        pass
-    return violations
-
-
-def check_rust_functions(path: Path, max_lines: int) -> List[Violation]:
-    """Check Rust function lengths."""
-    violations = []
-    try:
-        with open(path, 'r', encoding='utf-8') as f:
-            lines = f.readlines()
-
-        func_pattern = re.compile(r'^\s*(pub\s+)?(async\s+)?fn\s+(\w+)')
-        in_func = False
-        func_start = 0
-        func_name = ''
-        brace_count = 0
-
-        for i, line in enumerate(lines, 1):
-            if not in_func:
-                match = func_pattern.match(line)
-                if match and '{' in line:
-                    in_func = True
-                    func_start = i
-                    func_name = match.group(3)
-                    brace_count = line.count('{') - line.count('}')
-            else:
-                brace_count += line.count('{') - line.count('}')
-                if brace_count <= 0:
-                    length = i - func_start + 1
-                    if length > max_lines:
-                        violations.append(Violation(
-                            file=str(path), line=func_start, type='function',
-                            name=func_name, actual=length, limit=max_lines
-                        ))
-                    in_func = False
-    except Exception:
-        pass
-    return violations
-
-
-LANG_CHECKERS = {
-    '.py': check_python_functions,
-    '.js': check_js_functions,
-    '.ts': check_js_functions,
-    '.tsx': check_js_functions,
-    '.jsx': check_js_functions,
-    '.go': check_go_functions,
-    '.java': check_java_functions,
-    '.rs': check_rust_functions,
-}
-
-SKIP_DIRS = {'node_modules', '.git', 'dist', 'build', '__pycache__', '.venv',
-             'venv', 'vendor', 'target', '.next', 'coverage'}
-
-
-def scan_directory(path: Path, max_file: int, max_func: int) -> List[Violation]:
-    """Scan directory for size violations."""
-    violations = []
-
-    for root, dirs, files in os.walk(path):
-        dirs[:] = [d for d in dirs if d not in SKIP_DIRS]
-
-        for file in files:
-            filepath = Path(root) / file
-            ext = filepath.suffix.lower()
-
-            if ext not in LANG_CHECKERS:
-                continue
-
-            # Check file length
-            file_lines = count_file_lines(filepath)
-            if file_lines > max_file:
-                violations.append(Violation(
-                    file=str(filepath), line=1, type='file',
-                    name=file, actual=file_lines, limit=max_file
-                ))
-
-            # Check function lengths
-            checker = LANG_CHECKERS.get(ext)
-            if checker:
-                violations.extend(checker(filepath, max_func))
-
-    return violations
-
-
-def generate_report(violations: List[Violation]) -> str:
-    """Generate markdown report."""
-    if not violations:
-        return "# Size Check Report\n\n**Status:** ✅ PASS\n\nNo design principle violations found."
-
-    file_v = [v for v in violations if v.type == 'file']
-    func_v = [v for v in violations if v.type == 'function']
-
-    lines = [
-        "# Size Check Report",
-        "",
-        "**Status:** ⚠️ WARNING",
-        "",
-        f"**Total Violations:** {len(violations)}",
-        f"- Files exceeding limit: {len(file_v)}",
-        f"- Functions exceeding limit: {len(func_v)}",
-        ""
-    ]
-
-    if file_v:
-        lines.extend([
-            "## Files Exceeding 500 Lines",
-            "",
-            "| File | Lines | Limit |",
-            "|------|-------|-------|"
-        ])
-        for v in sorted(file_v, key=lambda x: -x.actual):
-            lines.append(f"| `{v.file}` | {v.actual} | {v.limit} |")
-        lines.append("")
-
-    if func_v:
-        lines.extend([
-            "## Functions Exceeding 50 Lines",
-            "",
-            "| File | Line | Function | Lines | Limit |",
-            "|------|------|----------|-------|-------|"
-        ])
-        for v in sorted(func_v, key=lambda x: -x.actual):
-            lines.append(f"| `{v.file}` | {v.line} | `{v.name}` | {v.actual} | {v.limit} |")
-        lines.append("")
-
-    lines.extend([
-        "## Remediation",
-        "",
-        "### Large Files",
-        "- Identify logical groupings",
-        "- Extract to separate modules",
-        "",
-        "### Long Functions",
-        "- Extract helper functions",
-        "- Apply single responsibility principle"
-    ])
-
-    return "\n".join(lines)
-
-
-def main():
-    parser = argparse.ArgumentParser(description='Check code size limits (warning only)')
-    parser.add_argument('--path', default='.', help='Directory to scan')
-    parser.add_argument('--max-file-lines', type=int, default=500)
-    parser.add_argument('--max-function-lines', type=int, default=50)
-    parser.add_argument('--output', help='Output file (default: stdout)')
-
-    args = parser.parse_args()
-    violations = scan_directory(Path(args.path), args.max_file_lines, args.max_function_lines)
-    report = generate_report(violations)
-
-    if args.output:
-        with open(args.output, 'w') as f:
-            f.write(report)
-        print(f"Report saved to {args.output}")
-    else:
-        print(report)
-
-    # Exit 1 if violations (for CI awareness), but documented as warning only
-    sys.exit(1 if violations else 0)
-
-
-if __name__ == '__main__':
-    main()

package/templates/.claude/statusline.sh

@@ -1,126 +0,0 @@
-#!/usr/bin/env bash
-# AI Sprint Statusline
-# Displays: directory, git branch, model, context usage, cost
-# Requires: jq (optional - graceful fallback without it)
-
-set -euo pipefail
-
-# Check for jq
-HAS_JQ=false
-command -v jq >/dev/null 2>&1 && HAS_JQ=true
-
-# Read JSON from stdin
-INPUT=$(cat)
-
-# Fallback without jq
-if ! $HAS_JQ; then
-    echo "🚀 AI Sprint"
-    exit 0
-fi
-
-# --- Helper Functions ---
-
-# Expand home directory to ~
-expand_home() {
-    local path="$1"
-    echo "${path/#$HOME/~}"
-}
-
-# Get git branch
-get_git_branch() {
-    if git rev-parse --git-dir >/dev/null 2>&1; then
-        git branch --show-current 2>/dev/null || git rev-parse --short HEAD 2>/dev/null || echo ""
-    fi
-}
-
-# Progress bar (12 chars): ▰▰▰▱▱▱▱▱▱▱▱▱
-progress_bar() {
-    local percent=${1:-0}
-    local width=12
-
-    # Clamp to 0-100
-    (( percent < 0 )) && percent=0
-    (( percent > 100 )) && percent=100
-
-    local filled=$((percent * width / 100))
-    local empty=$((width - filled))
-
-    local bar=""
-    for ((i=0; i<filled; i++)); do bar+="▰"; done
-    for ((i=0; i<empty; i++)); do bar+="▱"; done
-
-    echo "$bar"
-}
-
-# Severity emoji based on percentage
-severity_emoji() {
-    local percent=${1:-0}
-    if (( percent >= 90 )); then echo "🔴"
-    elif (( percent >= 70 )); then echo "🟡"
-    else echo "🟢"
-    fi
-}
-
-# --- Parse JSON ---
-
-# Directory
-CWD=$(echo "$INPUT" | jq -r '.workspace.current_dir // .cwd // "unknown"')
-CWD=$(expand_home "$CWD")
-
-# Model
-MODEL=$(echo "$INPUT" | jq -r '.model.display_name // "Claude"')
-
-# Context window
-INPUT_TOKENS=$(echo "$INPUT" | jq -r '.context_window.total_input_tokens // 0')
-OUTPUT_TOKENS=$(echo "$INPUT" | jq -r '.context_window.total_output_tokens // 0')
-CONTEXT_SIZE=$(echo "$INPUT" | jq -r '.context_window.context_window_size // 0')
-
-CONTEXT_PCT=0
-if (( CONTEXT_SIZE > 0 )); then
-    TOTAL_TOKENS=$((INPUT_TOKENS + OUTPUT_TOKENS))
-    CONTEXT_PCT=$((TOTAL_TOKENS * 100 / CONTEXT_SIZE))
-fi
-
-# Cost (optional)
-COST=$(echo "$INPUT" | jq -r '.cost.total_cost_usd // empty')
-
-# Lines changed
-LINES_ADDED=$(echo "$INPUT" | jq -r '.cost.total_lines_added // 0')
-LINES_REMOVED=$(echo "$INPUT" | jq -r '.cost.total_lines_removed // 0')
-
-# --- Build Output ---
-
-OUTPUT=""
-
-# Directory
-OUTPUT+="📁 $CWD"
-
-# Git branch
-GIT_BRANCH=$(get_git_branch)
-if [[ -n "$GIT_BRANCH" ]]; then
-    OUTPUT+="  🌿 $GIT_BRANCH"
-fi
-
-# Model
-OUTPUT+="  🤖 $MODEL"
-
-# Context usage
-if (( CONTEXT_PCT > 0 )); then
-    EMOJI=$(severity_emoji "$CONTEXT_PCT")
-    BAR=$(progress_bar "$CONTEXT_PCT")
-    OUTPUT+="  $EMOJI $BAR ${CONTEXT_PCT}%"
-fi
-
-# Cost (only show if non-zero)
-if [[ -n "$COST" && "$COST" != "null" && "$COST" != "0" ]]; then
-    # Format to 4 decimal places
-    COST_FMT=$(printf "%.4f" "$COST" 2>/dev/null || echo "$COST")
-    OUTPUT+="  💵 \$$COST_FMT"
-fi
-
-# Lines changed
-if (( LINES_ADDED > 0 || LINES_REMOVED > 0 )); then
-    OUTPUT+="  📝 +$LINES_ADDED -$LINES_REMOVED"
-fi
-
-echo "$OUTPUT"

package/templates/.claude/workflows/development-rules.md

@@ -1,133 +0,0 @@
-# Development Rules
-
-Core principles enforced across all agents and commands.
-
-## Core Principles
-
-1. **YAGNI** - You Aren't Gonna Need It
-2. **KISS** - Keep It Simple, Stupid
-3. **DRY** - Don't Repeat Yourself
-4. **SRP** - Single Responsibility Principle
-5. **Security-First** - Security in every layer
-
-## Design Principles Enforcement
-
-### Size Limits (Warning level - non-blocking)
-| Metric | Limit | Action if Exceeded |
-|--------|-------|-------------------|
-| File lines | 500 | Split into modules |
-| Function lines | 50 | Extract helpers |
-| Parameters | 4 | Use options object |
-| Nesting levels | 3 | Use early returns |
-
-### YAGNI Checklist
-- Only build explicitly requested features
-- Delete unused code immediately
-- No "future-proofing" abstractions
-- No unused parameters "for later"
-
-### KISS Checklist
-- Prefer explicit over implicit
-- Prefer flat over nested
-- Prefer composition over inheritance
-- No clever code - readable > clever
-
-### SRP Checklist
-- One file = one concept
-- One function = one operation
-- If name needs "and" → split it
-
-### Automated Checking
-Run size checker (warning only):
-```bash
-python3 .claude/skills/quality-assurance/scripts/check-size.py
-```
-
-Included in `/ai-sprint-review` and `/ai-sprint-validate` workflows.
-
-## Date Handling
-
-**CRITICAL**: Never guess dates. Always use bash:
-```bash
-date "+%Y-%m-%d"     # For reports: 2025-12-24
-date "+%y%m%d-%H%M"  # For filenames: 251224-2115
-```
-
-## Context Engineering
-
-All AI context stored under `ai_context/`:
-```
-ai_context/
-├── plans/         # Implementation plans
-├── docs/          # AI-specific documentation
-├── refs/          # Reference materials
-├── memory/        # Session memory
-│   ├── learning.md    # Retrospective lessons
-│   ├── decisions.md   # Key decisions log
-│   └── active.md      # Current session state
-└── reports/       # Agent reports
-```
-
-## Memory Integration
-
-Before any task:
-- Check `ai_context/memory/learning.md` for past lessons
-
-After any task:
-- Update `ai_context/memory/learning.md` with new lessons
-- Record decisions in `ai_context/memory/decisions.md`
-
-## Quality Gates
-
-### Code Quality
-- [ ] All tests passing
-- [ ] >80% code coverage
-- [ ] No linting errors
-- [ ] Types complete (TypeScript)
-
-### Security
-- [ ] No hardcoded secrets
-- [ ] Input validation present
-- [ ] OWASP Top 10 compliant
-- [ ] Security scan passed
-
-### Documentation
-- [ ] Code comments where needed
-- [ ] API documented
-- [ ] README updated
-
-## Agent DO NOT Directives
-
-Every agent must follow:
-- DO NOT guess dates - use bash date command
-- DO NOT hardcode secrets
-- DO NOT skip security checks
-- DO NOT leave failing tests
-- DO NOT modify code without reading it first
-
-## Output Standards
-
-### Reports
-- Save to `ai_context/reports/` with timestamped filename
-- Use format: `{type}-{YYMMDD}-{slug}.md`
-- Include date from bash command
-
-### Plans
-- Save to `ai_context/ai-sprint-plans/` with timestamped folder
-- Use format: `{YYMMDD-HHMM}-{feature}/`
-- Include phase files if complex
-
-## Review Before Commit
-
-All code changes must pass:
-1. `/ai-sprint-test` - All tests pass
-2. `/ai-sprint-review` - Code quality check
-3. `/ai-sprint-secure` - Security scan
-
-## Human-in-the-Loop Gates
-
-Require user approval for:
-- Production deployments
-- Infrastructure changes
-- Database migrations
-- Security vulnerability fixes