kiro-spec-engine 1.3.0 → 1.4.1

package/CHANGELOG.md

@@ -7,6 +7,91 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.4.1] - 2026-01-23
+
+### Fixed - Documentation Clarity 🎯
+
+**Corrected Integration Flow**:
+- **Fixed sequence diagrams** - Now correctly show "User ↔ AI Tool ↔ kse" instead of "User → kse → AI Tool"
+- **Emphasized AI-driven workflow** - AI tools call kse directly, users stay in their familiar interface
+- **Clarified positioning** - kse works behind the scenes, users don't "switch tools"
+
+**Updated Documentation**:
+- `README.md` - Rewrote Step 4 to emphasize AI tool calls kse automatically
+- `README.zh.md` - Chinese version updated to match
+- `docs/integration-modes.md` - Fixed sequence diagrams and workflow descriptions
+
+**Key Message**:
+- ✅ Users continue using their preferred AI tool (Cursor, Claude, Windsurf, etc.)
+- ✅ AI tool calls kse commands during conversation
+- ✅ No "tool switching" - seamless integration
+- ✅ kse is the "context provider" working behind the scenes
+
+### Why This Matters
+
+Users are already comfortable with their AI tools. kse enhances their existing workflow by providing structured context, not by replacing their tools. This patch clarifies that positioning.
+
+## [1.4.0] - 2026-01-23
+
+### Added - User Onboarding and Documentation Overhaul 📚
+
+**Complete Documentation Restructure**:
+- **New Positioning**: Repositioned kse as "A context provider for AI coding tools"
+- **Three-Tier Structure**: README → Core Guides → Tool-Specific Guides
+- **"What kse is NOT" Section**: Clear clarification of kse's role
+
+**New Documentation** (20+ new files):
+- **Quick Start Guide** (`docs/quick-start.md`): Complete 5-minute tutorial with user-login example
+- **6 Tool-Specific Guides**:
+  - Cursor Integration Guide
+  - Claude Code Integration Guide
+  - Windsurf Integration Guide
+  - Kiro Integration Guide
+  - VS Code + Copilot Integration Guide
+  - Generic AI Tools Guide
+- **Core Guides**:
+  - Spec Workflow Guide (deep dive into Spec creation)
+  - Integration Modes Guide (Native, Manual Export, Watch Mode)
+  - Troubleshooting Guide (organized by category)
+  - FAQ (frequently asked questions)
+- **3 Complete Example Specs**:
+  - API Feature Example (RESTful API with authentication)
+  - UI Feature Example (React dashboard)
+  - CLI Feature Example (export command)
+- **Documentation Index** (`docs/README.md`): Comprehensive navigation hub
+
+**Visual Enhancements**:
+- **3 Mermaid Diagrams**:
+  - Spec creation workflow diagram
+  - Integration modes diagram
+  - Context flow sequence diagram
+
+**Bilingual Support**:
+- **Complete Chinese Translations**:
+  - Chinese README (`README.zh.md`)
+  - Chinese Quick Start Guide (`docs/zh/quick-start.md`)
+  - All 6 tool guides translated (`docs/zh/tools/`)
+  - Chinese documentation index (`docs/zh/README.md`)
+
+**Metadata and Navigation**:
+- Added version, date, audience, and time estimates to all major docs
+- Cross-document linking with "Related Documentation" sections
+- "Next Steps" sections for progressive learning
+- "Getting Help" sections with multiple support channels
+
+### Changed
+
+- **README.md**: Complete restructure with embedded quick start and clear positioning
+- **README.zh.md**: Updated to match new English structure
+- All documentation now emphasizes kse's role as a context provider for AI tools
+
+### Improved
+
+- **User Experience**: Reduced time-to-first-feature from unclear to 5 minutes
+- **Tool Integration**: Clear guidance for 6 major AI tools
+- **Learning Path**: Progressive disclosure from beginner to advanced
+- **Accessibility**: Bilingual support for English and Chinese developers
+
 ## [1.3.0] - 2026-01-23
 
 ### Added - Watch Mode Automation System 🤖