ai-sprint-kit 1.1.0 → 1.1.5

package/LICENSE

@@ -0,0 +1,135 @@
+# PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to [Distribution
+License](#distribution-license) and make changes or new works
+based on the software according to [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by [Changes and New Works
+License](#changes-and-new-works-license).
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Apiasak Pungpapong (https://github.com/apiasak)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.
+
+---
+
+Required Notice: Copyright 2025 Apiasak Pungpapong (https://github.com/apiasak)

package/README.md

@@ -1,299 +1,225 @@
-# AI Sprint
+# AI Sprint Kit
 
-**One-command installer for Claude Code autonomous development framework**
+[![npm version](https://img.shields.io/npm/v/ai-sprint-kit.svg)](https://www.npmjs.com/package/ai-sprint-kit)
+[![License: PolyForm Noncommercial](https://img.shields.io/badge/License-PolyForm%20Noncommercial-blue.svg)](https://polyformproject.org/licenses/noncommercial/1.0.0/)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
 
-## Features
-
-- 🤖 **9 Specialized Agents** - Planner, Implementer, Tester, Reviewer, Security, DevOps, Docs, Debugger, Researcher
-- ⚡ **11 Essential Commands** - `/plan`, `/code`, `/test`, `/review`, `/secure`, `/deploy`, `/docs`, `/debug`, `/scan`, `/validate`, `/auto`
-- 🔒 **Security-First** - Built-in SAST, secret detection, dependency scanning
-- 🚀 **Production-Ready** - OWASP Top 10 compliance, security best practices
-- 🎯 **Autonomous** - Full development cycle with human-in-the-loop gates
-- 🧠 **Context Engineering** - Memory system for learning across sessions
-- 📁 **Codebase Scanning** - Auto-scan existing code with 70% token compression
-- 📊 **Custom Statusline** - Real-time context, cost, and session tracking
-
-## Installation
-
-### Quick Start (Recommended)
+> **Transform Claude Code into an autonomous development powerhouse with one command.**
 
 ```bash
-npx ai-sprint init
+npx ai-sprint-kit init
 ```
 
-### Global Installation
+---
 
-```bash
-npm install -g ai-sprint
-ai-sprint init
-```
+## Why AI Sprint Kit?
 
-### Options
+Most developers use Claude Code for simple Q&A. **AI Sprint Kit** unlocks its full potential:
 
-```bash
-# Install in specific directory
-npx ai-sprint init --dir /path/to/project
+| Without AI Sprint | With AI Sprint Kit |
+|-------------------|-------------------|
+| Manual prompting | Autonomous workflows |
+| No memory between sessions | Persistent learning & decisions |
+| Generic responses | Security-first, production-ready code |
+| Single-task focus | Full development cycle automation |
+
+---
 
-# Force overwrite existing .claude/
-npx ai-sprint init --force
+## Quick Start
 
-# Skip Python dependencies
-npx ai-sprint init --skip-install
+```bash
+# Install in any project
+npx ai-sprint-kit init
 
-# Scan existing codebase (auto-detected if source exists)
-npx ai-sprint init --scan
+# Start Claude Code
+claude
 
-# Skip codebase scanning
-npx ai-sprint init --no-scan
+# Run your first autonomous cycle
+/auto "build a REST API for user management"
 ```
 
-## What Gets Installed
+**That's it.** The framework handles planning, coding, testing, security scanning, and documentation.
 
-```
-your-project/
-├── .claude/
-│   ├── agents/          # 9 specialized agents
-│   ├── commands/        # 11 slash commands
-│   ├── skills/          # Security scanning scripts
-│   ├── workflows/       # Development rules
-│   ├── settings.json    # Configuration
-│   ├── statusline.sh    # Terminal statusline script
-│   └── .env.example     # Environment template
-├── ai_context/          # AI context & artifacts
-│   ├── plans/           # Implementation plans
-│   ├── docs/            # AI-generated docs
-│   ├── reports/         # Agent outputs
-│   ├── codebase/        # Scanned codebase context (if --scan)
-│   └── memory/          # Learning & decisions
-├── CLAUDE.md            # Framework instructions
-└── README.md            # User guide
-```
+---
 
-## Usage After Installation
+## What You Get
 
-```bash
-# Start Claude Code
-claude
+### 9 Specialized Agents
 
-# Use commands
-/plan "implement user authentication"
-/code "build the authentication system"
-/test "generate and run tests"
-/secure "run security scans"
-/auto "full autonomous cycle"
-```
+| Agent | Superpower |
+|-------|------------|
+| **Planner** | Researches & architects solutions before coding |
+| **Implementer** | Generates production-grade, secure code |
+| **Tester** | Creates comprehensive test suites with 80%+ coverage |
+| **Reviewer** | Enforces code quality & best practices |
+| **Security** | SAST, secret detection, OWASP Top 10 compliance |
+| **DevOps** | Sets up CI/CD pipelines & deployments |
+| **Docs** | Generates & maintains documentation |
+| **Debugger** | Root cause analysis with fix recommendations |
+| **Researcher** | Web search for latest libraries & best practices |
 
-## Agents
-
-| Agent | Purpose |
-|-------|---------|
-| **planner** | Research & create implementation plans |
-| **implementer** | Generate production-grade code |
-| **tester** | Create and run automated tests |
-| **reviewer** | Code quality and best practices review |
-| **security** | SAST, secret detection, dependency scanning |
-| **devops** | CI/CD setup and deployment |
-| **docs** | Generate documentation |
-| **debugger** | Root cause analysis and fixes |
-| **researcher** | Technology research with web search |
-
-## Commands
-
-| Command | Description | Example |
-|---------|-------------|---------|
-| `/plan` | Create implementation plan | `/plan "add payment processing"` |
-| `/code` | Generate/refactor code | `/code "implement OAuth2 login"` |
-| `/test` | Generate and run tests | `/test` |
-| `/review` | Code quality review | `/review src/` |
-| `/secure` | Security scan | `/secure` |
-| `/deploy` | CI/CD setup | `/deploy --platform github` |
-| `/docs` | Generate documentation | `/docs` |
-| `/debug` | Investigate issues | `/debug "500 error on login"` |
-| `/scan` | Scan codebase for AI context | `/scan` |
-| `/validate` | Pre-commit validation | `/validate` |
-| `/auto` | Automatic full cycle | `/auto "build user dashboard"` |
-
-## Security Features
-
-### Built-in Scans
-- ✅ **SAST** - Static application security testing
-- ✅ **Secret Detection** - Find hardcoded credentials
-- ✅ **Dependency Check** - Vulnerable packages
-- ✅ **OWASP Top 10** - Compliance validation
-
-### Security Tools (Optional)
-```bash
-# Install security scanning tools
-pip install snyk semgrep detect-secrets safety
-```
+### 11 Slash Commands
 
-### Configuration
-Set API tokens in `.env`:
 ```bash
-SNYK_TOKEN=your_token
-SEMGREP_APP_TOKEN=your_token
+/plan     # Create implementation plans
+/code     # Generate or refactor code
+/test     # Generate and run tests
+/review   # Code quality review
+/secure   # Security scanning
+/deploy   # CI/CD setup
+/docs     # Generate documentation
+/debug    # Investigate issues
+/scan     # Index codebase for AI context
+/validate # Pre-commit checks
+/auto     # Full autonomous cycle
 ```
 
-## CLI Commands
+### Built-in Security
 
-### `ai-sprint init`
-Install framework in current or specified directory
+- **SAST** - Static application security testing
+- **Secret Detection** - Find hardcoded credentials
+- **Dependency Scanning** - Vulnerable packages
+- **OWASP Top 10** - Compliance validation
 
-```bash
-# Current directory
-ai-sprint init
-
-# Specific directory
-ai-sprint init --dir /path/to/project
-
-# Force overwrite
-ai-sprint init --force
+### Context Engineering
 
-# Skip Python dependencies
-ai-sprint init --skip-install
-```
+- **Memory System** - Learns from past sessions
+- **Decision Tracking** - Records architectural choices
+- **Codebase Indexing** - 70% token compression with Repomix
 
-### `ai-sprint scan`
-Scan codebase and generate AI context documents
+### Real-time Statusline
 
-```bash
-# Current directory
-ai-sprint scan
+Track context usage, costs, and session progress directly in your terminal.
 
-# Specific directory
-ai-sprint scan --dir /path/to/project
-```
+---
 
-**Output:** `ai_context/codebase/` with overview.md, structure.md, repomix-output.xml
+## Installation
 
-### `ai-sprint list`
-Show available agents and commands
+### Option 1: npx (Recommended)
 
 ```bash
-ai-sprint list
+npx ai-sprint-kit init
 ```
 
-## Development
-
-### Local Testing
+### Option 2: Global Install
 
 ```bash
-# Clone repository
-git clone https://github.com/yourusername/ai-sprint
-cd ai-sprint
-
-# Install dependencies
-npm install
-
-# Link locally
-npm link
-
-# Test installation
-mkdir test-project
-cd test-project
+npm install -g ai-sprint-kit
 ai-sprint init
+```
 
-# Test with Claude Code
-claude
-/plan "test feature"
+### Options
+
+```bash
+--dir <path>     # Install in specific directory
+--force          # Overwrite existing installation
+--skip-install   # Skip Python dependencies
+--scan           # Force codebase scanning
+--no-scan        # Skip codebase scanning
 ```
 
-### Package Structure
+---
+
+## Project Structure After Installation
 
 ```
-ai-sprint/
-├── bin/
-│   └── cli.js           # CLI entry point
-├── lib/
-│   ├── installer.js     # Installation logic
-│   └── scanner.js       # Codebase scanning logic
-├── templates/
-│   ├── .claude/         # Framework templates
-│   ├── CLAUDE.md       # Instructions
-│   └── README.md       # User guide
-├── package.json
-└── README.md           # This file
+your-project/
+├── .claude/
+│   ├── agents/          # 9 specialized agents
+│   ├── commands/        # 11 slash commands
+│   ├── skills/          # Modular capabilities
+│   ├── workflows/       # Development rules
+│   ├── settings.json    # Configuration
+│   └── statusline.sh    # Terminal statusline
+├── ai_context/
+│   ├── plans/           # Implementation plans
+│   ├── reports/         # Agent outputs
+│   ├── codebase/        # Indexed source code
+│   └── memory/          # Learning & decisions
+├── CLAUDE.md            # Framework instructions
+└── README.md            # User guide
 ```
 
-## Requirements
-
-- Node.js >= 18.0.0
-- Claude Code CLI
-- Python 3.8+ (optional, for security skills)
+---
 
 ## Examples
 
-### Example 1: New Project Setup
+### New Project
+
 ```bash
-mkdir my-project
-cd my-project
-npx ai-sprint init
+mkdir my-app && cd my-app
+npx ai-sprint-kit init
 claude
-/auto "build REST API for todo app"
+/auto "build e-commerce API with Stripe integration"
 ```
 
-### Example 2: Add to Existing Project
+### Existing Project
+
 ```bash
-cd existing-project
-npx ai-sprint init
+cd my-existing-project
+npx ai-sprint-kit init --scan
 claude
-/secure  # Scan existing code
-/review  # Review code quality
+/review   # Analyze code quality
+/secure   # Find vulnerabilities
 ```
 
-### Example 3: Security-Focused Development
+### Security-First Development
+
 ```bash
-npx ai-sprint init
-claude
 /plan "implement payment processing"
-/code "implement with PCI DSS compliance"
-/secure  # Comprehensive security scan
-/review  # Security-focused review
+/code "build with PCI DSS compliance"
+/secure   # Comprehensive scan
+/validate # Pre-commit checks
 ```
 
-## Troubleshooting
+---
 
-### "Command not found: ai-sprint"
-```bash
-# Use npx instead
-npx ai-sprint init
+## Requirements
 
-# Or install globally
-npm install -g ai-sprint
-```
+- **Node.js** >= 18.0.0
+- **Claude Code** CLI installed
+- **Python 3.8+** (optional, for advanced security skills)
 
-### ".claude/ already exists"
-```bash
-# Use --force to overwrite
-npx ai-sprint init --force
-```
+---
 
-### "Python dependencies failed"
-```bash
-# Install manually
-cd .claude/skills
-python3 -m venv .venv
-source .venv/bin/activate  # or .venv\Scripts\activate on Windows
-pip install -r requirements.txt
-```
+## CLI Reference
+
+| Command | Description |
+|---------|-------------|
+| `ai-sprint init` | Install framework |
+| `ai-sprint scan` | Index codebase |
+| `ai-sprint list` | Show agents & commands |
+
+---
 
 ## Contributing
 
-Contributions welcome! Please:
+Contributions welcome!
+
 1. Fork the repository
 2. Create a feature branch
 3. Make your changes
 4. Submit a pull request
 
-## License
+---
 
-MIT License - see LICENSE file
+## Links
+
+- [npm Package](https://www.npmjs.com/package/ai-sprint-kit)
+- [GitHub Repository](https://github.com/apiasak/ai-sprint-kit)
+- [Issues](https://github.com/apiasak/ai-sprint-kit/issues)
+- [Framework Documentation](./templates/README.md)
+
+---
+
+## License
 
-## Support
+**PolyForm Noncommercial 1.0.0** - Free for personal and non-commercial use. See [LICENSE](./LICENSE) file.
 
-- Issues: [GitHub Issues](https://github.com/yourusername/ai-sprint/issues)
-- Documentation: [Framework README](./templates/README.md)
+**Not permitted:** Commercial use, resale, or incorporation into commercial products.
 
 ---
 
-**Made with ❤️ for autonomous developers**
+<p align="center">
+  <strong>Built for developers who want to ship faster, safer, and smarter.</strong>
+</p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-sprint-kit",
-  "version": "1.1.0",
+  "version": "1.1.5",
   "description": "CLI installer for autonomous coding agent framework - security-first, production-grade Claude Code setup",
   "main": "lib/installer.js",
   "bin": {
@@ -21,16 +21,16 @@
     "code-generation",
     "ai-sprint"
   ],
-  "author": "Your Name",
-  "license": "MIT",
+  "author": "Apiasak Pungpapong",
+  "license": "PolyForm-Noncommercial-1.0.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/yourusername/ai-sprint.git"
+    "url": "https://github.com/apiasak/ai-sprint-kit.git"
   },
   "bugs": {
-    "url": "https://github.com/yourusername/ai-sprint/issues"
+    "url": "https://github.com/apiasak/ai-sprint-kit/issues"
   },
-  "homepage": "https://github.com/yourusername/ai-sprint#readme",
+  "homepage": "https://github.com/apiasak/ai-sprint-kit#readme",
   "files": [
     "bin/",
     "lib/",

package/templates/.claude/commands/scan.md

@@ -56,11 +56,11 @@ ls -la ai_context/codebase/ 2>/dev/null || echo "No existing scan found"
 
 ### Step 2: Run Codebase Scan
 
-Use the `ai-sprint scan` CLI command or run repomix directly:
+Use the `ai-sprint-kit scan` CLI command or run repomix directly:
 
 ```bash
 # Option A: Use AI Sprint CLI (if available)
-ai-sprint scan
+ai-sprint-kit scan
 
 # Option B: Run repomix directly
 npx repomix --compress --style xml -o ai_context/codebase/repomix-output.xml

package/templates/.claude/skills/codebase-context/references/refresh-triggers.md

@@ -65,10 +65,10 @@ large-data/
 /scan
 
 # Using CLI directly
-ai-sprint scan
+ai-sprint-kit scan
 
 # Specific directory
-ai-sprint scan --dir /path/to/project
+ai-sprint-kit scan --dir /path/to/project
 ```
 
 ## Refresh Frequency Guidelines

package/templates/README.md

@@ -115,7 +115,7 @@ Skills are activated automatically when relevant.
 AI Sprint can scan existing codebases to help agents understand the project quickly.
 
 ### Automatic Scanning
-When you run `ai-sprint init` on a project with existing source code, it automatically scans and generates context documents.
+When you run `ai-sprint-kit init` on a project with existing source code, it automatically scans and generates context documents.
 
 ### Manual Scanning
 ```bash
@@ -123,7 +123,7 @@ When you run `ai-sprint init` on a project with existing source code, it automat
 /scan
 
 # Or use CLI directly
-ai-sprint scan
+ai-sprint-kit scan
 ```
 
 ### Output

package/templates/docs/user-guide-th.md

@@ -411,7 +411,7 @@ ls .claude/
 ถ้าไม่มี ให้ติดตั้งใหม่:
 
 ```bash
-npx ai-sprint init --force
+npx ai-sprint-kit init --force
 ```
 
 ### MCP ไม่ทำงาน

package/templates/docs/user-guide.md

@@ -144,7 +144,7 @@ This runs: tests + code review + security scan. Blocks if:
 
 ```bash
 # Install framework
-npx ai-sprint init
+npx ai-sprint-kit init
 
 # Scan existing code for issues
 /secure
@@ -570,7 +570,7 @@ ls .claude/commands/
 If missing, reinstall:
 
 ```bash
-npx ai-sprint init --force
+npx ai-sprint-kit init --force
 ```
 
 ---