kiro-spec-engine 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial project structure
+- CLI implementation with Node.js
+- Ultrawork quality enhancement tool (Python)
+- Multi-language support (English and Chinese)
+- Project initialization command (`kse init`)
+- Spec creation command (`kse create-spec`)
+- Status checking command (`kse status`)
+- Document enhancement command (`kse enhance`)
+
+### Documentation
+- README.md (English)
+- README.zh.md (Chinese)
+- CONTRIBUTING.md
+- LICENSE (MIT)
+
+## [1.0.0] - 2026-01-23
+
+### Added
+- Initial stable release
+- Complete npm and GitHub release pipeline
+- Python dependency detection with OS-specific installation instructions
+- Doctor command for system diagnostics
+- Automated CI/CD with GitHub Actions
+- Multi-language support (English and Chinese)
+- Comprehensive test infrastructure
+- Ultrawork quality enhancement tool
+- CLI commands: init, doctor, --version, --help
+- Template system for new projects
+
+### Documentation
+- Complete README with installation and usage guide
+- Chinese README (README.zh.md)
+- Contributing guidelines (CONTRIBUTING.md)
+- MIT License
+
+### Infrastructure
+- GitHub Actions workflows for testing and releasing
+- Jest test framework with property-based testing support
+- Cross-platform support (Windows, macOS, Linux)
+- Node.js 16+ support
+
+---
+
+**Legend**:
+- `Added` for new features
+- `Changed` for changes in existing functionality
+- `Deprecated` for soon-to-be removed features
+- `Removed` for now removed features
+- `Fixed` for any bug fixes
+- `Security` for vulnerability fixes

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kiro Ultrawork
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,242 @@
+# kiro-spec-engine
+
+[![npm version](https://badge.fury.io/js/kiro-spec-engine.svg)](https://badge.fury.io/js/kiro-spec-engine)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Kiro Spec Engine** - A spec-driven rules engine with quality enhancement powered by Ultrawork spirit.
+
+> 🔥 Transform your development workflow with structured specs, steering rules, and relentless quality pursuit.
+
+English | [简体中文](README.zh.md)
+
+## 🎯 What is Kiro Spec Engine?
+
+Kiro Spec Engine (KSE) is a **spec-driven rules engine** that brings structure, quality, and the **Ultrawork spirit** to your development process. It's not just a tool—it's a methodology for building software with clarity and excellence.
+
+### Core Concept: Spec-Driven Rules Engine
+
+At its heart, KSE is a **rules engine** that operates on **specs**:
+
+- **Specs** define what you want to build (Requirements → Design → Tasks)
+- **Steering rules** guide how AI assistants should help you build it
+- **Ultrawork spirit** ensures professional-grade quality at every stage
+
+### Key Features
+
+- ✅ **Spec-Driven Development**: Structured Requirements → Design → Tasks workflow
+- ✅ **Steering Rules System**: Control AI behavior with project-specific rules
+- ✅ **Quality Assessment**: Automatic document quality scoring (0-10 scale)
+- ✅ **Intelligent Enhancement**: Auto-identify and apply improvements with Ultrawork
+- ✅ **Professional Standards**: Ensure production-ready documentation
+- ✅ **Multi-language Support**: English and Chinese interfaces
+- ✅ **CLI Interface**: Easy-to-use command-line tools
+
+## 🚀 Quick Start
+
+### Installation
+
+Install globally via npm:
+
+```bash
+npm install -g kiro-spec-engine
+```
+
+Or use the short alias:
+
+```bash
+npm install -g kiro-spec-engine
+# Creates both 'kiro-spec-engine' and 'kse' commands
+```
+
+### Initialize a Project
+
+```bash
+# Initialize in current directory
+kiro-spec-engine init
+
+# Or specify project name
+kiro-spec-engine init "My Awesome Project"
+
+# Use Chinese interface
+kiro-spec-engine --lang zh init
+
+# Use short alias
+kse init
+```
+
+### Create and Enhance Your First Spec
+
+```bash
+# Create a new spec
+kse create-spec 01-00-user-authentication
+
+# Write your basic requirements.md file
+# Then enhance it with Ultrawork
+kse enhance requirements .kiro/specs/01-00-user-authentication/requirements.md
+```
+
+## 📋 Commands
+
+### Project Management
+
+```bash
+# Initialize project
+kse init [project-name]
+
+# Check project status
+kse status
+
+# Create new spec
+kse create-spec <spec-name>
+
+# Set language
+kse --lang zh <command>  # Chinese
+kse --lang en <command>  # English (default)
+```
+
+### Document Enhancement
+
+```bash
+# Enhance requirements document
+kse enhance requirements <file>
+
+# Enhance design document (requires requirements file)
+kse enhance design <design-file> --requirements <requirements-file>
+
+# Check tasks completion
+kse enhance tasks <tasks-file>
+```
+
+### Examples
+
+```bash
+# Full workflow example
+kse init "E-commerce Platform"
+kse create-spec 01-00-user-auth
+# Edit .kiro/specs/01-00-user-auth/requirements.md
+kse enhance requirements .kiro/specs/01-00-user-auth/requirements.md
+# Edit .kiro/specs/01-00-user-auth/design.md  
+kse enhance design .kiro/specs/01-00-user-auth/design.md --requirements .kiro/specs/01-00-user-auth/requirements.md
+```
+
+## 📊 Quality Standards
+
+### Requirements Stage (0-10 scoring)
+- **Basic Structure** (2pts): Overview, user stories, functional requirements, non-functional requirements
+- **EARS Format** (2pts): WHEN...THEN acceptance criteria
+- **User Stories** (2pts): "As a...I want...So that" format
+- **Acceptance Criteria** (2pts): Complete acceptance criteria definitions
+- **Non-functional Requirements** (1pt): Performance, security, usability, etc.
+- **Constraints** (1pt): Technical constraints, resource constraints, etc.
+
+### Design Stage (0-10 scoring)
+- **Basic Structure** (2pts): System overview, architecture design, component design, interface design
+- **Requirements Traceability** (2pts): Bidirectional traceability from requirements to design
+- **Architecture Diagrams** (1.5pts): Mermaid diagrams or other design diagrams
+- **Technology Selection** (1.5pts): Technology stack choices and rationale
+- **Non-functional Design** (1.5pts): Performance design, security design, scalability
+- **Interface Definition** (1.5pts): API design, data structure definitions
+
+### Tasks Stage
+- **Completion Analysis**: Statistics on completed, in-progress, not-started tasks
+- **Priority Identification**: Identify priorities based on keywords and task numbers
+- **Ultrawork Motivation**: Provide Sisyphus spirit motivation and suggestions
+- **Next Steps Guidance**: Suggest specific execution strategies
+
+## 🛠️ Project Structure
+
+After initialization, your project will have:
+
+```
+your-project/
+├── .kiro/                          # Kiro core directory
+│   ├── specs/                      # Spec storage
+│   │   └── SPEC_WORKFLOW_GUIDE.md
+│   ├── steering/                   # AI behavior rules (the "rules engine")
+│   │   ├── CORE_PRINCIPLES.md      # Core principles + Ultrawork spirit
+│   │   ├── ENVIRONMENT.md          # Environment configuration
+│   │   ├── CURRENT_CONTEXT.md      # Current context
+│   │   └── RULES_GUIDE.md          # Rules index
+│   ├── tools/                      # Ultrawork tools
+│   │   └── ultrawork_enhancer.py   # Core enhancement tool
+│   └── README.md                   # Kiro system documentation
+└── README.md                       # Project documentation
+```
+
+## 🔥 The Ultrawork Spirit
+
+> Inspired by Sisyphus from Greek mythology, who was condemned to push a boulder up a mountain for eternity, only to watch it roll back down each time.
+
+The Ultrawork spirit embodies:
+
+- **Relentless Effort**: Never give up when facing challenges
+- **Continuous Improvement**: Always strive for better quality
+- **Professional Standards**: Pursue excellence in every detail (9.0/10 target)
+- **Persistent Execution**: Keep pushing forward until completion
+
+Ultrawork is the **quality enhancement philosophy** within Kiro Spec Engine—it's what drives the engine to produce professional-grade results.
+
+## 🌍 Multi-language Support
+
+Kiro Spec Engine supports multiple languages out of the box.
+
+### Setting Language
+
+```bash
+# Using command line option
+kse --lang zh init
+
+# Using environment variable
+export KIRO_LANG=zh
+kse init
+
+# Windows
+set KIRO_LANG=zh
+kse init
+```
+
+### Supported Languages
+
+- 🇺🇸 English (en) - Default
+- 🇨🇳 Simplified Chinese (zh)
+
+The tool automatically detects your system language and uses it by default. You can override this with the `--lang` option or `KIRO_LANG` environment variable.
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+### Development Setup
+
+```bash
+git clone https://github.com/yourusername/kiro-spec-engine.git
+cd kiro-spec-engine
+npm install
+npm link  # For local development
+```
+
+### Adding New Languages
+
+1. Create a new language file in `locales/` (e.g., `ja.json`)
+2. Copy the structure from `en.json` and translate all text
+3. Add language detection logic in `lib/i18n.js`
+4. Update README documentation
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Inspired by the **Sisyphus** myth and the concept of noble struggle
+- Built on the foundation of **Kiro** spec-driven development
+- Influenced by **oh-my-opencode** and the Ultrawork Manifesto
+
+---
+
+**Start your spec-driven journey today! 🔥**
+
+```bash
+npm install -g kiro-spec-engine
+kse init
+```

package/README.zh.md

@@ -0,0 +1,242 @@
+# kiro-spec-engine
+
+[![npm version](https://badge.fury.io/js/kiro-spec-engine.svg)](https://badge.fury.io/js/kiro-spec-engine)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**Kiro Spec Engine** - 基于 Spec 的驱动规则引擎，融入 Ultrawork 精神的质量增强工具。
+
+> 🔥 用结构化的 Spec、Steering 规则和不懈的质量追求，改变你的开发工作流。
+
+[English](README.md) | 简体中文
+
+## 🎯 什么是 Kiro Spec Engine？
+
+Kiro Spec Engine (KSE) 是一个 **基于 Spec 的驱动规则引擎**，为你的开发过程带来结构、质量和 **Ultrawork 精神**。它不仅仅是一个工具——更是一种以清晰和卓越构建软件的方法论。
+
+### 核心概念：Spec 驱动规则引擎
+
+KSE 的核心是一个基于 **Specs** 运作的**规则引擎**：
+
+- **Specs** 定义你要构建什么（Requirements → Design → Tasks）
+- **Steering 规则** 指导 AI 助手如何帮助你构建
+- **Ultrawork 精神** 确保每个阶段的专业级质量
+
+### 核心特性
+
+- ✅ **Spec 驱动开发**: 结构化的 Requirements → Design → Tasks 工作流
+- ✅ **Steering 规则系统**: 用项目特定规则控制 AI 行为
+- ✅ **质量评估**: 自动文档质量评分（0-10 分制）
+- ✅ **智能增强**: 通过 Ultrawork 自动识别和应用改进
+- ✅ **专业标准**: 确保生产就绪的文档
+- ✅ **多语言支持**: 支持中文和英文界面
+- ✅ **CLI 接口**: 易用的命令行工具
+
+## 🚀 快速开始
+
+### 安装
+
+通过 npm 全局安装：
+
+```bash
+npm install -g kiro-spec-engine
+```
+
+或使用短别名：
+
+```bash
+npm install -g kiro-spec-engine
+# 创建 'kiro-spec-engine' 和 'kse' 两个命令
+```
+
+### 初始化项目
+
+```bash
+# 在当前目录初始化
+kiro-spec-engine init
+
+# 或指定项目名称
+kiro-spec-engine init "我的超棒项目"
+
+# 使用中文界面
+kiro-spec-engine --lang zh init
+
+# 使用短别名
+kse init
+```
+
+### 创建并增强你的第一个 Spec
+
+```bash
+# 创建新 Spec
+kse create-spec 01-00-user-authentication
+
+# 编写基础 requirements.md 文件
+# 然后使用 Ultrawork 增强
+kse enhance requirements .kiro/specs/01-00-user-authentication/requirements.md
+```
+
+## 📋 命令
+
+### 项目管理
+
+```bash
+# 初始化项目
+kse init [项目名称]
+
+# 检查项目状态
+kse status
+
+# 创建新 Spec
+kse create-spec <spec-名称>
+
+# 设置语言
+kse --lang zh <命令>  # 中文
+kse --lang en <命令>  # 英文
+```
+
+### 文档增强
+
+```bash
+# 增强需求文档
+kse enhance requirements <文件>
+
+# 增强设计文档（需要需求文件）
+kse enhance design <设计文件> --requirements <需求文件>
+
+# 检查任务完成情况
+kse enhance tasks <任务文件>
+```
+
+### 示例
+
+```bash
+# 完整工作流示例
+kse init "电商平台"
+kse create-spec 01-00-user-auth
+# 编辑 .kiro/specs/01-00-user-auth/requirements.md
+kse enhance requirements .kiro/specs/01-00-user-auth/requirements.md
+# 编辑 .kiro/specs/01-00-user-auth/design.md  
+kse enhance design .kiro/specs/01-00-user-auth/design.md --requirements .kiro/specs/01-00-user-auth/requirements.md
+```
+
+## 📊 质量标准
+
+### Requirements 阶段（0-10 评分）
+- **基础结构**（2分）：概述、用户故事、功能需求、非功能需求
+- **EARS 格式**（2分）：WHEN...THEN 验收标准
+- **用户故事**（2分）："作为...我希望...以便" 格式
+- **验收标准**（2分）：完整的验收标准定义
+- **非功能需求**（1分）：性能、安全、可用性等
+- **约束条件**（1分）：技术约束、资源约束等
+
+### Design 阶段（0-10 评分）
+- **基础结构**（2分）：系统概述、架构设计、组件设计、接口设计
+- **需求追溯**（2分）：需求到设计的双向追溯
+- **架构图**（1.5分）：Mermaid 图或其他设计图
+- **技术选型**（1.5分）：技术栈选择和理由
+- **非功能设计**（1.5分）：性能设计、安全设计、可扩展性
+- **接口定义**（1.5分）：API 设计、数据结构定义
+
+### Tasks 阶段
+- **完成率分析**：统计已完成、进行中、未开始任务
+- **优先级识别**：基于关键词和任务编号识别优先级
+- **Ultrawork 激励**：提供 Sisyphus 精神激励和建议
+- **下一步指导**：建议具体的执行策略
+
+## 🛠️ 项目结构
+
+初始化后，你的项目将包含：
+
+```
+your-project/
+├── .kiro/                          # Kiro 核心目录
+│   ├── specs/                      # Spec 存储
+│   │   └── SPEC_WORKFLOW_GUIDE.md
+│   ├── steering/                   # AI 行为规则（"规则引擎"）
+│   │   ├── CORE_PRINCIPLES.md      # 核心原则 + Ultrawork 精神
+│   │   ├── ENVIRONMENT.md          # 环境配置
+│   │   ├── CURRENT_CONTEXT.md      # 当前上下文
+│   │   └── RULES_GUIDE.md          # 规则索引
+│   ├── tools/                      # Ultrawork 工具
+│   │   └── ultrawork_enhancer.py   # 核心增强工具
+│   └── README.md                   # Kiro 系统文档
+└── README.md                       # 项目文档
+```
+
+## 🔥 Ultrawork 精神
+
+> 受希腊神话中西西弗斯的启发，他被判永远推石上山，每次快到山顶时石头就会滚下来。
+
+Ultrawork 精神体现：
+
+- **不懈努力**：面对挑战永不放弃
+- **持续改进**：始终追求更好的质量
+- **专业标准**：在每个细节上追求卓越（9.0/10 目标）
+- **坚持执行**：持续推进直到完成
+
+Ultrawork 是 Kiro Spec Engine 中的**质量增强哲学**——它驱动引擎产出专业级结果。
+
+## 🌍 多语言支持
+
+Kiro Spec Engine 支持多种语言：
+
+### 设置语言
+
+```bash
+# 使用命令行参数
+kse --lang zh init
+
+# 使用环境变量
+export KIRO_LANG=zh
+kse init
+
+# Windows
+set KIRO_LANG=zh
+kse init
+```
+
+### 支持的语言
+
+- 🇺🇸 English (en) - 默认
+- 🇨🇳 简体中文 (zh)
+
+工具会自动检测你的系统语言并默认使用。你可以通过 `--lang` 选项或 `KIRO_LANG` 环境变量覆盖默认设置。
+
+## 🤝 贡献
+
+我们欢迎贡献！请查看我们的[贡献指南](CONTRIBUTING.md)了解详情。
+
+### 开发设置
+
+```bash
+git clone https://github.com/yourusername/kiro-spec-engine.git
+cd kiro-spec-engine
+npm install
+npm link  # 用于本地开发
+```
+
+### 添加新语言
+
+1. 在 `locales/` 目录创建新的语言文件（如 `ja.json`）
+2. 复制 `en.json` 的结构并翻译所有文本
+3. 在 `lib/i18n.js` 中添加语言检测逻辑
+4. 更新 README 文档
+
+## 📄 许可证
+
+MIT License - 详见 [LICENSE](LICENSE) 文件。
+
+## 🙏 致谢
+
+- 受 **Sisyphus** 神话和高贵奋斗概念的启发
+- 基于 **Kiro** Spec 驱动开发的基础
+- 受 **oh-my-opencode** 和 Ultrawork Manifesto 的影响
+
+---
+
+**今天就开始你的 Spec 驱动之旅！🔥**
+
+```bash
+npm install -g kiro-spec-engine
+kse --lang zh init
+```