ai-qakit 1.0.0

package/templates/.cursor/CHANGELOG.md

@@ -0,0 +1,540 @@
+# Changelog
+
+All notable changes to the Cursor IDE configuration will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## 1.8.0 - 2025-12-22
+
+### Added
+
+- **New Spec Commands**:
+  - `/spec:deep-capture-requirement` - Comprehensive deep analysis of complex existing codebase
+  - `/spec:update-plan` - Update and refine existing implementation plan
+  - `/spec-lite:update-plan` - Lightweight version for updating spec-lite plans
+
+### Changed
+
+- **Spec Workflow Enhancements**:
+  - Enhanced workflow sequence with phase continuation prompts between implementation phases
+  - Improved requirement and plan update workflows
+
+- **Command Templates**:
+  - Enhanced `/spec:brainstorm` and `/spec:capture-requirement` workflows
+  - Updated helper.py with new command mappings and TASK-ID format hints
+
+## 1.7.2 - 2025-12-20
+
+### Added
+
+- **Help Command** (`devkit/help.md`):
+  - All-in-one AI-DevKit usage guide with dynamic command discovery
+  - Version and changelog display via `/devkit:help version` or `/devkit:help changelog`
+  - Task-based command recommendations with output type markers for LLM guidance
+  - Complete workflow documentation for spec, spec-lite, fix, and review workflows
+
+- **Helper Script** (`scripts/helper.py`):
+  - Powers the help command with runtime command scanning
+  - Scans `.cursor/commands/` directory to build catalog dynamically
+  - Category workflows and task keyword mappings for intent detection
+
+- **Version Tracking**:
+  - `CHANGELOG.md` for Cursor-specific changelog
+  - `settings.json` for Cursor-specific version tracking
+
+---
+
+## 1.7.0 - 2025-12-19
+
+### Added
+
+- **Documentation Commands**:
+  - `devkit/docs/init.md` - Initialize project documentation structure
+  - `devkit/docs/update.md` - Update existing documentation
+
+### Changed
+
+- **Command Organization**:
+  - Reorganized all commands under `commands/devkit/` folder for better namespace organization
+  - Affects 45+ command files across Cursor templates
+  - Commands now accessible via `/devkit:` prefix (e.g., `/devkit:spec:plan`, `/devkit:fix`)
+
+- **Sub-Agent Report Protocol**:
+  - Added mandatory "Phase 0: Sub-Agent Report Preference" step to all spec and spec-lite commands
+  - Orchestrator must now ask users for report preference (Inline vs Detailed) BEFORE spawning any sub-agent
+  - Commands updated: `spec/brainstorm`, `spec/capture-requirement`, `spec/cook`, `spec/plan`, `spec/implement`, `spec/test`
+  - Commands updated: `spec-lite/plan`, `spec-lite/do`, `spec-lite/test`
+  - Research command also updated with mandatory report preference gate
+
+- **Question Resolution Pattern**:
+  - Added mandatory question resolution phase to `spec/brainstorm` command
+  - Added mandatory question resolution phase to `spec/update-requirement` command
+  - Added mandatory question resolution phase to `docs/capture-knowledge` command
+  - Commands now use AskUserQuestion to resolve open questions before completing
+
+- **Documentation**:
+  - Updated 6 guide files with current command paths
+  - Updated doc-templates for improved structure
+
+### Removed
+
+- **Templates**:
+  - `doc-templates/project-roadmap.md` - Removed from template set
+
+---
+
+## 1.6.6 - 2025-12-19
+
+### Changed
+
+- **Commands**:
+  - Updated `templates/.cursor/commands/fix/hard.md` - Simplified project management workflow
+  - Updated `templates/.cursor/commands/spec-lite/test.md` - Minor improvements
+- **Documentation**:
+  - Updated `TODO.md` with new task tracking items
+
+---
+
+## 1.6.5 - 2025-12-19
+
+### Added
+
+- **Build System**:
+  - Root-level `Makefile` with `scan`, `scan-commands`, `scan-skills` targets
+  - Root-level `requirements.txt` for Python dependencies (pyyaml>=6.0)
+
+### Changed
+
+- **Commands**:
+  - Moved `create-test.md` from `frontend/` subfolder to root commands directory
+
+### Removed
+
+- Duplicate `requirements.txt` from `templates/.cursor/scripts/` (consolidated to root)
+
+---
+
+## 1.6.4 - 2025-12-19
+
+### Changed
+
+- **Orchestration Protocol**:
+  - Updated anti-patterns to explicitly recommend specialized tools over grep/glob for multi-file searches
+
+---
+
+## 1.6.3 - 2025-12-18
+
+### Added
+
+- **Structured Context Protocol**:
+  - New protocol for passing task metadata (task-id, platform, task-type, files, technologies) from main agent to sub-agents
+  - Enables deterministic skill detection based on context signals
+  - Context-to-skill mapping (e.g., `platform: frontend` + `task-type: ui` triggers frontend rules)
+
+- **Sub-Agent Report Generation Protocol**:
+  - Orchestrator must ask user about report preference before spawning report-capable agents
+  - `generate_report: true/false` parameter for sub-agent prompts
+
+### Changed
+
+- **Requirement File Naming**:
+  - Standardized requirement file naming with numeric prefixes for consistent ordering
+  - Updated spec commands to use new naming convention (e.g., `01-functional-requirements.md`)
+
+- **Command Templates**:
+  - Updated 38 command templates with report protocol reminders
+  - Enhanced `spec-lite/do.md`, `spec/implement.md`, `spec/cook.md` with Structured Context Protocol
+  - Added skill usage reminders to `tester`, `code-reviewer`, `scout`, and `planner` invocations
+
+---
+
+## 1.6.2 - 2025-12-18
+
+### Added
+
+- **New Testing Commands**:
+  - `@spec:test` - Comprehensive file-by-file testing with 100% coverage target
+  - `@spec-lite:test` - Streamlined testing for lite tasks
+  - Both commands added for Cursor IDE templates
+
+### Changed
+
+- **Testing Separation from Implementation**:
+  - `@spec:implement` now focuses solely on coding (testing via `@spec:test`)
+  - `@spec-lite:do` no longer includes testing (testing via `@spec-lite:test`)
+  - `@spec:plan` no longer asks about test planning preferences
+
+- **Mandatory User Approval Gate**:
+  - `@spec:implement` Step 4 now requires explicit user approval before finalizing
+  - `@spec-lite:do` Step 4 now requires `AskUserQuestion` for user approval
+  - Implementation cannot proceed without user confirmation
+
+- **Update-Requirement Command Simplification**:
+  - Now lightweight consolidation only (reads existing files, outputs `functional.md` + `notes.md`)
+  - Removed codebase analysis and Ultrathink directive
+  - Removed scope clarification questions
+
+---
+
+## 1.6.1 - 2025-12-18
+
+### Changed
+
+- **Spec Commands**:
+  - `spec:implement` - Testing step now marked as OPTIONAL, only triggers after all plan phases complete
+  - `spec:implement` - Cleanup step only removes active-task file on final phase
+  - `spec:implement` - Updated development rules reference to include both project-specific and general rules
+- **README Documentation**:
+  - Removed numeric counts from Cursor README structure section (prevents staleness)
+
+### Removed
+
+- **Commands**:
+  - `optimize/api-performance.md` - Removed from Cursor commands
+
+---
+
+## 1.6.0 - 2025-12-18
+
+### Added
+
+- **Spec Lite Commands** (Lightweight Task Management):
+  - `spec-lite:task` - Create tasks with inline requirements
+  - `spec-lite:plan` - Quick planning for small tasks
+  - `spec-lite:do` - Execute lightweight tasks
+  - Available in Cursor templates
+
+- **Configuration & Setup**:
+  - `config:bootstrap` - New bootstrap command for step-by-step project initialization
+  - `.cursor/.scoutignore` - File exclusion patterns for scout operations
+
+### Changed
+
+- **Commands**:
+  - `spec:capture-requirement` - Added Ultrathink directive and active-task saving support
+  - `spec:plan` - Added Ultrathink directive and active-task saving support
+  - `spec:implement` - Enhanced with active-task saving, auto-commit removed, cleanup step added
+  - `config:init-backend` - Enhanced initialization process (Cursor)
+  - `scout` - Updated to support .scoutignore patterns
+  - `review:codebase` - Enhanced codebase review process
+
+- **Rules** (Quality improvements across all):
+  - Updated `research.mdc` rule
+
+- **Templates & Documentation**:
+  - Quick start guides (CURSOR) - Expanded with Spec Lite command documentation
+  - README files updated for Cursor templates
+  - `doc-templates/codebase-summary.md` - Template improvements
+  - `workflows/development-rules.md` - Updated development standards
+  - `workflows/documentation-management.md` - Enhanced documentation practices
+
+### Removed
+
+- **Deprecated Commands** (Cursor):
+  - `config:init-full.md` - Removed in favor of bootstrap command
+  - `config:sync-ai-context.md` - Deprecated sync command
+  - `config:sync-incremental.md` - Deprecated incremental sync command
+
+---
+
+## 1.5.2 - 2025-12-17
+
+### Changed
+
+- **Documentation Templates**:
+  - `system-architecture.md` (Cursor) - Simplified agent workflow diagram by removing version control steps
+  - `codebase-summary.md` (Cursor) - Removed git-manager agent reference from agent list
+
+---
+
+## 1.5.0 - 2025-12-15
+
+### Added
+
+- **Documentation**:
+  - `TROUBLESHOOTING.md` - Comprehensive troubleshooting guide covering agent failures, skill activation issues, command errors, and storage path issues
+
+- **JavaScript Pro Rule (Cursor)**:
+  - `javascript-pro.mdc` - Cursor IDE rule with complete reference set (7 files)
+
+- **TypeScript Pro Rule (Cursor)**:
+  - `typescript-pro.mdc` - Cursor IDE rule with complete reference set (8 files)
+
+- **Python Pro Rule (Cursor)**:
+  - `python-pro.mdc` - Cursor IDE rule for modern Python 3.10+ development with async/await, type hints, and testing; complete reference set (7 files)
+  - `references/async-patterns.md` - TaskGroup, structured concurrency, async generators
+  - `references/error-handling.md` - Exception design, logging, context managers
+  - `references/performance.md` - Profiling, memory optimization, Cython integration
+  - `references/project-setup.md` - pyproject.toml, UV package manager, Ruff configuration
+  - `references/security.md` - Input validation, secrets management, secure coding
+  - `references/testing.md` - pytest fixtures, parametrization, Hypothesis property testing
+  - `references/type-system.md` - Generics, Protocols, TypedDict, runtime checking
+
+---
+
+## 1.4.1 - 2025-12-15
+
+### Changed
+
+- **Frontend Development Rule (Templates)**:
+  - Refocused from multi-framework (React/Vue/Svelte/Angular) to React 18+ specialization
+  - Adopted Feature Sliced Design (FSD) as standard architecture pattern
+  - Reorganized from `resources/` to `references/` folder structure for better navigation
+  - Updated technology stack: TanStack Query, Apollo Client, Zustand, React Hook Form + Zod
+
+### Added
+
+- **Frontend Development Rules (Cursor)**:
+  - `frontend-development.mdc` - Main rule file for Cursor IDE
+  - Complete reference set mirroring structure (13 reference files)
+
+---
+
+## 1.4.0 - 2025-12-15
+
+### Added
+
+- **Commands**:
+  - `/review:code` command - Validates code against development rules and auto-fixes violations
+
+- **Development Rules (Modular System)**:
+  - `01-core-principles.md` - YAGNI, KISS, DRY, SOLID principles
+  - `02-naming-and-constants.md` - Naming conventions, magic values, consistency
+  - `03-function-design.md` - Size, parameters, utils, types, return values
+  - `04-error-handling.md` - Errors, logging, security considerations
+  - `05-testing.md` - Test pyramid, best practices, naming conventions
+  - `06-code-quality.md` - Documentation, formatting, code review
+  - `07-architecture.md` - Organization, dependencies, module boundaries
+  - `08-performance-security.md` - Optimization, OWASP, secure coding
+  - `index.md` - Quick reference with "15 Clean Code Rules" and pre-commit checklist
+
+### Changed
+
+- **README Documentation**:
+  - Removed all hardcoded numeric counts (commands, agents, skills, hooks, rules) to eliminate maintenance burden
+  - Statistics now use generic descriptions instead of specific numbers
+
+- **Templates**:
+  - `development-rules.mdc` (Cursor) aligned with new modular structure
+
+### Removed
+
+- `common-development-rules.md` - Replaced by modular 9-file rule system for better maintainability and navigation
+
+---
+
+## 1.3.2 - 2025-12-14
+
+### Fixed:
+- **CI/CD Pipeline**:
+  - Fixed Teams notification bullet point formatting (removing top-level bullets and adjusting nested bullet styles for clarity)
+
+---
+
+## 1.3.1 - 2025-12-14
+
+### Fixed:
+- **CI/CD Pipeline**:
+  - Fixed Teams notification bullet point formatting (nested items now display on separate lines)
+
+---
+
+## 1.3.0 - 2025-12-14
+
+### Changed:
+- **Cursor Commands**:
+  - `@research` - Consolidated from `@research/deep` to root-level command
+- **Documentation Updates**:
+  - Updated component counts across all documentation files
+  - Cursor IDE: 38 commands, 22 rules
+  - Fixed command format inconsistencies in quick start guides
+- **CI/CD Pipeline**:
+  - Enhanced Teams notification formatting with markdown cleanup
+  - Added tag validation step for annotated tags
+  - Added Full Changelog link to notifications
+
+### Removed:
+- **Cursor Commands**:
+  - `@review/deep` - Consolidated into `@review/codebase`
+  - `@security/audit` - Moved to skill-based approach
+
+---
+
+## 1.2.1 - 2025-12-14
+
+### Added:
+- **Test Infrastructure**:
+  - 106 unit tests with 100% code coverage
+- **CI/CD Pipeline**:
+  - Test stage added to `.gitlab-ci.yml` (validate → test → build → publish)
+  - Coverage reporting with regex extraction for GitLab UI
+  - Add Team Notification after successful release
+- **Manifest-Based File Tracking**:
+  - Smart update detection: preserve user customizations, remove obsolete files
+- **Documentation**:
+  - `guide/LOCAL_TESTING_PACKAGE.md` - Local package testing guide
+- **Cursor Rules**:
+  - `common-development-rules.md` - Common development rules template
+
+### Changed:
+- **CLI Improvements**:
+  - Simplified CLI interface - no `init` subcommand required
+  - Auto-detect update mode via manifest
+  - Override confirmation dialog when declining backup
+- **Command Updates**:
+  - `@spec:implement` - Updated implementation workflow
+  - `@spec:plan` - Updated planning workflow
+- **Deployment Documentation**:
+  - `DEPLOYMENT.md` - Added test stage documentation and troubleshooting
+
+### Removed:
+- `@wrapup` command (Cursor) - deprecated
+
+---
+
+## 1.2.0 - 2025-12-13
+
+### Added:
+- **CI/CD Pipeline**:
+  - `.gitlab-ci.yml` - Three-stage pipeline (validate → build → publish)
+  - Semantic version tag triggers (`v1.x.x`)
+- **Quick Start Guides**:
+  - `guide/CURSOR_QUICK_START.md` - Getting started with Cursor
+  - `guide/PACKAGE_USAGE.md` - NPM package installation and usage
+- **Deployment Documentation**:
+  - `DEPLOYMENT.md` - Release workflow and CI/CD setup
+- **Documentation Templates**:
+  - `development-rules.md` - Comprehensive senior developer best practices
+- **Cursor Commands**:
+  - `@ui-ux-pro-max` - UI/UX design assistance command
+
+### Changed:
+- **Spec Commands Enforcement**:
+  - `@spec:plan` and `@spec:implement` now strictly follow `./docs/development-rules.md`
+  - Auto-detect coding platform (frontend/backend/fullstack) without user prompts
+- **Cursor Rules**:
+  - `development-rules.mdc` - Added strict development rules enforcement
+- **Package Configuration**:
+  - Updated `prepublishOnly` to block local publishing (CI/CD only)
+
+### Security:
+- Local npm publish blocked - releases only via CI/CD pipeline with version tags
+
+---
+
+## 1.0.1 - 2025-12-13
+
+### Added:
+- **Development Rules Documentation**:
+  - Comprehensive `development-rules.md` template in `doc-templates/`
+- **Spec Commands Enhancements**:
+  - `@spec/update-requirement` command for task requirements reconciliation
+  - Quick Start guides for Spec-Driven Development (Cursor)
+  - Prerequisites section emphasizing `@docs:init` requirement
+- **Documentation Templates**:
+  - `technical-documents.md` template for technical documents
+  - `FEEDBACK_TEMPLATE.md` for devkit feedback
+  - `.repomixignore` file for repomix packaging exclusions
+
+### Changed:
+- **CRITICAL: Strict Development Rules Enforcement**:
+  - `@spec:plan` and `@spec:implement` commands now MUST strictly follow `./docs/development-rules.md`
+- **Documentation Prerequisite Check**:
+  - `@spec:task` command now requires `@docs:init` to be executed first
+  - Verifies `./docs/` directory exists with required files before task creation
+- **Spec Commands Workflow Updates**:
+  - `@spec:implement` updated with phase-based execution
+  - `@spec:plan`, `@spec:brainstorm`, `@spec:capture-requirement` auto-detect coding platform
+- **Template Sync**:
+  - All spec commands synced in `.cursor/` directories
+  - `development-rules.mdc` added to `.cursor/rules/`
+  - Command counts updated: Cursor 41→42
+- **Enhanced Commands**:
+  - `@spec:capture-requirement` with user preference options (platform, test planning)
+  - `@spec:plan` with improved workflow and conditional testing directory
+  - `@ask` command with architectural context, system boundaries, and decision trade-offs
+
+### Fixed:
+- Corrected spec command paths to use `./.cursor/tasks/<task-id>/...`
+- `@spec:task` command refined - removed duplicate skill activation note
+
+---
+
+## 1.0.0 - 2025-12-09
+
+### Added:
+- **Frontend Commands** (Cursor):
+  - `@create-component` - React components with props, state, hooks, styling
+  - `@create-page` - Page/route components with layouts, data fetching, SEO
+  - `@create-form` - Forms with React Hook Form, Zod/Yup, multi-step wizards
+  - `@create-table` - TanStack Table with sorting, filtering, pagination
+  - `@create-api-integration` - API layer (types, services, TanStack Query/SWR/RTK Query)
+  - `@create-storybook` - Storybook stories with CSF3, controls, interaction tests
+  - `@config/init-frontend` - Frontend project initialization
+- **Spec-Driven Development Commands**:
+  - `@spec:task` - Create task directories with structured subdirectories
+  - `@spec:brainstorm` - Brainstorm feature requirements
+  - `@spec:capture-requirement` - Analyze and generate structured requirement artifacts
+  - `@spec:cook` - End-to-end research → plan → implement workflow
+  - `@spec:plan` - Research-backed planning
+  - `@spec:implement` - Execute plan with testing and review gates
+- **Multi-Agent Commands**:
+  - `@implement` - Full feature implementation
+  - `@plan` - Research-backed planning
+  - `@refactor` - Code simplification with verification
+  - `@solve` - Multi-technique problem solving
+  - `@security:audit` - OWASP Top 10 security audit
+  - `@review:deep` - Deep code review with type safety
+  - `@optimize:db` - SQL optimization with EXPLAIN analysis
+  - `@research:deep` - Deep research with report generation
+  - `@update-changelog` - Automatic changelog generation from git diff
+- **Cursor Commands** (41 total):
+  - Frontend: `create-component`, `create-page`, `create-form`, `create-table`, `create-api-integration`, `create-storybook`
+  - Spec: `@spec/task`, `@spec/brainstorm`, `@spec/cook`, `@spec/plan`, `@spec/implement`
+  - Config: `@config/init-frontend`, `@config/init-full`, `@config/sync-ai-context`, `@config/sync-incremental`
+  - Docs: `@docs/init`, `@docs/update`, `@docs/summarize`
+  - Other: `@ask`, `@scout`, `@fix`, `@wrapup`, `@review/codebase`, `@optimize/api-performance`
+- **Cursor Rules** (15 agents):
+  - All agents flattened into `.cursor/rules/*.mdc`
+  - brainstormer, coder, planner, tester, security-agent, tattletale-reporter, researcher, scout, code-simplifier, debugger, docs-manager, project-manager, typescript-pro, ui-ux-designer, cunningham
+- **Workflows**:
+  - `development-rules` - Coding standards and best practices
+  - `documentation-management` - Documentation workflows
+  - `orchestration-protocol` - Multi-agent coordination
+- **Documentation Templates** in `doc-templates/`:
+  - `code-standards.md` - Coding standards template
+  - `codebase-summary.md` - Codebase overview template
+  - `project-overview-pdr.md` - Project Design Review format
+  - `project-roadmap.md` - Roadmap and feature planning
+  - `system-architecture.md` - C4 model architecture template
+  - `technical-documents.md` - Technical documents index
+- **Guides**:
+  - `guide/SPEC_DRIVEN_DEVELOPMENT.md` - How to run spec-driven workflows
+  - `guide/COMMANDS.md` - Full commands reference
+
+### Changed:
+- Reorganized command structure: `init-backend-ultra` → `config/init-backend`
+- Made commands language-agnostic with context detection
+- Backend commands moved to `backend/` subdirectory
+- `@scout` now supports `task-id` and saves reports to task directories
+- `@research:deep` accepts `task-id` and saves to task directories
+- Root `README.md` reorganized with overview, TOC, setup links, features
+- Updated `@config:init-backend` to use doc-templates
+- Enhanced `@docs:init` to use structured templates
+
+### Removed:
+- Deprecated agents: `meta-agent`, `nextjs-pro`
+- Standalone `init-backend` command (merged into config/init-backend)
+- `.cursor/commands/changelog.md` (replaced by `docs/update-changelog.md`)
+
+---
+
+## 0.1.0 - 2025-12-02
+
+### Added:
+- Initial backend devkit for Cursor IDE
+- Base command structure and rule templates
+- Core workflows definitions