prjct-cli 0.5.1 → 0.7.0

package/CHANGELOG.md

@@ -7,9 +7,165 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2025-10-03
+
+### Changed
+
+- **Philosophy Transformation** - Complete rebrand from PM tool to developer momentum tool
+  - **Problem**: "Project management" messaging didn't match target audience (indie hackers, solo builders, small teams)
+  - **Solution**: Eliminated ALL "project management" language across entire codebase
+  - **Messaging**: "Just Ship. No BS" for creators, not managers
+  - **Files Modified**:
+    - `CLAUDE.md` - Changed project description from "AI-integrated project management framework" to "developer momentum tool for solo builders, indie hackers, and small teams (2-5 people). Just ship. No BS."
+    - `README.md` - Removed "project management overhead" → "meetings or BS overhead"
+    - `templates/agents/AGENTS.md` - Complete rewrite (165→143 lines) with anti-PM messaging: "NOT project management. NO sprints, story points, ceremonies, or meetings."
+    - `CHANGELOG.md` - Updated historical references
+    - **Website** - Transformed all copy to creator-focused messaging:
+      - `Hero.tsx`, `Features.tsx` - "PM, Frontend..." → "Coordinator, Frontend..."
+      - `ClaudeSuperpowers.tsx` - "PM Agent - Task breakdown & planning" → "Coordinator - Progress tracking & shipping"
+      - `Privacy.tsx` - "project management tool" → "developer momentum tool"
+  - **Result**: Zero "PM" or "project management" references (except as critique of traditional tools)
+
+- **Agent System Redesign** - Renamed PM agent to Coordinator
+  - **Problem**: "Project Manager" agent didn't align with "no BS" philosophy
+  - **Solution**: Complete agent transformation
+  - **Changes**:
+    - Renamed `pm.template.md` → `coordinator.template.md` (85→35 lines, 58% reduction)
+    - Role: "Project Manager" → "Progress Coordinator"
+    - Focus: Task breakdown/planning → Progress tracking & shipping features
+    - Updated `core/agent-generator.js` baseAgents: `'pm'` → `'coordinator'`
+    - Agent color: Blue → Cyan
+  - **Breaking Change**: Existing projects need `/p:sync` to regenerate agents
+  - **Philosophy**: "Keep builders aligned on what matters: shipping features, tracking wins, staying focused" + "SHIP features and track progress, not manage people or run meetings"
+
+- **Template Optimization** - 46.5% reduction in agent template verbosity
+  - **Problem**: Templates filled context window with verbose pre-written content
+  - **Solution**: Use instructions + placeholders instead of examples
+  - **Results**:
+    - Total reduction: 540 → 289 lines (46.5% overall)
+    - `fe.template.md`: 43→28 lines (35%)
+    - `be.template.md`: 43→28 lines (35%)
+    - `ux.template.md`: 50→28 lines (44%)
+    - `qa.template.md`: 55→28 lines (49%)
+    - `scribe.template.md`: 96→30 lines (69% - biggest reduction!)
+    - `coordinator.template.md`: 85→35 lines (58%)
+    - `devops.template.md`, `mobile.template.md`, `data.template.md`, `security.template.md`: All reduced to 28 lines
+  - **Strategy**: Compressed expertise lists (5→3 items), simplified principles, used placeholders like `[PROJECT_NAME]`, `[DETECTED_STACK]`
+  - **Benefit**: Agents load faster, consume fewer tokens, maintain clarity
+
+## [0.5.3] - 2025-10-02
+
+### Fixed
+
+- **Website Build Issues** - Fixed ES module compatibility for browser
+  - **Problem**: Command registry using CommonJS `require()` caused runtime errors in browser
+  - **Solution**:
+    - Created ES module version at `website/src/data/command-registry.ts`
+    - Converted `module.exports` to `export default`
+    - Replaced `require()` with ES6 `import` in Components.tsx
+    - Added proper TypeScript type annotations
+  - **Files Modified**:
+    - `website/src/data/command-registry.ts` (NEW) - ES module version with TypeScript types
+    - `website/src/pages/Commands.tsx` - ES6 import, removed TypeScript `any` types
+  - **Result**: Website now loads correctly with dynamic command generation from registry
+
+- **Documentation Accuracy** - Updated Getting Started guide with correct installation flow
+  - **Problem**: Documentation showed incorrect setup steps (missing npm install and prjct start)
+  - **Solution**: Updated to reflect actual installation process:
+    1. `npm install -g prjct-cli` - Global installation
+    2. `prjct start` - Setup Claude Code integration
+    3. `/p:init` - Initialize project
+    4. `/p:now` - Start working
+  - **Files Modified**:
+    - `website/src/pages/Documentation.tsx` - Corrected Getting Started section
+
+## [0.5.2] - 2025-10-02
+
+### Added
+
+- **Command Registry System** - Single source of truth for all prjct commands (`core/command-registry.js`)
+  - **Problem**: Commands were dispersed across 4 locations with inconsistencies:
+    - `bin/prjct` (15 commands in help)
+    - `website/Commands.tsx` (18 commands displayed)
+    - `CLAUDE.md` (18 commands documented)
+    - `templates/commands/` (21 template files)
+  - **Solution**: Created `core/command-registry.js` as centralized registry
+  - **Features**:
+    - All 25 commands defined in single location with metadata
+    - Category system (work, planning, design, quality, progress, help, git, testing, setup)
+    - Implementation status tracking (19 implemented, 6 planned)
+    - Platform availability (Claude Code vs Terminal)
+    - Template file mapping
+    - Helper functions for filtering, querying, and statistics
+  - **Files Modified**:
+    - `core/command-registry.js` (NEW) - 430 lines, complete command metadata
+    - `bin/prjct` - Dynamic help generation from registry
+    - `website/Commands.tsx` - Auto-generated command categories
+    - `CLAUDE.md` - Command list synced with registry
+    - `scripts/validate-commands.js` (NEW) - Automated validation tool
+  - **Validation**:
+    - Registry structure validation (duplicates, invalid categories)
+    - Template file consistency check
+    - Implementation verification (camelCase method detection)
+    - CLI switch case validation
+    - Automated validation script with colored output
+  - **Benefits**:
+    - ✅ Zero inconsistencies - single source of truth
+    - ✅ Easy to add new commands - update one file
+    - ✅ Automated validation prevents drift
+    - ✅ Statistics tracking (25 total, 19 implemented)
+    - ✅ Clear roadmap (6 planned features visible)
+  - **Usage**: `node scripts/validate-commands.js` to verify consistency
+
+- **Complete Workflow System Integration** - Automated task orchestration with AI workflow agents
+  - **Features**:
+    - **Auto-initialization**: Workflows activate automatically when using `/p:idea "implement [feature]"`
+    - **Task Classification**: Automatic detection of workflow type (ui, api, bug, refactor, feature)
+    - **Capability Detection**: Detects design system, test framework, docs system
+    - **Interactive Prompts**: Asks user to choose tools when capabilities are missing
+    - **Step Progression**: Each `/p:done` advances to next workflow step
+    - **Agent Assignment**: Each step assigned to appropriate specialist agent
+    - **Workflow Status**: New `/p:workflow` command shows progress and remaining steps
+  - **Files Modified**:
+    - `core/commands.js` - Integrated workflow engine into `idea()`, added `workflow()` command
+    - `core/agent-generator.js` - Corrected to use project-specific agents directory
+  - **Architecture**:
+    - Workflows stored in `~/.prjct-cli/projects/{id}/workflow/state.json`
+    - Agents stored in `~/.prjct-cli/projects/{id}/agents/`
+    - 5 workflow types with specialized step sequences
+    - 10 agent types: pm, ux, fe, be, qa, scribe, security, devops, mobile, data
+  - **Usage**:
+    1. `p. implement auth system` → Auto-creates workflow
+    2. `p. now` → Start first step
+    3. `p. done` → Complete step, advance to next
+    4. `p. workflow` → Check progress
+  - **Result**: Fully automated task orchestration with smart step-by-step guidance
+
+- **`/p:sync` Command Implementation** - Sync project state and update workflow agents
+  - **Root Cause**: Template existed but method was not implemented in `core/commands.js`
+  - **Files Modified**:
+    - `core/commands.js` (added `sync()` method with proper global path)
+    - `core/agent-generator.js` (corrected to use project-specific agents directory)
+  - **Architecture Fix**:
+    - Agents are **NOT** for Claude's `~/.claude/agents/` (that was wrong)
+    - Agents are **workflow specialists** stored in `~/.prjct-cli/projects/{id}/agents/`
+    - Used for task assignment in workflow system
+    - Each agent (pm, ux, fe, be, qa, scribe, security, devops, mobile, data) handles specific workflow steps
+  - **Features**:
+    - Re-analyzes project with `/p:analyze` (silent mode)
+    - Generates/updates workflow agents in global project directory
+    - Creates base agents: pm, ux, fe, be, qa, scribe
+    - Creates conditional agents: security, devops, mobile, data (based on stack)
+    - Logs sync action to `memory/context.jsonl`
+    - Shows summary and agents path
+  - **Usage**: `p. sync` or `/p:sync`
+  - **When to Use**: After dependency changes, framework updates, before using workflows
+  - **Result**: Workflow agents ready for task assignment in `~/.prjct-cli/projects/{id}/agents/`
+
 ## [0.5.1] - 2025-10-02
 
 ### Fixed
+
 - **Critical: `prjct start` Command Error** - Fixed "commandInstaller.detectEditors is not a function" error
   - **Root Cause**: v0.5.0 refactored `command-installer.js` to Claude-only architecture but didn't update calling code
   - **Files Modified**: `core/commands.js` (lines 2227-2374)
@@ -21,9 +177,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     - Simplified `setup()` function with installation status checking
     - Added `--force` flag support for reinstallation
   - **Result**: Both `prjct start` and `prjct setup` now work correctly
-  - **Commands Installed**: Successfully installs all 21 /p:* commands to `~/.claude/commands/p/`
+  - **Commands Installed**: Successfully installs all 21 /p:\* commands to `~/.claude/commands/p/`
 
 ### Fixed
+
 - **Corrected Claude Subscription Messaging** - Clarified honest pricing throughout
   - Updated `website/src/pages/Changelog.tsx`:
     - Changed "Claude Code is 100% free" → "Works with whatever Claude subscription you have (free tier or Pro)"
@@ -52,6 +209,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Website now compiles without TypeScript errors
 
 ### Changed
+
 - **Website Alignment with p. Trigger** - ALL website components now show p. trigger correctly
   - Updated `website/src/components/Features.tsx`:
     - Changed "p. Trigger" description to show multiple examples
@@ -86,6 +244,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     - Real-world examples for creators
 
 ### Added
+
 - **p. Trigger System** - Zero memorization interface for prjct context
   - Simple prefix `p.` signals prjct context (e.g., "p. analiza esto")
   - Works in any language: English, Spanish, German, etc.
@@ -102,6 +261,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Works natively in Claude Code and Claude Desktop
 
 ### Changed
+
 - **Natural Language System** - Enhanced with p. trigger and context validation
   - Updated `CLAUDE.md` with complete p. trigger detection logic
   - Added context validation examples and patterns
@@ -119,7 +279,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Website Alignment** - Updated all components to show p. trigger as primary interface
   - `website/src/components/Hero.tsx`:
     - Updated p. Trigger feature description
-    - Changed badge to "Built for Claude Code - Claude Desktop"
+    - Changed badge to "Built for Claude Code"
     - Restored Windsurf Extension CTA with scroll-to-section functionality
     - Added Sparkles and ArrowRight animated icons
   - `website/src/components/Features.tsx`:
@@ -151,6 +311,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     - Maintains page flow and user journey
 
 ### Fixed
+
 - **🐛 Natural Language Context Bug** - Fixed error messages when context is missing
   - Before: "⏺ No hay tarea activa en este momento..." (technical error)
   - After: "✨ You're not working on anything right now! Want to start something?" (conversational)
@@ -158,6 +319,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Claude automatically validates and provides friendly guidance
 
 ### Technical Implementation
+
 - **Zero External Dependencies** - All functionality via CLAUDE.md
   - No SDK required (initially considered but removed)
   - Uses Claude Code's native session (zero API keys)
@@ -166,6 +328,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - No additional costs for users
 
 ### Coming Soon
+
 - **Windows Compatibility** - Native Windows support
   - PowerShell and CMD command execution
   - Windows path handling (`%USERPROFILE%\.prjct-cli\`)
@@ -205,6 +368,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 **prjct-cli is now a developer momentum tool, NOT a project management tool.**
 
 **The Philosophy:**
+
 - Ship fast, stay focused, no BS
 - For indie hackers and small teams (2-5 devs)
 - No Jira, no ceremonies, no bureaucracy
@@ -242,6 +406,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
    - Honest compatibility (only claim what works)
 
 **Migration Path:**
+
 - **Using Claude?** → `npm update -g prjct-cli` (you're all set!)
 - **Using Cursor/Windsurf/Codex?** → Switch to Claude Code (free) or stay on v0.4.10
 - **See [MIGRATION.md](MIGRATION.md) for complete upgrade guide**
@@ -249,6 +414,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 **This isn't a limitation - it's a strategic decision that makes prjct-cli better for developers who ship fast.**
 
 ### Added
+
 - **Dynamic AI Agent System** - Automatic generation of specialized AI agents based on project stack
   - **GitIntegration Module** (`core/git-integration.js`)
     - Repository validation and state tracking
@@ -310,6 +476,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Comprehensive sync reporting and logging
 
 ### Changed
+
 - **Agent Architecture** - 100% Claude-focused (Claude Code + Claude Desktop)
   - Agents stored in `~/.claude/agents/` directory
   - Markdown format with YAML frontmatter (Claude native)
@@ -318,6 +485,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Limited expertise per agent (focused specialization)
 
 ### Technical Details
+
 - **10 Agent Templates** in `templates/agents/`
   - 6 base templates (always generated)
   - 4 conditional templates (stack-dependent)
@@ -335,6 +503,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.4.10] - 2025-10-02
 
 ### Changed
+
 - **Agent Workflow Initialization** - `prjct init` now properly initializes AI agent workflows
   - When existing codebase detected, prompts user to run `/p:analyze`
   - Enables AI agents to follow complete analysis workflow
@@ -342,6 +511,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Replaced silent programmatic analysis with workflow-driven approach
 
 ### Fixed
+
 - **Analysis Workflow** - AI agents now receive proper instructions during project initialization
   - Removed silent `analyze()` call that bypassed agent workflows
   - Agent workflows now activate when user runs `/p:analyze` command
@@ -350,6 +520,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.4.9] - 2025-10-02
 
 ### Added
+
 - **Editor Uninstallation** - `prjct start` now allows removing editors
   - Interactive checkbox selection shows currently installed editors
   - Uncheck an editor to remove all prjct commands from it
@@ -357,12 +528,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - User has full control over which editors have prjct commands
 
 ### Changed
+
 - **`prjct start` Never Blocks** - Removed "already set up" error
   - Can run `prjct start` anytime to reconfigure editors
   - Shows beautiful ASCII art every time
   - User decides which editors to keep/remove
 
 ### Fixed
+
 - **Interactive Prompts** - Better UX for editor selection
   - Pre-selects currently installed editors
   - Clear message: "Select AI editors (uncheck to remove)"
@@ -371,6 +544,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.4.8] - 2025-10-02
 
 ### Added
+
 - **Intelligent Project Initialization** - `prjct init` now works seamlessly in all scenarios
   - Preserves existing project IDs when re-initializing
   - Automatically merges local data with global structure
@@ -380,6 +554,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Multiple developers can initialize the same project without conflicts
 
 ### Fixed
+
 - **Auto-Migration Removed** - Disabled intrusive automatic migration
   - Migration no longer runs automatically during `prjct init` or any command
   - Users can run `prjct migrate-all` manually if needed
@@ -387,6 +562,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Cleaner, non-intrusive installation and update experience
 
 ### Changed
+
 - **`prjct init` Never Blocks** - Removed "already initialized" error
   - Always allows re-initialization with intelligent data fusion
   - Global architecture enables multi-developer workflows
@@ -394,8 +570,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.4.7] - 2025-10-02
 
 ### Fixed
+
 - **`prjct start` ASCII Art** - Restored beautiful Catppuccin-inspired colors
-  - Original design from install.sh with (ﾉ◕ヮ◕)ﾉ*:･ﾟ✧
+  - Original design from install.sh with (ﾉ◕ヮ◕)ﾉ\*:･ﾟ✧
   - Vibrant magenta, cyan, and blue gradient for logo
   - Clean, professional look with value propositions
   - Better visual hierarchy and branding
@@ -406,6 +583,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.4.6] - 2025-10-02
 
 ### Added
+
 - **`prjct start` Command** - First-time setup with interactive editor selection
   - Beautiful ASCII art welcome message
   - Auto-detects installed AI editors (Claude Code, Cursor, Windsurf)
@@ -420,6 +598,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Seamless workflow: `cd project/ && prjct now "task"` just works
 
 ### Changed
+
 - **Simplified Installation Flow**
   - `npm install -g prjct-cli` → Shows welcome message, tells user to run `prjct start`
   - `prjct start` → Interactive setup (first-time only)
@@ -434,6 +613,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Cleaner, more predictable behavior
 
 ### Fixed
+
 - **Critical Bug Fixes** - All commands now enforce global architecture correctly
   - `/p:design` now creates designs in global `analysis/designs/` instead of local `.prjct/designs/`
   - `/p:cleanup` now operates on global project data instead of local `.prjct/`
@@ -444,6 +624,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - **Added 'Apps' directory** to migration scanner for better project detection
 
 ### Technical Details
+
 - **New Commands**:
   - `start()` - First-time setup with ASCII art and interactive editor selection
   - `setup()` - Renamed from `install()` for clarity
@@ -459,6 +640,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.4.4] - 2025-10-02
 
 ### Added
+
 - **Automatic Editor Command Updates** - Commands auto-update when npm package is updated
   - New `core/editors-config.js` tracks which editors user has installed commands to
   - Stores editor selections in `~/.prjct-cli/config/installed-editors.json`
@@ -487,12 +669,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Uses existing battle-tested `core/migrator.js` system
 
 ### Changed
+
 - **Improved Command Tracking** - Always track editor installations for better update management
   - Modified `installToSelected()` to always save editor config (removed `!forceUpdate` restriction)
   - Ensures tracking happens even during force updates
   - Enables reliable auto-updates across all configured editors
 
 ### Fixed
+
 - **Global Architecture Enforcement** - All commands now enforce global architecture correctly
   - `/p:design` now creates designs in global `analysis/designs/` instead of local `.prjct/designs/`
   - `/p:cleanup` now operates on global project data instead of local `.prjct/`
@@ -503,6 +687,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - **Added 'Apps' directory** to migration scanner for better project detection
 
 ### Technical Details
+
 - **Post-Install Hook**: Runs after `npm install -g prjct-cli` or `npm update -g prjct-cli`
   - First install: Auto-detects editors and installs commands
   - Updates: Checks version change and auto-updates commands in tracked editors
@@ -529,6 +714,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.4.3] - 2025-10-02
 
 ### Added
+
 - **Automatic Editor Command Updates** - Commands auto-update when npm package is updated
   - New `core/editors-config.js` tracks which editors user has installed commands to
   - Stores editor selections in `~/.prjct-cli/config/installed-editors.json`
@@ -556,6 +742,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Free hosting for public repositories with automatic authentication
 
 ### Changed
+
 - **Installation Documentation** - Updated README with dual installation options
   - Primary: npm registry (recommended for most users)
   - Alternative: GitHub Packages (for advanced users or npm fallback)
@@ -567,6 +754,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Improved error handling and reporting
 
 ### Technical Details
+
 - **Editor Tracking**: Configuration saved after all successful command installations
 - **Post-Install Hook**:
   - Runs only for global installations, skips for local/dev installs
@@ -584,6 +772,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.4.2] - 2025-10-02
 
 ### Fixed
+
 - **Analyzer Compatibility** - Fixed ENOENT error when running `/p:init` in non-prjct projects
   - Added validation to check if `bin/prjct` exists before reading
   - Analyzer now works correctly in any project type (React, Vue, etc.)
@@ -598,6 +787,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.4.1] - 2025-10-01
 
 ### Added
+
 - **Automatic Update Detection** - Built-in update checker that notifies users of new versions
   - Checks npm registry every 24 hours for new versions
   - Non-blocking background check during command execution
@@ -606,13 +796,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Respects 24-hour cache to minimize npm registry requests
 
 - **Automated npm Publication** - GitHub Actions workflow for automatic npm publishing
-  - Triggered on version tags (v*)
+  - Triggered on version tags (v\*)
   - Automatic version verification against package.json
   - Provenance publishing with npm attestation
   - Post-publication verification
   - Publication summary in GitHub Actions
 
 ### Changed
+
 - **Installation Method** - npm is now the primary and recommended installation method
   - Simplified to single installation method: `npm install -g prjct-cli`
   - Removed Homebrew and Bun installation scripts
@@ -620,6 +811,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Reduced package size: 104.6 KB (71 files)
 
 ### Fixed
+
 - **Package Structure** - Improved npm package configuration
   - Added `files` field to control package contents
   - Created `.npmignore` for development file exclusion
@@ -627,6 +819,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Fixed CI/CD tests to verify CLI functionality instead of individual modules
 
 ### Technical Details
+
 - **Update Checker**: `core/update-checker.js` with semantic version comparison
 - **Cache Management**: Update checks cached for 24 hours in `~/.prjct-cli/config/update-cache.json`
 - **Architecture**: Clean separation between npm installation (`/opt/homebrew/lib/node_modules/prjct-cli/`) and user data (`~/.prjct-cli/`)
@@ -635,6 +828,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.4.0] - 2025-10-01
 
 ### Added
+
 - **Interactive Workflow System** - Intelligent agent workflows with user-guided capability installation
   - **Adaptive Workflows**: Workflows detect missing capabilities and prompt user for decisions
   - **Smart Recommendations**: Stack-aware tool suggestions (React → Vitest, Vue → Vitest, Angular → Jest)
@@ -657,6 +851,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Enhanced `idea()`: Auto-initializes workflows for actionable tasks
 
 ### Changed
+
 - **Workflow Behavior**: Transformed from auto-skip to interactive prompting
   - Before: Missing capability → auto-skip step
   - After: Missing capability → prompt user → track installation → continue
@@ -664,6 +859,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Installation Visibility**: Tool installations appear as first-class workflow tasks
 
 ### Technical Details
+
 - **Stack Detection**: Identifies React/Vue/Angular, TypeScript, bundler (Vite/Webpack/esbuild)
 - **Tool Recommendations**:
   - React + TS → Vitest + Testing Library
@@ -678,6 +874,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.3.2] - 2025-10-01
 
 ### Fixed
+
 - **Interactive Installation Compatibility** - Fixed interactive editor selection failing due to inquirer ESM compatibility issues
   - Replaced inquirer v12 with prompts v2.4.2 for better CommonJS compatibility
   - inquirer v12 required complex ESM dynamic imports causing "prompt is not a function" errors
@@ -690,6 +887,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.3.1] - 2025-10-01
 
 ### Fixed
+
 - **Installation Path Resolution Error** - Fixed "setup.sh: No such file or directory" error during installation (#11)
   - Corrected path resolution in installation scripts (docs/install.sh, scripts/install.sh, scripts/setup.sh)
   - Added verification tests in `tests/verify-install-paths.sh`
@@ -699,6 +897,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.3.0] - 2025-09-30
 
 ### Added
+
 - **Intelligent Codebase Analysis & Sync** - Auto-detect implemented features and sync project state
   - `/p:analyze` command to analyze codebase and detect implemented commands/features
   - `/p:analyze --sync` to automatically update `.prjct/` files with real implementation state
@@ -724,7 +923,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Optimizes installation by avoiding unnecessary editor installations
 
 ### Changed
-- **Updated branding** - New header design with kaomoji (ﾉ◕ヮ◕)ﾉ*:･ﾟ✧
+
+- **Updated branding** - New header design with kaomoji (ﾉ◕ヮ◕)ﾉ\*:･ﾟ✧
   - Refreshed README.md header with fun, friendly design
   - Updated installer (scripts/install.sh) to match new branding
   - Consistent visual identity across documentation and installation experience
@@ -732,6 +932,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.2.1] - 2025-09-30
 
 ### Added
+
 - **Multi-Editor Command Installation** - Automatic slash command deployment across AI editors
   - `prjct install` command to install/update commands in all detected editors
   - Automatic detection of Claude Code, Cursor AI, and Codeium installations
@@ -764,6 +965,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Preserves 100% of data during migration (files and directories)
 
 ### Changed
+
 - **Multi-Editor Support**
   - Updated command templates to use global architecture paths
   - Modified `prjct init` to automatically detect and install commands
@@ -796,6 +998,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Enhanced init command with automatic editor installation
 
 ### Fixed
+
 - Added missing `getGlobalBasePath()` method to path-manager.js
 - Improved error handling in migration system
 - Fixed paths in GitHub Actions workflow after reorganization
@@ -829,6 +1032,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Automatic detection via GitHub CLI or git config
 
 ### Added
+
 - **Global Data Storage System**
   - Project data stored in `~/.prjct-cli/projects/[hash-id]/`
   - Prevents bundle size inflation and accidental commits to git
@@ -877,6 +1081,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Auto-accept mode when running through pipe (curl)
 
 ### Changed
+
 - **Data Location**: Moved from `.prjct/` to `~/.prjct-cli/projects/[id]/`
 - **Memory Logs**: Now include `author` field in all entries
 - **File Structure**: Organized into layers (core, progress, planning, analysis, memory)
@@ -884,13 +1089,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **All Commands**: Updated to use global paths and track authorship
 
 ### Removed
+
 - Local `.prjct/` directory usage (replaced with global storage)
 - Legacy flat file structure (replaced with layered architecture)
 
 ### Migration Guide
+
 See [MIGRATION.md](MIGRATION.md) for detailed migration instructions.
 
 **Quick Migration**:
+
 ```bash
 # Projects will auto-detect migration need
 # Run init to trigger migration
@@ -903,12 +1111,14 @@ See [MIGRATION.md](MIGRATION.md) for detailed migration instructions.
 ### Breaking Change Impact
 
 **For Individuals**:
+
 - ✅ One-time migration required (automatic, zero data loss)
 - ✅ Cleaner repositories (no `.prjct/` bloat)
 - ✅ No accidental commits of personal work logs
 - ✅ Better privacy for your productivity tracking
 
 **For Teams**:
+
 - ✅ Share `.prjct/prjct.config.json` for coordination
 - ✅ Each member tracks privately with author info
 - ✅ No exposure of individual work patterns
@@ -916,22 +1126,25 @@ See [MIGRATION.md](MIGRATION.md) for detailed migration instructions.
 - ✅ Perfect for open source, remote teams, consulting
 
 **For Projects**:
+
 - ✅ Git Repositories: `.prjct/` safely removed after migration
 - ✅ CI/CD Pipelines: No changes needed - data fully external
 - ✅ Bundle Size: Zero impact from prjct tracking
 - ✅ Collaboration: Non-intrusive team workflow ready
 
 ### Fixed
+
 - Arithmetic operation syntax error in command counting (from previous unreleased)
 - Version detection for existing installations (from previous unreleased)
 
 ## [0.1.0] - 2024-01-XX
 
 ### Added
+
 - Initial release of prjct-cli
-- AI-integrated project management system
+- AI-integrated developer momentum tool
 - Support for Claude Code, OpenAI Codex, and Terminal
 - Core commands: init, now, done, ship, recap, etc.
 - MCP integration for AI assistants
 - Automatic environment detection
-- Project structure in `.prjct/` directory
+- Project structure in `.prjct/` directory