prjct-cli 0.46.0 → 0.48.0

package/CHANGELOG.md

@@ -1,3829 +1,91 @@
 # Changelog
 
-## [0.46.0] - 2026-01-30
+## [0.48.0] - 2026-01-30
 
 ### Features
 
-- preserve user customizations during sync - PRJ-115 (#70)
+- Read-before-write enforcement for templates - PRJ-108 (#74)
 
 
-## [0.46.0] - 2026-01-30
+## [0.49.0] - 2026-01-30
 
 ### Added
 
-- **Preserve user customizations during sync** (PRJ-115)
-  - Wrap custom content in `<!-- prjct:preserve -->` markers
-  - Content survives `p. sync` regeneration
-  - Supports named sections: `<!-- prjct:preserve:my-rules -->`
-  - Works with CLAUDE.md, .cursorrules, and all context files
-
-
-## [0.45.5] - 2026-01-30
-
-### Bug Fixes
-
-- implement silent memory application - PRJ-103 (#69)
-
-
-## [0.45.5] - 2026-01-29
-
-### Changed
-
-- Remove meta-commentary from memory output (PRJ-103)
-  - "LEARNED PATTERNS" → "PROJECT DEFAULTS"
-  - "RELEVANT MEMORIES" → "CONTEXT"
-  - "Learned Patterns" → "Project Conventions"
-
-### Added
-
-- `lint:meta` script to catch meta-commentary anti-patterns
-
-
-## [0.45.4] - 2026-01-29
-
-### Bug Fixes
-
-- ignore tar warning in release workflow - PRJ-147
-
-
-## [0.45.3] - 2026-01-29
-
-### Bug Fixes
-
-- remove --provenance (requires public repo) - PRJ-147
-
-
-## [0.45.2] - 2026-01-29
-
-### Bug Fixes
-
-- use Production environment for npm secrets - PRJ-147
-
-
-## [0.45.1] - 2026-01-29
-
-### Bug Fixes
-
-- use semver-sorted tags for version detection - PRJ-147
-- npm auth configuration for CI publish - PRJ-147
-
-
-## [0.42.1] - 2026-01-29
-
-### Bug Fixes
-
-- npm auth configuration for CI publish - PRJ-147
-
-
-## [0.42.0] - 2026-01-29
-
-### Features
-
-- automated release pipeline - PRJ-147 (#68)
-- add project indexing and analysis services (PRJ-85, PRJ-87) (#66)
-- metrics display in output (PRJ-68, PRJ-69) (#54)
-- add prjct uninstall command (PRJ-146) (#65)
-- add prjct doctor command (PRJ-117) (#62)
-- smart watch mode - auto-sync on file changes (PRJ-123) (#61)
-- add --quiet flag for silent output (PRJ-97) (#60)
-- interactive onboarding wizard (PRJ-124) (#58)
-- smart context filtering tools for AI agents (PRJ-127) (#57)
-- workflow state machine + bidirectional Linear sync (#55)
-- progress indicators for long-running operations (PRJ-129) (#52)
-- agent activity stream for real-time visibility (PRJ-135) (#51)
-- show explicit next steps after each command (PRJ-136) (#50)
-- multi-agent output Phase 3 - Auto-detect + Continue.dev (PRJ-126) (#49)
-- multi-agent output Phase 2 - Copilot + Windsurf (PRJ-126) (#48)
-- multi-agent context output - Phase 1 (PRJ-126) (#47)
-- bidirectional sync Linear ↔ prjct (PRJ-142) (#46)
-
-### Bug Fixes
-
-- add Bun setup for test runner in CI - PRJ-147
-- use npm instead of bun for CI tests - PRJ-147
-- remove IDE files from repo - PRJ-144, PRJ-145
-- add --help handler in CLI entry point for CI compatibility
-- update tests for CI compatibility
-- CI workflow - remove unsupported bun reporter flag and fix verification
-- enforce workflow steps in templates (PRJ-143) (#56)
-- add $PRJCT_CLI prefix to relative paths in templates (PRJ-143)
-- use stderr for Linear connection log to not break JSON output
-
-### Performance
-
-- parallelize sync operations for 30-50% speedup (PRJ-116) (#59)
-
-### Refactoring
-
-- migrate from ESLint + Prettier to Biome
-- consolidate and optimize CI workflows
-- extract StackDetector from sync-service (PRJ-86) (#64)
-- extract ContextFileGenerator from sync-service (PRJ-88) (#63)
-
-
-## [0.45.0] - 2026-01-29
-
-### Feature: Smart Context Filtering Tools (PRJ-127)
-
-Terminal tools for AI agents to explore codebases efficiently **without consuming tokens for filtering**.
-
-**New Command: `prjct context <tool>`**
-
-| Tool | Purpose | Compression |
-|------|---------|-------------|
-| `files <task>` | Find relevant files for a task | 93% fewer files |
-| `signatures <path>` | Extract code structure only | ~92% token reduction |
-| `imports <file>` | Analyze dependency graphs | - |
-| `recent [commits]` | Find hot files from git | - |
-| `summary <path>` | Intelligent file summary | ~96% token reduction |
-
-**Real Cost Savings (multi-model support)**
-
-```json
-"cost": {
-  "saved": 2.32,
-  "byModel": [
-    { "model": "claude-sonnet-4.5", "inputSaved": 0.93, "outputPotential": 1.39 },
-    { "model": "gpt-4o", "inputSaved": 0.77, "outputPotential": 0.93 }
-  ]
-}
-```
-
-**Example: Full codebase signatures**
-```bash
-prjct context signatures core/ --recursive
-# 336K → 26K tokens (92% compression)
-# Saves $2.32/call (Sonnet) or $3.87/call (Opus)
-```
-
-**New Files:**
-- `core/context-tools/` - Complete module (7 files)
-- `core/schemas/metrics.ts` - Updated pricing (Jan 2026)
-
-## [0.44.1] - 2026-01-29
-
-### Fixed: Workflow Templates with Mandatory Steps (PRJ-143)
-
-Templates now enforce step-by-step workflows with explicit blocking conditions.
-
-**Problem:** Claude was skipping workflow steps (pushing directly to main, skipping PRs, etc.)
-
-**Solution:** Added ⛔ BLOCKING conditions to critical templates:
-- `ship.md` - Must check branch, create PR, bump version
-- `merge.md` - Must verify PR approval and CI status
-- `task.md` - Pre-flight checks before branch creation
-- `git.md` - Block commits/pushes on main/master
-
-**Also Fixed:**
-- Commit footer simplified to `Generated with [p/](https://www.prjct.app/)` (no emoji, no provider-specific line)
-- All provider templates updated (Claude, Gemini, Cursor, Antigravity, Windsurf)
-- Global CLAUDE.md strengthened with git workflow rules
-
-## [0.44.0] - 2026-01-29
-
-### Feature: Workflow State Machine (PRJ-139)
-
-Explicit states with valid transitions for prjct workflow. Users always know what commands are available.
-
-**States:** `idle` → `working` → `completed` → `shipped` (with `paused` branch)
-
-**New: State Machine (`core/workflow/state-machine.ts`)**
-- Explicit state definitions with valid transitions
-- State info shown after each command (e.g., `📍 State: WORKING`)
-- Next steps derived from current state
-
-**Updated Commands**
-- `task` — Shows state: WORKING after starting
-- `done` — Shows state: COMPLETED
-- `pause` — Shows state: PAUSED
-- `resume` — Shows state: WORKING
-
-### Feature: Auto-sync to Linear (PRJ-142 completion)
-
-When starting/completing tasks with Linear IDs, prjct now auto-syncs status.
-
-- `p. task PRJ-123` → Fetches issue title, marks as In Progress in Linear
-- `p. done` → Marks issue as Done in Linear (if task has linearId)
-
-### Feature: Sync Summary (PRJ-119)
-
-After `p. sync`, shows a compact summary with key metrics:
-- Stack detected
-- Files analyzed → context files generated
-- Agents count
-- Time elapsed
-
-### Improvement: Linear CLI filter by team
-
-`list` command now uses configured team, showing only relevant issues.
-
-### Improvement: Clean Terminal UX guidelines
-
-Added guidelines to CLAUDE.md for user-friendly tool call descriptions.
-
-## [0.43.0] - 2026-01-29
-
-### Feature: Bidirectional Sync Linear ↔ prjct (PRJ-142)
-
-When `integrations.linear.enabled === true`, prjct now syncs bidirectionally with Linear, using a local cache for offline access and reduced API calls.
-
-**New: Local Issue Cache (`storage/issues.json`)**
-- Full copy of assigned Linear issues stored locally
-- 30-minute staleness threshold for automatic refresh
-- Local-first reads: no API call if issue is cached and fresh
-
-**New: Sync Layer (`core/integrations/linear/sync.ts`)**
-- `pullAll()` — Fetch all assigned issues to local cache
-- `getIssue()` — Local-first fetch with API fallback
-- `getIssueLocal()` — Local-only fetch (no API call)
-- `pushStatus()` — Push status changes to Linear + update cache
-- `isStale()` — Check if cache needs refresh
-
-**New CLI Commands**
-- `sync` — Pull all assigned issues to local storage
-- `sync-status` — Check local cache status (hasCache, issueCount, isStale)
-- `get-local <id>` — Get issue from local cache without API call
-
-**Updated State Schema**
-- `currentTask.linearId` — Linear identifier (e.g., "PRJ-123")
-- `currentTask.linearUuid` — Linear internal UUID for API calls
-
-**Updated Templates**
-- `sync.md` — Syncs Linear issues when enabled
-- `task.md` — Uses local-first approach, tracks linearId/linearUuid
-- `done.md` — Pushes status to Linear via sync layer
-
-**New Files:**
-- `core/integrations/linear/sync.ts` — Sync layer implementation
-- `core/schemas/issues.ts` — Zod schema for issues.json
-
-## [0.42.0] - 2026-01-29
-
-### Feature: Linear SDK Integration with Per-Project Credentials
-
-Linear integration now uses the native `@linear/sdk` with per-project credential storage, enabling different projects to use different Linear workspaces.
-
-**New: Per-Project Credentials**
-- Credentials stored at `~/.prjct-cli/projects/{projectId}/config/credentials.json`
-- Fallback chain: project credentials → macOS keychain → environment variable
-- Each project can connect to a different Linear workspace
-
-**New: CLI Bridge (`core/cli/linear.ts`)**
-- Direct access to Linear SDK from templates
-- Commands: `setup`, `list`, `get`, `create`, `update`, `start`, `done`, `comment`, `teams`, `projects`, `status`
-- JSON output for easy parsing by Claude
-
-**New: `prjct linear <cmd>` Subcommand**
-- Direct CLI access: `prjct linear status`, `prjct linear list`, etc.
-- Auto-resolves project ID from current directory
-
-**Updated Templates**
-- `linear.md` — Natural language interpretation guide for Claude
-- `enrich.md` — Uses CLI instead of MCP for ticket enrichment
-
-**Breaking: Removed MCP-only Trackers**
-- Removed JIRA, GitHub Issues, Monday.com support (no native SDK)
-- Only Linear is supported (has native SDK)
-
-**New Files:**
-- `core/cli/linear.ts` — CLI bridge for Linear SDK
-- `core/utils/project-credentials.ts` — Per-project credential storage
-
-**Modified:**
-- `bin/prjct.ts` — Added `prjct linear` subcommand
-- `templates/commands/linear.md` — Updated with CLI execution pattern
-- `templates/commands/enrich.md` — Linear-only, uses CLI
-
-## [0.40.0] - 2026-01-28
-
-### Feature: Enhanced Skill System
-
-Inspired by vercel-labs/skills, prjct-cli now supports remote skill installation, version tracking via lock file, and full ecosystem-standard SKILL.md subdirectory format across all skill directories.
-
-**New: Remote Skill Installation (`p. skill add`)**
-- Install skills from GitHub repos: `p. skill add owner/repo`
-- Install specific skill: `p. skill add owner/repo@skill-name`
-- Install from local directory: `p. skill add ./path`
-- Automatic source metadata injection (`_prjct` frontmatter block)
-
-**New: Skill Lock File**
-- Tracks installed skills at `~/.prjct-cli/skills/.skill-lock.json`
-- Records source URL, commit SHA, install timestamp
-- Enables update detection via `p. skill check`
-
-**New: Additional Subcommands**
-- `p. skill add <source>` — Install from GitHub or local path
-- `p. skill remove <name>` — Uninstall a skill
-- `p. skill init <name>` — Scaffold a new skill template
-- `p. skill check` — Detect available updates
-
-**Improved: Full SKILL.md Subdirectory Support**
-- All skill directories now support both `{name}.md` (flat) and `{name}/SKILL.md` (subdirectory) formats
-- Previously only provider dirs (`~/.claude/skills/`) checked subdirectories
-- Orchestrator executor now checks both patterns when loading agent skills
-
-**New Files:**
-- `core/services/skill-installer.ts` — Remote installation service
-- `core/services/skill-lock.ts` — Lock file management
-
-**Modified:**
-- `core/types/services.ts` — Extended `SkillMetadata` with `sourceUrl`, `sourceType`, `installedAt`, `sha`; added `'remote'` source type
-- `core/services/skill-service.ts` — Unified SKILL.md discovery in all dirs
-- `core/agentic/orchestrator-executor.ts` — Both path patterns for skill loading
-- `templates/commands/skill.md` — New subcommands documentation
-
-## [0.39.0] - 2026-01-24
-
-### Feature: Windsurf IDE Support (PRJ-66)
-
-prjct now works with **Windsurf IDE** as a project-level integration.
-
-**Architecture:**
-- Windsurf uses `.md` files (not `.mdc` like Cursor) with YAML frontmatter
-- Uses `trigger: always_on` instead of `alwaysApply: true`
-- Uses "workflows" directory instead of "commands"
-- Character limits: 6000 per file, 12000 total
-
-**New Files:**
-- `templates/windsurf/router.md` - Minimal router with YAML frontmatter
-- `templates/global/WINDSURF.md` - Full prjct instructions for Windsurf
-- `templates/windsurf/workflows/*.md` - Individual workflow files (sync, task, done, ship, bug, pause, resume)
-
-**Modified:**
-- `core/types/provider.ts` - Added `'windsurf'` to AIProviderName, added `WindsurfProjectDetection`
-- `core/infrastructure/ai-provider.ts` - Added WindsurfProvider, detectWindsurfProject(), branding
-- `core/infrastructure/setup.ts` - Added installWindsurfProject(), hasWindsurfProject()
-- `bin/prjct.ts` - Added Windsurf to --version display
-
-**Project Structure:**
-```
-.windsurf/
-├── rules/
-│   └── prjct.md          # Router (auto-generated)
-└── workflows/
-    ├── sync.md
-    ├── task.md
-    ├── done.md
-    ├── ship.md
-    ├── bug.md
-    ├── pause.md
-    └── resume.md
-```
-
----
-
-## [0.38.1] - 2026-01-24
-
-### Docs: Complete Antigravity documentation
-
-- Added Antigravity badge to README
-- Added Antigravity Quick Start section
-- Updated "How It Works" table with Antigravity column
-- Updated Requirements to include Antigravity
-- Fixed version display to show all providers consistently
-
----
-
-## [0.38.0] - 2026-01-24
-
-### Feature: Google Antigravity Support (PRJ-64)
-
-prjct now works with **Google Antigravity** as a skill (not MCP server).
-
-**Why Skills over MCP:**
-- Zero overhead (just SKILL.md files)
-- Cross-compatible with Claude Code skills
-- No daemon process needed
-- Aligned with prjct as "context layer"
-
-**New Files:**
-- `templates/global/ANTIGRAVITY.md` - Full prjct instructions
-- `templates/antigravity/SKILL.md` - Skill router for Antigravity
-
-**Modified:**
-- `core/infrastructure/ai-provider.ts` - Added AntigravityProvider, detectAntigravity()
-- `core/infrastructure/setup.ts` - Added installAntigravitySkill()
-- `core/index.ts` - Show Antigravity in --version
-
-**Skills Location:**
-```
-~/.gemini/antigravity/skills/prjct/SKILL.md
-```
-
-**Critical Rule Added:**
-All agent templates (CLAUDE.md, GEMINI.md, CURSOR.mdc, ANTIGRAVITY.md) now include:
-- Rule #0: Plan Before Action (NON-NEGOTIABLE)
-- Agent must create plan and get user approval before ANY execution
-
----
-
-## [0.37.1] - 2026-01-24
-
-### Fix: Cursor Command Syntax (PRJ-65)
-
-Fixed Cursor IDE commands not working. Cursor uses `/command` syntax, not `p. command`.
-
-**Changes:**
-- Created individual command files: `/sync`, `/task`, `/done`, `/ship`, `/bug`, `/pause`, `/resume`
-- Updated `CURSOR.mdc` with correct `/command` syntax documentation
-- Updated `router.mdc` with new syntax examples
-- Updated `README.md` with Cursor-specific syntax section
-- Fixed `installCursorProject()` to install all individual command files
-
-**Cursor Syntax:**
-```
-/sync                  # Analyze project
-/task "description"    # Start task
-/done                  # Complete subtask
-/ship                  # Ship feature
-```
-
----
-
-## [0.37.0] - 2026-01-24
-
-### Feature: Cursor IDE Support (PRJ-63)
-
-prjct now works with **Cursor IDE** in addition to Claude Code and Gemini CLI. Use any AI model Cursor supports (GPT-4, Claude, Gemini, DeepSeek, etc.).
-
-**Key Insight:** Cursor has NO global config directory. Unlike Claude/Gemini which use `~/.claude/` and `~/.gemini/`, Cursor uses project-level config in `.cursor/`.
-
-**Solution: Minimal Router Pattern**
-- Router files are minimal (~15 lines), point to npm package for real instructions
-- If deleted, `p. sync` regenerates them automatically
-- Added to `.gitignore` - each developer regenerates their own
-
-**New Files:**
-- `templates/global/CURSOR.mdc` - Full prjct instructions for Cursor
-- `templates/cursor/router.mdc` - Minimal router (installed in projects)
-- `templates/cursor/p.md` - Command router for `p. <command>`
-
-**Modified:**
-- `core/types/provider.ts` - Added 'cursor' to AIProviderName
-- `core/infrastructure/ai-provider.ts` - Added CursorProvider, detectCursorProject()
-- `core/infrastructure/setup.ts` - Added installCursorProject(), hasCursorProject()
-- `templates/commands/init.md` - Cursor detection and setup
-- `templates/commands/sync.md` - Cursor router regeneration
-- `bin/prjct.ts` - Cursor status in --version output
-- `README.md` - Added Cursor to supported platforms
-
-**Architecture:**
-```
-Claude/Gemini (CLI)          Cursor (GUI)
-~/.claude/CLAUDE.md         .cursor/rules/prjct.mdc (router)
-~/.gemini/GEMINI.md                ↓
-        ↓                   npm/prjct-cli/templates/global/CURSOR.mdc
-Global config                      ↓
-        └──────────────────────────┘
-                    ↓
-        ~/.prjct-cli/projects/{id}/  (shared storage)
-```
-
----
-
-## [0.36.1] - 2026-01-23
-
-### Docs: Minimal README
-
-Rewrote README from 645 lines to 100 lines. Clean, minimal, multi-platform focused.
-
----
-
-## [0.36.0] - 2026-01-23
-
-### Feature: Dual Platform Support - Claude + Gemini (PRJ-62)
-
-prjct now works with **both Claude Code and Gemini CLI** simultaneously. Use prjct with whichever AI coding agent you prefer.
-
-**New Branding:**
-- Tagline: "Context layer for AI agents"
-- Works with Claude Code, Gemini CLI, and more
-
-**Dual Provider Support:**
-- Auto-detect installed providers (Claude, Gemini, or both)
-- `prjct start` - Interactive setup for provider configuration
-- Install routers to both `~/.claude/commands/p.md` and `~/.gemini/commands/p.toml`
-- Shared storage format for cross-agent compatibility
-
-**New Files:**
-- `templates/global/GEMINI.md` - Gemini CLI global instructions
-- `templates/commands/p.toml` - Gemini CLI router
-- `templates/global/STORAGE-SPEC.md` - Canonical storage specification
-- `core/infrastructure/ai-provider.ts` - Multi-provider detection
-- `core/cli/start.ts` - Beautiful interactive setup UI
-
-**Improved CLI:**
-- `prjct --version` - Shows provider status with versions
-- `prjct --help` - Actually useful help with quick start guide
-- `prjct start` - Gorgeous ASCII art welcome screen
-
-**Storage Compatibility:**
-- Cross-agent JSON formatting rules
-- Identical storage output from Claude and Gemini
-- Ready for future remote sync to prjct.app
-
----
-
-## [0.35.2] - 2026-01-17
-
-### Fix: CLI Workflow Now Uses CommandExecutor
-
-The `workflow.ts` was calling `templateExecutor` directly, bypassing the orchestrator.
-Now properly routes through `commandExecutor.execute()` which triggers:
-- Domain detection
-- Agent loading
-- Skill loading
-- Task fragmentation
-
-**Files Changed:**
-- `core/commands/workflow.ts` - Uses `commandExecutor.execute()` instead of `templateExecutor`
-
-## [0.35.1] - 2026-01-17
-
-### Fix: Orchestrator Now Actually Executes
-
-Critical fix - the orchestrator was only generating PATHS to templates, not executing them.
-
-#### What Was Broken
-- `p. task` never ran domain detection
-- Agents from `{globalPath}/agents/` were never loaded
-- Tasks were never fragmented into subtasks
-- No context was injected into prompts
-
-#### What's Fixed
-- **Created `orchestrator-executor.ts`** - Executes orchestration in TypeScript
-- **Domain Detection** - Analyzes task keywords to detect database, backend, frontend, etc.
-- **Agent Loading** - Loads agent content from `{globalPath}/agents/`
-- **Skill Loading** - Loads skills from agent frontmatter
-- **Task Fragmentation** - Creates subtasks for 3+ domain tasks
-- **Prompt Injection** - Injects loaded agents, skills, and subtasks into prompt
-
-#### Verified Flow
-```
-Task → Orchestrator → 3 subtasks
-Subtask 1 [database] → p.done → ✅
-Subtask 2 [backend] → p.done → ✅
-Subtask 3 [frontend] → p.done → ✅
-ALL COMPLETE (100%)
-```
-
-**Files Changed:**
-- `core/agentic/orchestrator-executor.ts` (NEW - 482 lines)
-- `core/agentic/command-executor.ts` - Calls orchestrator
-- `core/agentic/prompt-builder.ts` - Injects orchestrator context
-- `core/types/agentic.ts` - Added orchestrator types
-- `core/commands/workflow.ts` - **Connects CLI to CommandExecutor** (was bypassing orchestrator)
-
-## [0.34.0] - 2026-01-15
-
-### Feature: Agentic Orchestrator + MCP Auto-Install
-
-Major release with intelligent task routing and simplified integration setup.
-
-#### Orchestrator Agent (NEW)
-
-Auto-routing system for tasks to the right agents and skills:
-
-- **Domain Detection**: Analyzes task keywords to detect domains (frontend, backend, database, etc.)
-- **Agent Loading**: Automatically loads relevant agents from `{globalPath}/agents/`
-- **Skill Invocation**: Invokes skills from `~/.claude/skills/` based on task context
-- **Multi-Domain Coordination**: Handles tasks spanning multiple domains with proper execution order
-
-**Usage**: Orchestrator runs automatically for task-related commands (`p. task`, `p. done`, `p. ship`, etc.)
-
-#### MCP Server Auto-Install
-
-All integrations now auto-install their MCP servers:
-
-- **Linear**: Auto-installs `mcp-remote` for Linear API
-- **JIRA**: Auto-installs Atlassian MCP server
-- **GitHub**: Auto-installs GitHub MCP server with token validation
-- **Monday.com**: Auto-installs Monday MCP server
-
-No more manual `~/.claude/settings.json` editing - just run `p. linear setup` and it handles everything.
-
-#### Individual Command Skills
-
-All 37 prjct commands now available as individual Claude Code skills:
-
-- `/p.task` - Start a task
-- `/p.sync` - Sync project
-- `/p.linear` - Linear integration
-- Plus 34 more commands
-
-#### agentskills.io Integration
-
-Skills are now discovered from the official agentskills.io ecosystem:
-
-- Skills from `anthropics/skills` GitHub repo
-- Proper SKILL.md format with YAML frontmatter
-- Agent-to-skill mapping in `templates/config/skill-mappings.json`
-
-**Files Changed:**
-- `templates/agentic/orchestrator.md` (NEW)
-- `templates/commands/p.md` - Orchestrator integration
-- `templates/commands/task.md` - Orchestrator context usage
-- `templates/commands/linear.md` - MCP auto-install
-- `templates/commands/jira.md` - MCP auto-install
-- `templates/commands/github.md` - MCP auto-install
-- `templates/commands/monday.md` - MCP auto-install
-- `templates/config/skill-mappings.json` - agentskills.io sources
-- `scripts/postinstall.js` - Individual command installation
-
-**Removed (deprecated):**
-- `templates/commands/feature.md`
-- `templates/commands/now.md`
-- `templates/commands/dashboard.md`
-- `templates/commands/suggest.md`
-- `templates/commands/ask.md`
-
----
-
-## [0.33.5] - 2026-01-13
-
-### Fix: Type Safety Improvements (PRJ-54)
-
-Remove unsafe `as unknown` type casts with proper TypeScript interfaces.
-
-**Changes:**
-- `GroundTruthContext` now uses `ContextPaths` directly
-- `chain-of-thought.ts` uses `Pick<ProjectContext, ...>` type alias
-- `command-executor.ts` uses `PromptContext` instead of `Record<string, unknown>`
-
----
-
-## [0.33.4] - 2026-01-13
-
-### Refactor: Error Type Differentiation Phase 3 (PRJ-61)
-
-**Final phase** - Complete error differentiation across all 116 remaining catch blocks in 52 files.
-
-**Pattern Applied:**
-- `isNotFoundError()` for expected ENOENT errors
-- `instanceof SyntaxError` for JSON parse errors
-- `_error` capture for intentional catch-all blocks (network, git, etc.)
-- Unexpected errors propagate with `throw error`
-
-**Key Files Fixed:**
-- `core/storage/storage.ts` - Storage read/exists operations
-- `core/commands/shipping.ts` - Ship workflow error handling
-- `core/session/task-session-manager.ts` - Session management
-- `core/commands/cleanup.ts` - Cleanup operations
-- `core/agentic/context-builder.ts` - Context building
-- Plus 47 more files
-
-**Stats:**
-- Catches fixed this phase: 116
-- Total fixed (Phase 1+2+3): 185
-- Remaining: 0 empty catches
-
----
-
-## [0.33.3] - 2026-01-13
-
-### Refactor: Error Type Differentiation Phase 2 (PRJ-60)
-
-**Continuation of PRJ-51** - Differentiate error types in 3 more files (14 catch blocks):
-
-**Files Modified:**
-- `core/domain/snapshot-manager.ts` - 6 catches (fs.access, fs.readFile, fs.unlink, JSON.parse)
-- `core/server/routes-extended.ts` - 2 catches (readJsonFile, writeJsonFile helpers)
-- `core/infrastructure/setup.ts` - 6 catches (migration, settings parsing, status line)
-
-**Pattern Applied:**
-- ENOENT errors → handled gracefully (expected for missing files)
-- SyntaxError → handled gracefully (expected for malformed JSON)
-- Other errors → propagated or logged (unexpected)
-
-**Stats:**
-- Catches fixed: 14
-- Total fixed (Phase 1+2): 69
-- Remaining: ~211 catches in 63 files
-
----
-
-## [0.33.2] - 2026-01-13
-
-### Refactor: Error Type Differentiation (PRJ-51)
-
-**Problem:** 280 catch blocks across 69 files used empty `catch {}` which swallowed all errors without differentiating between expected (ENOENT) and unexpected errors.
-
-**Solution:** Phase 1 implementation - differentiate error types in 3 priority files (55 catch blocks):
-
-**Pattern Applied:**
-```typescript
-// Before
-} catch { return null }
-
-// After
-} catch (error) {
-  if (isNotFoundError(error)) return null      // Expected: file doesn't exist
-  if (error instanceof SyntaxError) return null // Expected: invalid JSON
-  throw error                                   // Unexpected: propagate
-}
-```
-
-**Files Modified:**
-- `core/agentic/ground-truth.ts` - 21 catches (verification functions)
-- `core/domain/analyzer.ts` - 18 catches (codebase analysis)
-- `core/infrastructure/command-installer.ts` - 16 catches (command management)
-
-**Tests Added:**
-- `core/__tests__/types/fs.test.ts` - 15 new tests for error utilities
-
-**Stats:**
-- Tests: 137 → 152 (+15)
-- Catches fixed: 55
-- Files: 4 (3 refactored + 1 test)
-
----
-
-## [0.33.1] - 2026-01-13
-
-### Refactor: Code Quality Improvements
-
-**PRJ-58: Consolidate hardcoded paths to pathManager**
-- Added `getClaudeDir()`, `getClaudeCommandsDir()`, `getClaudeSettingsPath()` to pathManager
-- Refactored 6 files to use centralized path methods instead of `os.homedir()` concatenation
-- Files: `compaction.ts`, `generator.ts`, `routes-extended.ts`, `routes.ts`, `auth-config.ts`, `setup.ts`
-
-**PRJ-57: Simplify logger level detection**
-- Use `Set` for truthy values instead of multiple OR conditions
-- Remove redundant `'prjct'` equality check (covered by `includes`)
-- Use nullish coalescing (`??`) instead of ternary
-- Pre-compute level name to avoid runtime lookup
-- Add `createLogMethod()` factory to reduce repetition
-- File: `core/utils/logger.ts`
-
----
-
-## [0.30.3] - 2026-01-13
-
-### Fix: Enrichment Not Enabled by Default
-
-**Problem:** `CONFIG_ENRICHMENT_ENABLED` was not set in statusline config, so enrichment feature was not active by default when Claude Code started.
-
-**Solution:**
-- Added `enrichment.enabled: true` to `default-config.json`
-- Added `DEFAULT_ENRICHMENT_ENABLED="true"` to `config.sh`
-- Enrichment setting now parses from config with `true` as default
-
-**Files:**
-- `assets/statusline/default-config.json` - Added enrichment component
-- `assets/statusline/lib/config.sh` - Added enrichment config parsing
-
----
-
-## [0.30.2] - 2026-01-13
-
-### Feature: PM Expert Auto-Enrichment
-
-**Problem:** Claude could start coding without properly understanding the task, leading to solutions that didn't match user intent.
-
-**Solution:** PM Expert enrichment now runs AUTOMATICALLY in `p. task` and `p. bug`:
-
-**`p. task` - 5-Phase Enrichment:**
-1. Intelligent Classification (type, priority, complexity)
-2. Technical Analysis (affected files, existing patterns)
-3. Dependency Detection (code, API, blockers)
-4. User Story + AC Generation
-5. Verify Understanding (ask if unclear)
-
-**`p. bug` - Quick Technical Analysis:**
-- Finds related files and recent commits
-- Assesses complexity (simple/medium/complex)
-- Suggests approach before auto-starting
-- For complex bugs, offers full PM Expert enrichment
-
-### Fix: Statusline Installation Issues
-
-- **IFS Restoration**: Fixed bash associative array iteration breaking after `read`
-- **Bash 4+ Detection**: Auto re-exec to Homebrew bash on macOS (ships with bash 3.2)
-- **VERSION Patching**: All 3 installation paths now correctly patch CLI_VERSION
-- **jq Boolean Fix**: `enabled: false` now correctly parsed (was treating as null)
-
-**Files:**
-- `templates/commands/task.md` - Added Step 3: PM Expert Enrichment
-- `templates/commands/bug.md` - Added Step 4.5: Quick Technical Analysis
-- `assets/statusline/lib/*.sh` - IFS restoration
-- `assets/statusline/statusline.sh` - Bash 4+ detection, VERSION placeholder
-- `scripts/postinstall.js` - VERSION patching
-- `bin/prjct` - VERSION patching in self-healing
-
----
-
-## [0.30.0] - 2026-01-12
-
-### Fix: Distribution System Overhaul (CRITICAL)
-
-**Problem:** Users running `npm update -g prjct-cli` weren't getting updates because:
-1. Old p.md had fallback to local cache files
-2. postinstall copied 40+ files, too many failure points
-
-**Solution:**
-- **Removed fallback** in p.md - No more reading from stale local files
-- **p.md now always reads from npm root** - `npm root -g` + template path
-- **Simplified postinstall** - Only copies p.md (critical) + statusline (best-effort)
-
-**How it works now:**
-```
-p. sync → Claude reads ~/.claude/commands/p.md
-       → p.md says "run npm root -g, read from there"
-       → Claude reads /opt/homebrew/lib/node_modules/prjct-cli/templates/commands/sync.md
-       → Template always comes from installed npm package
-```
-
-**Files:**
-- `templates/commands/p.md` - Removed fallback, simplified
-- `scripts/postinstall.js` - Minimal, only copies essential files
-
----
-
-## [0.28.0] - 2026-01-12
-
-### Feature: Per-Project Task Filtering for Status Bar
-
-Extended API now supports filtering by current working directory, enabling the status bar to show project-specific tasks.
-
-**New Endpoints:**
-- `GET /api/status-bar/compact?cwd=/path` - Filter by cwd
-- `GET /api/projects` - List all projects
-- `GET /api/projects/:id/full` - Project dashboard
-- `POST /api/projects/:id/task/{complete,pause,resume}`
-- `GET /api/stats/global` - Global statistics
-
-**How it works:**
-1. Status bar detects cwd from frontmost app (Terminal, VS Code, etc.)
-2. Calls `/api/status-bar/compact?cwd=/current/path`
-3. Server matches cwd to project's `repoPath`
-4. Returns only that project's task
-
-**Files:**
-- `core/server/routes-extended.ts` - New extended API routes
-- `core/server/server.ts` - Mount extended routes
-- `core/server/index.ts` - Export extended routes
-
----
-
-## [0.27.1] - 2026-01-12
-
-### Docs: Differentiation Strategy vs Coding Agents
-
-Clarified prjct's positioning as a **workflow layer**, not a coding agent.
-
-**Changes:**
-- Added "What prjct is (and isn't)" section to README
-- Created COMPARISON.md documenting prjct vs OpenCode, Cursor, Jira, etc.
-- Clear messaging: prjct enhances Claude Code, doesn't compete with it
-
-**Key insight:** prjct competes with Jira/Linear/Notion (workflow tools), not with OpenCode/Cursor/Copilot (coding agents). Use both together for maximum developer momentum.
-
----
-
-## [0.27.0] - 2026-01-08
-
-### Fix: prjct Commit Signature (CRITICAL)
-
-**Problem:** Commits were only showing Claude's Co-Authored-By, missing the prjct signature.
-
-**Solution:** Made prjct signature NON-NEGOTIABLE in all commit-related templates:
-- `templates/commands/ship.md` - Updated commit format with HEREDOC
-- `templates/commands/git.md` - Updated commit message format
-- `CLAUDE.md` and `templates/global/CLAUDE.md` - Made footer CRITICAL
-
-**Correct commit format:**
-```
-feat: description
-
-🤖 Generated with [p/](https://www.prjct.app/)
-Designed for [Claude](https://www.anthropic.com/claude)
-
-```
-
-The `🤖 Generated with [p/]` line MUST appear in ALL prjct commits.
-
----
-
-### Feature: Claude Code Skill Integration (AGENTIC)
-
-Agents are now linked to Claude Code skills from claude-plugins.dev. **Skills are discovered and installed AGENTICALLY** - Claude searches the marketplace dynamically to find the best matching skill for each agent.
-
-**New Capabilities:**
-
-1. **Agentic Skill Discovery** (`p. sync` Step 7.5)
-   - Searches `https://claude-plugins.dev/skills?q={searchTerm}` for each agent
-   - Analyzes results: prefers @anthropics, high downloads, recent updates
-   - Downloads skill content from GitHub source
-   - Installs to `~/.claude/skills/{name}.md`
-   - Creates custom skill if no marketplace match found
-   - Updates agent frontmatter with discovered skill name
-
-2. **Skill Invocation in Tasks** (`p. task`)
-   - Phase 2 (Exploration): Invokes skills based on task type
-   - Phase 4 (Design): Loads agent skills for domain expertise
-   - Example: UI tasks automatically use `/frontend-design`
-
-3. **Agent → Skill Mapping**
-
-   | Agent | Skill | Source |
-   |-------|-------|--------|
-   | `frontend.md` | `frontend-design` | @anthropics/claude-code-plugins |
-   | `uxui.md` | `frontend-design` | @anthropics/claude-code-plugins |
-   | `backend.md` | `javascript-typescript` | @wshobson/claude-code-workflows |
-   | `testing.md` | `developer-kit` | @claudebase/marketplace |
-   | `devops.md` | `developer-kit` | @claudebase/marketplace |
-   | `prjct-planner.md` | `feature-dev` | @anthropics/claude-code-plugins |
-   | `prjct-shipper.md` | `code-review` | @anthropics/claude-code-plugins |
-
-**New Files:**
-
-- `templates/config/skill-mappings.json` - Maps agents to skills
-- `templates/agentic/skill-integration.md` - Integration guide
-
-**Updated Files:**
-
-- `templates/commands/sync.md` - Added Step 7.5 for skill installation
-- `templates/commands/task.md` - Added skill invocation in Phase 2 & 4
-- `templates/agentic/subagent-generation.md` - Added skills to agent format
-- All subagent templates - Added `skills` field to frontmatter
-- `templates/global/CLAUDE.md` - Added skill integration section
-- `CLAUDE.md` - Added skill integration docs
-
-**Why This Matters:**
-
-- `frontend-design` provides anti-AI-slop patterns (no Inter + purple gradients)
-- `code-review` ensures quality before shipping
-- `javascript-typescript` provides Node.js/TypeScript best practices
-- `developer-kit` provides testing and DevOps automation
-
-**Usage:**
-
-```bash
-p. sync                        # Installs skills automatically
-p. task "create login form"    # Uses frontend-design skill
-p. ship "auth"                 # Uses code-review skill
-```
-
----
-
-## [0.26.1] - 2026-01-08
-
-### Fix: Claude Context Efficiency (Critical)
-
-**Problem:** After v0.26.0, Claude was losing context, not analyzing properly, not applying skills, and making poor decisions across ALL commands.
-
-**Root Cause:**
-1. Templates were too long and procedural (~7000 lines total)
-2. `task.md` had 791 lines of pseudo-code scripts
-3. CLAUDE.md only referenced docs but Claude didn't read them proactively
-4. 11-phase workflow created too much cognitive overhead
-5. `context/CLAUDE.md` generated by sync only had stats, no behavioral rules
-
-**Solution:**
-
-1. **Simplified `task.md`**: 791 → 277 lines (65% reduction)
-   - Removed procedural bloat
-   - Focus on GUIDANCE not SCRIPTS
-   - Claude uses intelligence to adapt, not follow rigidly
-
-2. **Enhanced `templates/global/CLAUDE.md`**: 75 → 177 lines
-   - Added "HOW TO USE PRJCT" section
-   - Included architecture inline (not just references)
-   - Added "INTELLIGENT BEHAVIOR" section
-   - Key insight: "Templates are GUIDANCE, not scripts"
-
-3. **Rich `context/CLAUDE.md` on sync**: Complete rewrite
-   - Added "MANDATORY RULES (DO NOT IGNORE)" section
-   - Added "DO vs DON'T" table for clear behavior
-   - Added "HOW TO USE PRJCT" with command reference
-   - Added "EXPECTED BEHAVIOR" guidelines
-   - Includes current state, available agents
-   - **ALWAYS OVERWRITE on sync** to ensure latest rules
-
-4. **Reduced workflow complexity**: 11 → 5 phases for `p. task`
-   - Discovery → Exploration → Questions → Design → Implementation
-   - Simpler mental model, less overhead
-
-**Key Changes:**
-- `p. sync` now overwrites `context/CLAUDE.md` with rich behavioral context
-- Rules are NON-NEGOTIABLE and clearly marked
-- Claude gets explicit DO/DON'T guidance
-- All commands benefit from consistent context
-
-5. **TRULY Agentic Project Analysis (NEW)**
-   - Detects ecosystem: Ruby, Python, Go, Rust, Node.js, PHP, Java, .NET, Elixir, etc.
-   - Detects project type: Rails, Django, Next.js, Go API, etc.
-   - Analyzes ACTUAL files to determine commands
-   - No hardcoded rules - Claude REASONS about what it finds
-   - Saves to `analysis/repo-analysis.json`
-
-6. **Contextual CLAUDE.md (Ecosystem-Aware)**
-   - Shows correct commands for THIS ecosystem
-   - Rails: `bundle install`, `rails s`, `rspec`
-   - Python: `poetry install`, `pytest`
-   - Go: `go build`, `go test ./...`
-   - Node/bun: `bun install`, `bun test`
-   - Project-specific DO/DON'T table based on analysis
-
-**Example: Rails project generates:**
-```
-Ecosystem: Ruby | Type: Rails
-Commands:
-- Install: bundle install
-- Dev server: rails s
-- Tests: rspec
-- Migrations: rails db:migrate
-```
-
-**Example: Go project generates:**
-```
-Ecosystem: Go | Type: Go API
-Commands:
-- Build: go build
-- Tests: go test ./...
-- Run: go run .
-```
-
-**Files Changed:**
-- `templates/global/CLAUDE.md` - Rich context, intelligent guidance
-- `templates/commands/task.md` - Simplified, agentic approach
-- `templates/commands/sync.md` - Agentic analysis + contextual CLAUDE.md
-- `CLAUDE.md` - Updated project docs
-- `package.json` - Version bump
-
-## [0.26.0] - 2026-01-01
-
-### Complete Development Cycle with Workflow Integrity
-
-Major feature: 11-phase workflow system that ensures all development steps are completed. No more skipped version bumps, missing changelogs, or untracked ships.
-
-**New Commands:**
-- `p. test` - Run tests, advance from implement → test phase
-- `p. review` - MCP code review + GitHub approvals, advance test → review
-- `p. merge` - Merge PR to main, advance review → merge
-- `p. verify` - Validate all 11 checkpoints complete, close workflow
-
-**Workflow Phases:**
-```
-p. task → (implement) → p. test → p. review → p. merge → p. ship → p. verify
-```
-
-| Phase | Command | Action |
-|-------|---------|--------|
-| 1. analyze | p. task | PM agent breakdown |
-| 2. branch | p. task | Create feature branch |
-| 3. implement | (manual) | Write code |
-| 4. test | p. test | Run tests |
-| 5. review | p. review | MCP + GitHub approvals |
-| 6. merge | p. merge | Merge PR |
-| 7-10. ship | p. ship | Tag, release, deploy, register |
-| 11. verify | p. verify | Validate & close |
-
-**Phase Validation:**
-Each command validates the workflow phase before executing. Cannot skip steps.
-
-**Checkpoint Tracking:**
-- All phases tracked in `state.json` with timestamps
-- Events logged to `memory/events.jsonl`
-- Full audit trail for every workflow
-
-**Updated Commands:**
-- `task.md` - Initializes workflow with 11 checkpoints
-- `ship.md` - Validates merge phase, sets 4 checkpoints atomically
-- `done.md` - Clarified as subtask completion
-- `pause.md` - Preserves workflow state
-- `resume.md` - Shows workflow phase on resume
-
-## [0.25.1] - 2026-01-01
-
-### Bug Fix: npm install symlink resolution
-
-**Fixed:** CLI fails when invoked via npm symlink (`node_modules/.bin/prjct`)
-
-**Root Cause:**
-The shell wrapper script `bin/prjct` used `dirname "$0"` to find `prjct.ts`, which returns the symlink's directory (`.bin/`) instead of the actual script location (`prjct-cli/bin/`).
-
-**Solution:**
-Added `resolve_symlink()` function that properly resolves symlinks before determining paths. Works on both Linux (`readlink -f`) and macOS (manual resolution fallback).
-
-**Files Changed:**
-- `bin/prjct` - Added symlink resolution (v1.0.0 → v1.1.0)
-
-## [0.25.0] - 2025-12-30
-
-### Maintenance Release
-
-Version bump for release preparation.
-
-## [0.24.0] - 2025-12-28
-
-### Breaking Change: Unified Task Command
-
-Consolidated `/p:now`, `/p:feature`, and `/p:work` into a single `/p:task` command with agentic classification.
-
-**New Command: `/p:task`**
-- Unified entry point for all work
-- Agentic type classification (not keyword-based)
-- 7-phase development workflow for all task types
-- Git branch management with type-based prefixes
-
-**Agentic Classification:**
-The agent analyzes task descriptions holistically to determine type:
-- `feature` - Adds new functionality
-- `bug` - Something broken or incorrect
-- `improvement` - Enhances existing functionality
-- `refactor` - Reorganizes without behavior change
-- `chore` - Maintenance, deps, docs
-
-**Migration:**
-```
-/p:now "fix login bug"     →  /p:task "fix login bug"
-/p:feature "add dark mode" →  /p:task "add dark mode"
-/p:work "update docs"      →  /p:task "update docs"
-```
-
-**Deprecated Commands:**
-- `/p:now` - Redirects to `/p:task`
-- `/p:feature` - Redirects to `/p:task`
-- `/p:work` - Redirects to `/p:task`
-
-**Files Changed:**
-- `templates/commands/task.md` - New unified template
-- `templates/commands/now.md` - Deprecated, redirects
-- `templates/commands/feature.md` - Deprecated, redirects
-- `core/commands/command-data.ts` - Registry updates
-- `templates/global/CLAUDE.md` - Updated workflow docs
-- `CLAUDE.md` - Updated project docs
-
-## [0.23.0] - 2025-12-28
-
-### Feature: Branch + PR Workflow
-
-Integrated git branch management and PR-based shipping workflow.
-
-**Branch Management:**
-- `/p:now` auto-creates feature branches when on main/master
-- `/p:bug` auto-creates bug branches with proper naming
-- Handles uncommitted changes (stash/commit/abort prompts)
-- Tracks branch info in state.json
-
-**Protected Branch Validation:**
-- `/p:git` blocks commits/pushes to main/master
-- Validates current branch matches expected task branch
-- Clear error messages with recovery instructions
-
-**PR-Based Shipping (`/p:ship`):**
-- Creates PR via `gh` CLI instead of direct push
-- Generates PR description with quality metrics
-- Waits for CI checks (up to 10 min)
-- Records CI status (passed/failed/timeout)
-- Supports `--draft` flag for WIP PRs
-
-**Template Updates:**
-- `templates/commands/bug.md` - Branch creation + stashing
-- `templates/commands/git.md` - Protected branch checks
-- `templates/commands/now.md` - Feature branch workflow
-- `templates/commands/ship.md` - Full PR lifecycle
-
-## [0.20.1] - 2025-12-26
-
-### Refactor: Type Consolidation
-
-Centralized ALL types in `core/types/` following DRY principles.
-
-**Changes:**
-- Moved types from `domain/task-stack.ts` → `types/domain.ts`
-- Moved types from `sync/*.ts` → `types/sync.ts`
-- Moved types from `storage/*.ts` → `types/storage.ts`
-- Moved types from `server/*.ts` → `types/server.ts`
-- Moved types from `utils/*.ts` → `types/utils.ts`
-- Added `types/plugin.ts` for webhook types
-- Updated all barrel exports to re-export from `core/types`
-- Renamed types to canonical names (TaskEntry → TaskStackEntry, etc.)
-
-**Stats:** 41 files changed, 606 insertions, 819 deletions (net -213 lines)
-
-## [0.20.0] - 2025-12-21
-
-### Feature: UX/UI Design Agent Integration
-
-Auto-generated UX/UI specialist agent for all frontend projects (web + mobile).
-
-**Priority: UX > UI** - Experience is more important than visuals.
-
-#### New Agent: `templates/agentic/agents/uxui.md`
-- **Part 1: UX Principles** - User analysis, clarity, feedback, reduced friction, error handling, accessibility (a11y)
-- **Part 2: UI Guidelines** - Aesthetic directions, typography trends (avoiding "AI slop"), color framework, purposeful animation
-- **Part 3: Quality Checklists** - Mandatory UX/UI gates before shipping
-
-#### Frontend Detection in `/p:sync`
-Auto-generates uxui.md when ANY frontend tech is detected:
-
-| Platform | Technologies |
-|----------|-------------|
-| Web | React, Vue, Svelte, Angular, Next.js, Nuxt |
-| Mobile | React Native, Expo, Flutter, SwiftUI, Jetpack Compose |
-
-#### Enhanced `/p:feature` Phase 4
-For frontend features, now includes:
-1. **UX Analysis** - Who, problem, happy path, edge cases
-2. **UX Requirements Checklist** - 6 mandatory accessibility/usability checks
-3. **Aesthetic Direction Selection** - Minimal, Bold, Soft, Brutalist
-4. **UI Guidelines Application** - Typography, color, animation, layout
-
-#### Anti-patterns Avoided ("AI Slop")
-- Generic fonts: Inter, Roboto, Arial, Space Grotesk
-- Purple/blue gradients on white
-- Centered layouts without personality
-- Unstyled component libraries
-
-**Files Added:**
-- `templates/agentic/agents/uxui.md` - Complete UX/UI specialist agent
-
-**Files Modified:**
-- `templates/commands/sync.md` - Frontend detection + uxui.md generation
-- `templates/commands/feature.md` - Phase 4.0 UX/UI analysis
-- `templates/commands/ship.md` - Pre-flight checks + confidence scoring
-
-## [0.19.0] - 2025-12-21
-
-### Breaking: Web Package Removed
-
-The web dashboard (`packages/web/`) has been extracted to a separate repository for independent development.
-
-**Removed:**
-- `packages/web/` - Next.js dashboard app (~200 files)
-- `bin/serve.js`, `bin/dev.js` - Web server scripts
-- `templates/commands/serve.md` - /p:serve command
-- `prjct-serve`, `prjct-dev` bin entries
-
-### Fix: Prompt Builder Now Sends Full Templates
-
-Fixed critical bug where `prompt-builder.ts` only extracted `## Flow` sections, causing Claude to miss important instructions.
-
-**Before:** Claude only saw the Flow section (~30% of template)
-**After:** Claude sees the full template content
-
-**Files Modified:**
-- `core/agentic/prompt-builder.ts` - Removed regex extraction, send full content
-
-### Improved: Templates Simplified
-
-Reduced template verbosity for better Claude comprehension:
-
-| Template | Before | After |
-|----------|--------|-------|
-| ship.md | 359 lines | ~110 lines |
-| done.md | 318 lines | ~117 lines |
-| now.md | 346 lines | ~141 lines |
-
-### Improved: Timestamp Generation
-
-Changed from undefined `GetTimestamp()` to actual bash commands:
-
-```bash
-bun -e "console.log(new Date().toISOString())" 2>/dev/null || node -e "console.log(new Date().toISOString())"
-```
-
-## [0.18.2] - 2025-12-15
-
-### Fix: Agents Write to Global Storage
-
-Fixed critical bug where sub-agents were being written to project's local `.claude/agents/` directory instead of global storage.
-
-- **Bug**: `/p:sync` created agents in `{projectPath}/.claude/agents/` polluting local projects
-- **Fix**: Agents now correctly write to `~/.prjct-cli/projects/{projectId}/agents/`
-
-**Files Modified:**
-- `templates/commands/sync.md` - Changed all agent paths from `{cwd}/.claude/agents/` to `{globalPath}/agents/`
-- `templates/agentic/subagent-generation.md` - Updated paths and added critical rules
-
-## [0.16.0] - 2025-12-15
-
-### Dead Code Cleanup
-
-Aggressive removal of ~6,600 lines of unused/legacy code for a cleaner, leaner codebase.
-
-- **Domain Modules Removed (6 files)**
-  - `agent-matcher.ts` - Replaced by template-based routing
-  - `product-standards.ts` - Unused domain standards
-  - `smart-cache.ts`, `task-analyzer.ts`, `agent-validator.ts`, `architect-session.ts`
-
-- **Agentic Modules Removed (6 files)**
-  - `semantic-compression.ts` - Exported but never called
-  - `response-templates.ts`, `think-blocks.ts`, `parallel-tools.ts`
-  - `context-filter.ts`, `validation-rules.ts`
-
-- **Legacy Migration Code Removed**
-  - `legacy-installer-detector/` directory (curl-to-npm migration)
-  - `migrator/` directory (version migrations)
-  - `uuid-migration.ts` (750 lines)
-  - `bin/migrate-to-json.js`, `bin/generate-views.js`
-  - `/p:migrate`, `/p:migrate-all` command templates
-
-- **Code Cleanup**
-  - Simplified `services.ts` facade (removed 6 unused exports)
-  - Simplified `setup.ts` (removed migration steps)
-  - Removed deprecated methods from `base.ts`
-  - Cleaned `command-executor.ts` (removed dead module usage)
-
-- **Impact**
-  - Lines removed: ~6,600
-  - Files deleted: ~25
-  - Build: Passing
-  - Tests: 131 pass
-
-## [0.15.1] - 2025-12-15
-
-### MCP Setup Documentation
-
-Enhanced setup template with MCP server installation documentation.
-
-- **Setup Template Updates**
-  - Added MCP server installation step documentation
-  - Context7 library documentation lookup integration
-  - Updated success output examples
-
-- **MCP Config Enhancements**
-  - Added description field for Context7 server
-  - Added usage guidelines with when/tools/examples
-  - Better documentation for resolve-library-id and get-library-docs
-
-## [0.15.0] - 2025-12-15
-
-### Template Optimization - Aggressive Consolidation
-
-Reduced command templates from 39 to 27 through strategic consolidation and elimination of redundancy.
-
-- **Command Consolidation**
-  - `/p:dash` absorbs status, progress, recap (views: default, week, month, compact)
-  - `/p:now` absorbs work, build (single task-start command)
-  - `/p:resume` absorbs recover (--recover flag for abandoned sessions)
-  - `/p:next` adds roadmap view (feature-grouped queue)
-  - `/p:ask` absorbs fix (troubleshooting mode)
-  - `/p:spec` absorbs decision (inline decision logging)
-
-- **Eliminated Redundant Commands**
-  - Removed: work, build, task, status, progress, recap, help
-  - Removed: roadmap, decision, fix, workflow, recover
-  - Total: 12 command templates deleted
-
-- **Auxiliary Template Cleanup**
-  - Merged accessibility.md → ux-ui.md
-  - Merged project-analysis.md → analyze.md
-  - Merged agent-assignment.md → agent-routing.md
-
-- **Template Enhancements**
-  - Agent detection table in now.md
-  - KPI metrics and velocity calculation in dash.md
-  - Recovery mode with 4 options in resume.md
-  - Standardized frontmatter across all templates
-
-- **Registry Updates**
-  - Updated core-commands.ts with consolidated commands
-  - Updated optional-commands.ts with git, test, serve
-
-## [0.14.0] - 2025-12-11
-
-### Actionable Dashboard + Session Recovery
-
-Dashboard is now fully actionable - click any item to execute commands in the terminal.
-
-- **Session Recovery System**
-  - `/p:recover` command to recover abandoned sessions (>8h inactive)
-  - Captures session prompts for context restoration
-  - RecoverCard shows abandoned sessions across all projects
-
-- **Actionable Dashboard Cards**
-  - QueueCard: Start (Play) and Delete (X) buttons always visible
-  - IdeasCard: Convert to Feature (Rocket) and Delete (X) buttons always visible
-  - ExpandButton pattern for "Show more" (DRY with ActivityTimeline)
-  - Click any item → navigate to /code → auto-execute command
-
-- **Click-to-Action Pattern**
-  - URL pattern: `/project/{id}/code?cmd=p.%20now%20"task"`
-  - Auto-executes command on terminal load
-  - Works for: Queue items, Ideas, Roadmap features, NowCard actions
-
-- **NowCard Enhancements**
-  - Done/Pause/Resume action buttons
-  - Project color dot indicator
-
-- **Code Workspace Improvements**
-  - PageHeader component with project context
-  - Auto-command execution from URL params
-
-## [0.13.3] - 2025-12-11
-
-### MomentumWidget + Code Workspace + Weekly Reports
-
-New features for project dashboard and code workspace.
-
-- **MomentumWidget** - Motivational sparkline in `/code` header
-  - 7-day activity visualization (tasks + ships)
-  - Smart color coding: green for streaks/trending up, gray for normal, red only for abandoned (7+ days)
-  - Status messages: "On fire!", "X tasks this week", "Miss you!"
-
-- **Code Workspace** (`/project/[id]/code`)
-  - Full terminal-based project workspace
-  - Command sidebar with workflow commands
-  - Mobile support with floating action button
-
-- **Weekly Reports** (`/project/[id]/reports`)
-  - Generate and preview project progress reports
-  - Printable report view
-
-- **Dashboard Improvements**
-  - "Start working" quick action in project dropdown
-  - Project version displayed in detail page header
-
-- **Bug Fixes**
-  - TechStackBadges: Handle both array and object formats for techStack
-
-## [0.13.2] - 2025-12-10
-
-### Fixed - Remove Migration Gate
-
-- Removed MigrationGate from production build
-- Projects now load directly without migration checks
-
-## [0.13.1] - 2025-12-10
-
-### Fixed - Server Start Mode
-
-- Fixed serve.js to use `start` instead of `start:prod`
-- Restored sidebar collapse functionality
-- Fixed server OOM crash
-
-## [0.13.0] - 2025-12-10
-
-### Deep Sync + Cleanup migrations
-
-Major update: Deep git analysis, removed external API dependencies, MD-first architecture.
-
-- **Deep Sync (`/p:sync`)**
-  - Full git analysis: `git status`, `git log`, `git diff`, `git branch`
-  - Auto-detect completed tasks from commit messages
-  - Sync ALL MD files: now.md, next.md, shipped.md, ideas.md, roadmap.md
-  - Update project.json with real stats (fileCount, commitCount, version)
-  - Update CLAUDE.md Quick Reference table with current data
-  - Infer current task from uncommitted changes
-
-- **Sync Button in Project Detail**
-  - Prominent primary-colored button in sidebar
-  - Always visible for easy access
-  - Mobile support in command grid
-
-- **Removed External Dependencies**
-  - Removed OpenAI/OpenRouter API key management
-  - Removed migration service (no longer needed)
-  - Removed settings API route
-  - Cleaned up web package dependencies
-
-- **Ship Workflow Improvements**
-  - Language agnostic versioning (package.json, Cargo.toml, pyproject.toml, VERSION)
-  - CHANGELOG.md generation is now MANDATORY
-  - Auto-runs deep sync after shipping
-  - prjct signature in commits
-
-- **Files Removed**:
-  - `packages/web/app/api/settings/route.ts`
-  - `packages/web/app/api/migrate/route.ts`
-  - `packages/web/lib/services/migration.server.ts`
-  - `packages/web/components/MigrationGate/`
-
-- **Files Modified**:
-  - `templates/commands/sync.md` - Complete rewrite for deep analysis
-  - `templates/commands/ship.md` - Language agnostic, mandatory changelog
-  - `packages/web/app/settings/page.tsx` - Removed API keys section
-  - `packages/web/app/project/[id]/page.tsx` - Added Sync button
-
-## [0.12.0] - 2025-12-10
-
-### Added - JSON-First Architecture (Zero Data Loss)
-
-Major refactor: JSON is now source of truth. Claude reads/writes JSON, MD views are auto-generated.
-
-- **New Data Flow**
-  - `data/*.json` - Source of truth (Claude reads/writes)
-  - `views/*.md` - Auto-generated from JSON (Claude does NOT write MD)
-  - Web app reads JSON directly (no regex parsing)
-
-- **LLM-Based Migration** (`/api/migrate`)
-  - OpenRouter Claude-3.5-haiku extracts structured data from legacy MD
-  - Comprehensive pattern extraction rules for ZERO data loss
-  - Migrates: state, queue, ideas, roadmap, shipped, metrics, project
-
-- **Enriched Schemas** (capturing ALL data from MD)
-  - `shipped.json`: Added `agent`, `description`, `codeSnippets[]`, `commit{hash,message}`
-  - `queue.json`: Added `agent`, `groupName`, `groupId` per task
-  - `ideas.json`: Added `source`, `sourceFiles[]`, `stack{}`, `modules[]`, `roles[]`, `risks[]`
-  - `roadmap.json`: Added `duration{}`, `taskCount`, `agent`, `sprintName`, `completedDate`
-
-- **View Generator** (`bin/generate-views.js`)
-  - Generates MD from JSON for Claude context
-  - Templates: now.md, next.md, ideas.md, roadmap.md, shipped.md
-
-- **Files Added**:
-  - `packages/web/lib/services/migration.server.ts` - LLM migration service
-  - `packages/web/app/api/migrate/route.ts` - Migration API endpoint
-  - `core/view-generator.ts` - View generation from JSON
-  - `bin/generate-views.js` - CLI for view generation
-
-- **Files Modified**:
-  - `core/schemas/*.ts` - All schemas with enriched fields
-  - `packages/web/lib/json-loader.ts` - Types synced with schemas
-
-## [0.11.6] - 2025-12-09
-
-### Fixed - Terminal Responsive & Performance Issues
-
-Bug fixes for terminal UX issues when resizing browser and handling large output.
-
-- **Resize Bug Fixed** - Terminal no longer gets stuck at ~100px² when resizing browser
-  - Replaced `window.addEventListener('resize')` with `ResizeObserver`
-  - Added dimension validation before fitting (handles hidden tabs correctly)
-  - Added proper cleanup on unmount
-  - Added re-fit on tab activation
-
-- **Performance Improvements** - Terminal now handles large output smoothly
-  - Added client-side output buffering with `requestAnimationFrame`
-  - Added server-side PTY output buffering (16ms batch window)
-  - Added terminal config optimizations (`scrollback: 5000`, `smoothScrollDuration: 0`)
-
-- **Files Modified**:
-  - `packages/web/hooks/useClaudeTerminal.ts` - ResizeObserver, output batching, fit function
-  - `packages/web/components/TerminalTab.tsx` - Re-fit on tab activation
-  - `packages/web/server.ts` - PTY output buffering
-
-## [0.11.5] - 2025-12-09
-
-### Fixed - Production Server Mode
-
-Critical bug fix: `prjct serve` now runs in production mode instead of development mode.
-
-- **Server Mode** - Changed from dev to production
-  - Default port: 3000 → 9472 (avoids conflicts)
-  - Mode: `npm run dev` → `npm run start:prod` with `NODE_ENV=production`
-  - Auto-build on first run if `.next/` doesn't exist
-  - All features now work correctly (were broken in dev mode)
-
-- **packages/web/package.json** - Added `start:prod` script
-
-## [0.11.0] - 2025-12-08
-
-### Added - Web Application & Server Components
-
-Major release introducing the prjct web application with Next.js.
-
-- **Web Application** - Full Next.js web interface for prjct
-  - Project stats API implementation
-  - Enhanced UI components
-  - Terminal functionality in browser
-
-- **Server Components** - New server infrastructure
-  - Project management endpoints
-  - Stats API for metrics and analytics
-
-- **UI Enhancements**
-  - Improved project management interface
-  - Enhanced terminal integration
-
-## [0.10.14] - 2025-11-29
-
-### Refactored - 100% Agentic Subagent Delegation via Task Tool
-
-Claude now delegates to specialist agents using the Task tool with efficient reference passing.
-
-- **`command-executor.js`** - Eliminated all if/else agent assignment logic
-  - Removed: `MandatoryAgentRouter`, `ContextFilter`, `ContextEstimator`
-  - Removed: `isTaskCommand()`, `shouldUseAgent()` methods
-  - JS only loads templates and context, Claude decides everything
-  - Added: `agentsPath` and `agentRoutingPath` to context for Claude
-
-- **Templates updated with Agent Delegation section**:
-  - `feature.md` - Added Task + Glob tools, agent delegation instructions
-  - `bug.md` - Added Task + Glob tools, agent delegation instructions
-  - `task.md` - Added Task + Glob tools, agent delegation instructions
-
-- **`agent-routing.md`** - Added efficient Task tool invocation
-  - Pass file PATH (~200 bytes), not content (3-5KB)
-  - Subagent reads agent file itself
-  - Reduced context bloat by 95%
-
-### Architecture
-
-```
-Usuario: "p. feature mejorar UX"
-    ↓
-Claude lee agent-routing.md → decide: "ux-ui"
-    ↓
-Claude: Task(prompt='Read: path/agents/ux-ui.md + Task: mejorar UX')
-    ↓
-Subagente: Lee archivo → aplica expertise → ejecuta
-```
-
-**Benefits:**
-- 95% reduction in prompt size for delegation
-- Lower hallucination risk
-- True 100% agentic - JS is pure orchestration
-
-## [0.10.12] - 2025-11-29
-
-### Refactored - Mandatory Agent Assignment (100% Agentic)
-
-All agent assignment decisions now delegated to Claude via templates. JS code is pure orchestration.
-
-- **New Template**: `templates/agent-assignment.md`
-  - Claude decides which agent based on task + available agents + context
-  - No hardcoded scoring weights or matching algorithms
-  - Semantic understanding replaces keyword matching
-
-- **Simplified `agent-router.js`**: 419 → 128 lines (69% reduction)
-  - Removed: scoring logic, domain mappings, caching algorithms
-  - Kept: load agents, build context, log usage (I/O only)
-  - Class renamed: `MandatoryAgentRouter` → `AgentRouter`
-
-- **Simplified `agent-matcher.js`**: 218 → 103 lines (53% reduction)
-  - Removed: multi-factor scoring (40% domain, 30% skills, etc.)
-  - Removed: all if/else matching logic
-  - Kept: format data, record usage, load history (I/O only)
-
-- **Updated commands.js**:
-  - `/p:now` - Assigns agent before setting task, shows `[agent]`
-  - `/p:feature` - Assigns agent to each task, format: `[agent] [ ] task`
-  - `/p:bug` - Assigns agent, shows `→ agent`
-  - `/p:build` - Uses async `_assignAgentForTask()`
-  - New method: `_assignAgentForTask()` - orchestrates agent assignment
-
-### Architecture Principle
-
-**JS = Orchestrator** (load files, build context, format data, I/O)
-**Claude = Decision Maker** (via templates for all logic)
-
-No scoring algorithms, no matching weights, no domain mappings in code.
-
-## [0.10.11] - 2025-11-29
-
-### Refactored - 100% Agentic System
-
-Complete elimination of procedural keyword-based logic. Claude now decides everything via templates:
-
-- **Templates Created (12 new files)**
-  - `templates/analysis/complexity.md` - Replaces `_detectComplexity()` keyword lists
-  - `templates/analysis/task-breakdown.md` - Replaces `_breakdownFeatureTasks()` hardcoded patterns
-  - `templates/analysis/bug-severity.md` - Replaces `_detectBugSeverity()` keyword detection
-  - `templates/analysis/health.md` - Replaces `_calculateHealth()` scoring logic
-  - `templates/analysis/intent.md` - Replaces `analyzeSemantics()` regex patterns
-  - `templates/design/architecture.md` - Architecture design guidance for Claude
-  - `templates/design/api.md` - API design guidance for Claude
-  - `templates/design/component.md` - Component design guidance for Claude
-  - `templates/design/database.md` - Database design guidance for Claude
-  - `templates/design/flow.md` - User flow design guidance for Claude
-  - `templates/architect/discovery.md` - Discovery phase template
-  - `templates/architect/phases.md` - Phase selection template
-
-- **commands.js** - Simplified 11 helper methods
-  - `_breakdownFeatureTasks()` - Returns placeholder, Claude generates via template
-  - `_detectBugSeverity()` - Returns 'medium', Claude assesses via template
-  - `_calculateHealth()` - Simple activity check, Claude evaluates via template
-  - `_detectComplexity()` - Returns default, Claude analyzes via template
-  - `_autoAssignAgent()` - Returns 'generalist', routing via agent-router.js
-  - `_generateArchitectureDesign()` - 60 → 2 lines
-  - `_generateApiDesign()` - 75 → 2 lines
-  - `_generateComponentDesign()` - 75 → 2 lines
-  - `_generateDatabaseDesign()` - 65 → 2 lines
-  - `_generateFlowDesign()` - 58 → 2 lines
-
-- **architecture-generator.js** - Reduced from 561 to 93 lines (83% reduction)
-  - Removed all phase-specific generation logic
-  - Claude generates content via architect templates
-
-- **task-analyzer.js** - Simplified semantic analysis
-  - `analyzeSemantics()` - Removed all regex patterns
-  - `estimateComplexity()` - Removed keyword lists
-  - `detectDomains()` - Returns empty, Claude decides domain
-
-### Fixed
-
-- **prompt-builder.test.js** - Updated 3 tests to match compressed format
-  - Tests now expect `## FILES:` instead of `AVAILABLE PROJECT FILES`
-  - Tests now expect `## PROJECT:` instead of `PROJECT FILES`
-
-### Impact
-- Zero keyword-based logic remaining
-- All decisions delegated to Claude via templates
-- Easier to extend (just add/edit templates)
-- More accurate analysis (semantic understanding vs pattern matching)
-
-## [0.10.10] - 2025-11-28
-
-### Refactored - Agentic Architecture Optimization
-
-Major refactoring to make prjct-cli truly agentic with 70% context reduction:
-
-- **CLAUDE.md** - Reduced from 1,079 to 204 lines (81% reduction)
-  - Removed verbose examples and implementation pseudocode
-  - Kept only critical rules and command reference
-  - Cleaner, more focused instructions for Claude
-
-- **Templates Expanded to Executable Specs**
-  - `done.md`: 24 → 138 lines with step-by-step instructions
-  - `ship.md`: 36 → 257 lines with full decision trees
-  - `feature.md`: 35 → 276 lines with value analysis flow
-  - `sync.md`: 72 → 263 lines with agent generation rules
-
-- **patterns.md** - Simplified from 207 to 61 lines (70% reduction)
-  - Removed verbose SOLID explanations
-  - Focused on detection steps and output format
-
-- **prompt-builder.js** - Conditional injection for efficiency
-  - Agents only injected for code-modifying commands
-  - Pattern summary extraction (800 bytes vs 6KB)
-  - File list compressed (5 files vs 20)
-
-### Impact
-- Context per command: ~54KB → ~18KB (67% reduction)
-- Templates now executable specifications with:
-  - Explicit paths and variables
-  - Decision trees with IF/ELSE
-  - Error handling at each step
-  - JSONL format specifications
-  - Concrete examples
-
-## [0.10.9] - 2025-11-28
-
-### Added
-
-- **Code Pattern Detection & Enforcement** - New system to detect and enforce code patterns
-  - `templates/analysis/patterns.md` - Template for detecting SOLID, DRY, naming conventions
-  - Detects design patterns: Factory, Singleton, Observer, Repository, Strategy
-  - Identifies anti-patterns: God classes, spaghetti code, copy-paste, magic numbers
-  - Extracts conventions: naming, style, async patterns, error handling
-  - Generates recommendations with specific file locations and fixes
-
-### Enhanced
-
-- **`/p:sync` Command** - Now includes pattern analysis
-  - Samples 5-10 source files across directories
-  - Detects SOLID compliance with evidence
-  - Extracts naming and style conventions
-  - Flags anti-patterns with severity (HIGH/MEDIUM/LOW)
-  - Saves analysis to `analysis/patterns.md`
-  - Updates CLAUDE.md with patterns summary
-
-- **Context Builder** - Added `codePatterns` path for pattern detection
-  - All code-modifying commands now load patterns automatically
-  - Commands: now, build, feature, design, cleanup, fix, test, spec, work
-
-- **Prompt Builder** - Includes patterns in code generation prompts
-  - Full patterns file included for code-modifying commands
-  - Explicit instruction: "ALL new code MUST respect these patterns"
-  - Anti-pattern prevention: "NO anti-patterns allowed"
-
-### Impact
-
-- New code automatically follows project conventions
-- Anti-patterns detected and flagged before they're introduced
-- Better code quality, performance, and scalability
-- Reduced technical debt from day one
-
-## [0.10.8] - 2025-11-28
-
-### Added
-
-- **Minimal Output System** - New `core/utils/output.js` module for clean, minimal CLI output
-  - `spin(msg)` - Spinner animation while working
-  - `done(msg)` - Single-line success output (✓)
-  - `fail(msg)` - Single-line error output (✗)
-  - `warn(msg)` - Single-line warning output (⚠)
-
-### Changed
-
-- **Reduced CLI Verbosity** - All major commands now show spinner + 1 line result instead of verbose multi-line output
-  - `/p:now` - Shows only task name and status
-  - `/p:done` - Shows task and duration in one line
-  - `/p:next` - Shows queue count only
-  - `/p:ship` - Spinner during steps, single line result with version
-  - `/p:feature` - Shows task count created
-  - `/p:init` - Spinner during initialization, minimal completion message
-  - `/p:bug` - Shows severity in one line
-  - `/p:context` - Shows task and queue summary
-  - `/p:recap` - Shows shipped/queue/ideas counts
-  - `/p:stuck` - Logs issue with minimal output
-  - `/p:design` - Shows design type created
-  - `/p:cleanup` - Shows items cleaned count
-  - `/p:progress` - Shows period metrics summary
-  - `/p:roadmap` - Shows features count
-
-### Improved
-
-- **Resource Efficiency** - Reduced terminal output significantly, consuming less resources
-- **Cleaner UX** - Focus on essential information, no verbose step-by-step logs
-
-## [0.10.7] - 2025-11-27
-
-### Fixed
-
-- **Critical Git Safety** - Added explicit protections against destructive git operations
-  - Prohibits `git checkout` without checking for uncommitted changes first
-  - Prohibits `git reset --hard` and `git clean -fd` operations
-  - Requires `git status` check before any git operation
-  - Prevents loss of user's work through accidental git operations
-
-- **Anti-Hallucination Improvements** - Enhanced instructions to prevent code hallucinations
-  - Explicit "READ CODE FIRST" requirement before modifying files
-  - Mandatory pattern matching with existing codebase
-  - Improved context awareness with file listings
-  - Better state filtering to preserve critical information (up to 2000 chars for critical files)
-
-### Enhanced
-
-- **Pattern Detection & Enforcement** - Automatic project pattern detection and enforcement
-  - Analysis file (`analysis/repo-summary.md`) automatically loaded for all code modification commands
-  - Project patterns extracted and displayed in prompts
-  - Explicit instructions to follow existing patterns exactly
-  - Step-by-step guide to match code style, structure, and conventions
-
-- **Context Improvements** - Better context loading and presentation
-  - Analysis included automatically for: now, done, next, ship, work, build, design, cleanup, fix, test
-  - Project files listed with instructions to use Read tool
-  - State filtering improved to show full content for critical files (now, next, context, analysis)
-  - Better truncation strategy (full content < 1000 chars, 2000 chars for critical files)
-
-- **Prompt Builder Enhancements** - More comprehensive instructions for Claude
-  - Anti-hallucination section with 7 critical rules
-  - Git safety rules with explicit prohibitions
-  - Pattern detection and enforcement section
-  - Available project files listing
-  - Improved enforcement section with pattern matching requirement
-
-## [0.10.6] - 2025-11-27
-
-### Enhanced
-
-- **Global CLAUDE.md Template** - Improved to help Claude use prjct-cli better
-  - Quick command reference table with examples
-  - Recommended workflow (sync → feature → now → done → ship)
-  - Common usage patterns with examples
-  - Anti-patterns table (what NOT to do)
-  - Using agents effectively section
-  - Simplified file structure overview
-  - Error handling table
-
-## [0.10.5] - 2025-11-27
-
-### Enhanced
-
-- **Rich Project Context** - CLAUDE.md now includes comprehensive project info
-  - Quick reference table (project, stack, files, commits, contributors)
-  - Full tech stack details (languages, frameworks, dependencies)
-  - Project structure (directories)
-  - Agent summaries with roles and expertise
-  - Current task and priority queue (top 5)
-  - Active roadmap features
-  - Recent ideas (top 3)
-  - Git activity (last 5 commits)
-  - Deep dive section with file paths for detailed info
-
-- **Reduced LLM Context Overhead** - Claude gets all key info in one file instead of reading multiple
-
-## [0.10.4] - 2025-11-27
-
-### Fixed
-
-- **Commands Module Export** - Fixed `require('./commands').sync is not a function` error
-  - Module now exports singleton instance for direct use
-  - Class still available via `require('./commands').PrjctCommands`
-  - Enables Claude to call commands directly: `require('./commands').sync()`
-
-## [0.10.3] - 2025-11-27
-
-### Fixed
-
-- **Global CLAUDE.md Auto-Update** - Now updates `~/.claude/CLAUDE.md` on every sync/analyze/init
-  - `/p:sync`: Updates global config after generating agents
-  - `/p:analyze`: Updates global config after analysis
-  - `/p:init`: Updates global config for all init modes
-  - Ensures Claude always has latest prjct instructions
-
-## [0.10.2] - 2025-11-27
-
-### Added
-
-- **Dynamic Project Context for Claude** - Claude now actually uses generated agents and project context
-  - New `core/context-sync.js` module generates project-specific CLAUDE.md
-  - Context file stored in global storage: `~/.prjct-cli/projects/{projectId}/CLAUDE.md`
-  - Auto-generates on `/p:sync`, `/p:analyze`, and `/p:init`
-  - Reads ALL agents dynamically (agents vary per project)
-  - Extracts: stack, current task, priority queue, active features
-  - Instructions added to global CLAUDE.md template for Claude to read project context
-
-### Changed
-
-- **`/p:sync` Command** - Now generates dynamic project context after syncing agents
-- **`/p:analyze` Command** - Now generates dynamic project context after analysis
-- **Global CLAUDE.md Template** - Added instructions for Claude to read project-specific context
-  - New "🤖 Project Context (OBLIGATORIO)" section
-  - Instructs Claude to read `~/.prjct-cli/projects/{projectId}/CLAUDE.md` before working
-
-### Technical Details
-
-- **New Files**:
-  - `core/context-sync.js` (~140 lines) - Context generation with dynamic agent reading
-
-- **Modified Files**:
-  - `core/commands.js` - Added context sync calls to sync() and analyze()
-  - `templates/global/CLAUDE.md` - Added project context reading instructions
-
-- **Architecture Decision**: Context lives in global storage (NOT in repo) to avoid being overwritten by commits
-
-## [0.10.1] - 2025-11-24
-
-### Added
-- Intelligent Agent System & Performance Optimization
-
-All notable changes to prjct-cli 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]
-
-## [0.10.0] - 2025-11-24
-
-### 🚀 Major Release: Intelligent Agent System & Performance Optimization
-
-This release represents a complete overhaul of the agent system with intelligent matching, semantic analysis, and massive performance improvements.
-
-### Added
-
-- **TaskAnalyzer - Deep Semantic Task Analysis**
-  - Multi-domain detection from task descriptions
-  - Historical pattern learning from previous tasks
-  - Complexity estimation for better agent matching
-  - Project context awareness for accurate domain detection
-  - Semantic understanding beyond simple keyword matching
-
-- **AgentMatcher - Intelligent Agent Matching**
-  - Multi-factor scoring system (domain, skills, history, complexity)
-  - Capability-based matching instead of simple keywords
-  - Learning system that improves from successful assignments
-  - Match explanations for transparency
-
-- **ContextEstimator - Pre-filtering System**
-  - Estimates required files BEFORE building full context
-  - Reduces I/O operations by 70-90%
-  - Technology-aware file pattern detection
-  - Supports multi-agent tasks
-
-- **AgentValidator - Quality Assurance**
-  - Pre-generation validation (prevents duplicate agents)
-  - Post-generation validation (ensures agent usefulness)
-  - Usefulness scoring to avoid generic agents
-  - Comparison with existing agents before generating
-
-- **SmartCache - Persistent Intelligent Cache**
-  - Cache keys: `{projectId}-{domain}-{techStack}` for precision
-  - Disk persistence for cross-session caching
-  - Intelligent invalidation only when stack changes
-  - Cache statistics and monitoring
-
-- **AgentLoader - Agent File Management**
-  - Loads agents from project files (agents are now actually used!)
-  - Extracts metadata (role, domain, skills) from agent content
-  - Caching system for performance
-  - Full agent content injection into prompts
-
-### Changed
-
-- **Lazy Context Building - 4-5x Performance Improvement**
-  - Context built only AFTER agent assignment
-  - Metadata-only phase before file reading
-  - Pre-filtered file lists reduce I/O dramatically
-  - Result: 0.5-1s assignment time (was 2-5s)
-
-- **Agent Router - Complete Rewrite**
-  - Uses TaskAnalyzer for semantic analysis
-  - Uses AgentMatcher for intelligent matching
-  - Uses SmartCache for persistent caching
-  - Uses AgentValidator for quality assurance
-  - Result: 85-95% matching accuracy (was 60-70%)
-
-- **Command Executor - Optimized Flow**
-  - Lazy context building implementation
-  - Pre-estimation of required files
-  - Reduced memory usage
-  - Faster execution
-
-- **Context Filter - Enhanced**
-  - Supports pre-estimated files for lazy loading
-  - Fallback to traditional filtering when needed
-  - Better integration with ContextEstimator
-
-- **Agent Generation - Dynamic & Validated**
-  - 100% dynamic technology detection (no hardcoding)
-  - Validation before and after generation
-  - Comparison with existing agents
-  - Result: 10-15% generic agents (was 40-50%)
-
-### Performance
-
-- **Agent Assignment**: 2-5s → 0.5-1s (**4-5x faster**)
-- **Matching Accuracy**: 60-70% → 85-95% (**+30% improvement**)
-- **Cache Hit Rate**: 20-30% → 70-80% (**2-3x improvement**)
-- **Generic Agents**: 40-50% → 10-15% (**75% reduction**)
-- **I/O Operations**: 70-90% reduction through pre-filtering
-- **Memory Usage**: Significant reduction through lazy loading
-
-### Technical Details
-
-- **New Components**:
-  - `core/domain/task-analyzer.js` - Semantic task analysis
-  - `core/domain/agent-matcher.js` - Intelligent matching with scoring
-  - `core/domain/context-estimator.js` - Pre-filtering system
-  - `core/domain/agent-validator.js` - Quality assurance
-  - `core/domain/smart-cache.js` - Persistent intelligent cache
-  - `core/domain/agent-loader.js` - Agent file management
-  - `core/domain/tech-detector.js` - Dynamic technology detection
-
-- **Modified Components**:
-  - `core/agentic/agent-router.js` - Complete rewrite with new system
-  - `core/agentic/command-executor.js` - Lazy context building
-  - `core/agentic/context-filter.js` - Pre-estimation support
-  - `core/domain/agent-generator.js` - Agent loading integration
-  - `core/commands.js` - Dynamic agent generation
-
-- **Breaking Changes**: None - fully backward compatible
-
-## [0.9.2] - 2025-11-22
-
-### Fixed
-
-- **Critical: Missing `glob` dependency** - Fixed "Cannot find module 'glob'" error
-  - Added `glob@^10.3.10` to dependencies in `package.json`
-  - Resolves installation failures on fresh npm installs
-  - Compatible with Node.js v18+ (including v24.x LTS)
-
-- **Critical: glob API compatibility** - Fixed TypeError with modern glob versions
-  - Updated `context-filter.js` to use modern glob API (v10+)
-  - Removed deprecated `promisify(glob)` pattern
-  - Changed to `const { glob } = require('glob')` with native promise support
-  - Added defensive array validation for glob results
-  - Resolves "ERR_INVALID_ARG_TYPE: The 'original' argument must be of type function" error
-
-### Added
-
-- **Comprehensive Test Coverage** - Added 140+ tests for critical modules
-  - ✅ `core/agentic/agent-router.js` - 20 tests (agent assignment, task analysis, context filtering)
-  - ✅ `core/infrastructure/config-manager.js` - 30+ tests (config read/write, author management, validation)
-  - ✅ `core/infrastructure/path-manager.js` - 35 tests (path generation, session management, project structure)
-  - ✅ `core/utils/jsonl-helper.js` - 20+ tests (JSONL parsing, file operations, rotation)
-  - ✅ `core/domain/analyzer.js` - 15+ tests (project analysis, file detection, git integration)
-  - ✅ `core/infrastructure/author-detector.js` - 10+ tests (author detection, git integration)
-  - ✅ `core/agentic/context-filter.js` - 31 tests (already existed, now includes glob API tests)
-  - **Coverage improvement**: ~15% → ~40-50% overall coverage
-  - **Test files created**: 6 new test suites covering critical infrastructure
-
-### Changed
-
-- **Test Infrastructure** - Enhanced test suite with comprehensive coverage
-  - All critical infrastructure modules now have full test coverage
-  - Tests detect dependency issues and API compatibility problems
-  - Better error detection and prevention for future changes
-
-### Technical Details
-
-- **Dependency Updates**:
-  - Added `glob@^10.3.10` to production dependencies
-  - Compatible with Node.js v18.0.0+ (tested with v24.x)
-  
-- **Code Changes**:
-  - `core/agentic/context-filter.js`: Updated glob usage to modern API
-  - Added array validation for glob results (defensive programming)
-  
-- **Test Files Added**:
-  - `core/__tests__/agentic/agent-router.test.js`
-  - `core/__tests__/infrastructure/config-manager.test.js`
-  - `core/__tests__/infrastructure/path-manager.test.js`
-  - `core/__tests__/utils/jsonl-helper.test.js`
-  - `core/__tests__/domain/analyzer.test.js`
-  - `core/__tests__/infrastructure/author-detector.test.js`
-
-## [0.9.1] - 2024-11-22
-
-### 🎯 Context Optimization & Prompt Efficiency
-
-Major performance improvements through context window optimization and prompt conciseness.
-
-### Added
-
-- **Mandatory Agent Assignment System**
-  - Every task now requires specialized agent assignment
-  - Automatic expertise detection from task descriptions
-  - Universal technology support (Ruby, Go, Python, etc.)
-
-- **Context Filtering System**
-  - 70-90% context window reduction per task
-  - Technology-specific file filtering
-  - Smart pattern detection for any framework
-
-### Changed
-
-- **Optimized Command Templates** (~70% reduction)
-  - Concise, efficient prompts for AI understanding
-  - Removed verbose explanations
-  - Direct flow instructions with → and | notation
-
-- **Agent Generation Improvements**
-  - Dynamic, concise agent prompts
-  - Removed 200+ lines of hardcoded patterns
-  - Universal technology detection
-
-### Performance
-
-- Context window usage: **70-90% reduction**
-- Template verbosity: **~70% average reduction**
-- Agent specialization: True domain focus achieved
-
-## [0.9.0] - 2024-11-22
-
-### 🚀 Major Release: Simplified Commands + Pause/Resume + Intelligent Ideas
-
-This release represents a **major simplification** of prjct-cli, reducing commands by 48% while adding powerful new capabilities including pause/resume for task interruptions and AI-powered idea development.
-
-### Added
-
-- **Task Stack System** - Natural workflow with interruptions
-  - ✅ `/p:pause [reason]` - Pause active task to handle interruptions
-  - ✅ `/p:resume [task_id]` - Resume paused tasks with preserved context
-  - ✅ Multiple concurrent paused tasks supported
-  - ✅ Automatic duration tracking (excludes paused time)
-  - ✅ Migration from legacy `now.md` to new `stack.jsonl` format
-  - 📊 Impact: Handle urgent tasks without losing context
-
-- **Intelligent Idea Development** - Transform ideas into complete architectures
-  - ✅ `/p:idea` enhanced to develop full technical specifications
-  - ✅ Simple ideas → Quick capture (< 20 words)
-  - ✅ Complex ideas → Complete architecture generation
-  - ✅ Interactive discovery process with AI
-  - ✅ Generates: Tech stack, API specs, database schema, roadmap
-  - ✅ Saves to `planning/architectures/{id}/` for reference
-  - 📊 Impact: Go from idea to implementation-ready specs in one command
-
-- **Unified Commands** - Fewer commands, more power
-  - ✅ `/p:work [task]` - Replaces `/p:now` + `/p:build`
-    - No params → Show current task
-    - With task → Start new task
-  - ✅ `/p:dash [view]` - Replaces 4 dashboard commands
-    - Default → Full dashboard
-    - `week/month` → Progress views
-    - `roadmap` → Planning view
-    - `compact` → Minimal status
-  - ✅ `/p:help [topic]` - Enhanced to absorb 3 commands
-    - Absorbs `/p:ask`, `/p:suggest`, `/p:stuck`
-    - Context-aware suggestions
-    - Intent to action translation
-
-### Changed
-
-- **Command Count** - Reduced from 23 → 13 (48% reduction)
-  - Core workflow remains 13 commands but simplified
-  - Removed redundant overlapping commands
-  - Better organization and clearer purpose
-
-- **Architecture Generator** - New system for idea development
-  - `core/domain/architecture-generator.js` - Full architecture generation
-  - `core/domain/task-stack.js` - Pause/resume task management
-  - `templates/planning-methodology.md` - Comprehensive planning guide
-
-### Removed
-
-- **Deprecated Commands** - Completely removed (not just marked deprecated)
-  - ❌ `/p:now` → Use `/p:work`
-  - ❌ `/p:build` → Use `/p:work "task"`
-  - ❌ `/p:status` → Use `/p:dash`
-  - ❌ `/p:roadmap` → Use `/p:dash roadmap`
-  - ❌ `/p:recap` → Use `/p:dash`
-  - ❌ `/p:progress` → Use `/p:dash week`
-  - ❌ `/p:ask` → Use `/p:help`
-  - ❌ `/p:suggest` → Use `/p:help`
-  - ❌ `/p:stuck` → Use `/p:help stuck:`
-  - ❌ `/p:workflow` → Automatic in `/p:ship`
-  - ❌ `/p:task` → Use `/p:feature` for breakdown
-
-### Migration Guide
-
-**For existing users:**
-1. First run will automatically migrate `now.md` to new stack system
-2. Old commands will show error with suggestion to use new command
-3. All data preserved during migration
-
-**Command mapping:**
-```bash
-# Old → New
-/p:now              → /p:work
-/p:build "task"     → /p:work "task"
-/p:status           → /p:dash
-/p:roadmap          → /p:dash roadmap
-/p:ask "question"   → /p:help ask: "question"
-/p:suggest          → /p:help
-/p:stuck "issue"    → /p:help stuck: "issue"
-```
-
-**New workflow:**
-```bash
-/p:idea "build CRM"     # Develop complete architecture
-/p:work "implement auth" # Start task
-/p:pause                 # Urgent interruption
-/p:work "fix bug"        # Handle urgent task
-/p:done                  # Complete bug
-/p:resume                # Back to auth
-/p:ship "auth feature"   # Ship when done
-```
-
-### Technical Details
-
-- New files: 10 templates, 3 domain modules
-- Modified: Command registry, core commands
-- Lines of code: +2000 (new features), -3000 (removed redundancy)
-- Breaking changes: Yes (old commands removed)
-- Data migration: Automatic
-
-## [0.8.8] - 2025-10-06
-
-### Added
-
-- **System timestamp tools** - LLM now gets real date/time from system instead of guessing
-  - ✅ `GetTimestamp()` tool - Returns ISO timestamp from system clock
-  - ✅ `GetDate()` tool - Returns YYYY-MM-DD from system clock
-  - ✅ `GetDateTime()` tool - Returns full date/time object with components
-  - 🐛 **Bug fixed**: Tasks no longer show January 1st dates when it's October
-  - 📊 Impact: Session files now use correct dates, analytics work properly
-
-- **Template optimization** - Phase 1 complete: Top 7 critical templates optimized
-  - ✅ Reduced from 2006 → 605 lines (69.8% reduction, saved 1401 lines)
-  - ✅ All templates now in English only (removed Spanish examples)
-  - ✅ Preserved 100% of business logic and decision-making patterns
-  - ✅ Removed verbose examples, success criteria, redundant explanations
-  - 📊 Impact: Faster LLM processing, lower token usage, clearer instructions
-
-- **Legacy installation cleanup** - Automatic detection and removal of curl-based installations
-  - ✅ Detects legacy `~/.prjct-cli/` from curl install.sh (pre-v0.8.2)
-  - ✅ Migrates project data to npm global location automatically
-  - ✅ Removes legacy installation files (bin/, core/, templates/, etc.)
-  - ✅ Preserves user data (projects/ directory migrated safely)
-  - ✅ Cleans up shell PATH entries (bash/zsh/PowerShell)
-  - ✅ Removes legacy symlinks on Unix systems
-  - 🎯 **Impact**: Users on old curl installations automatically migrate to npm
-  - 🔧 **Windows compatible**: Handles PowerShell profiles, skips Unix-only operations
-
-### Changed
-
-- **Critical timestamp rule in CLAUDE.md** - Added prominent warning about LLM timestamp limitations
-  - LLM knowledge cutoff is January 2025, cannot generate accurate timestamps
-  - All templates now include `timestamp-rule` in frontmatter
-  - Templates updated: feature.md, ship.md, now.md, build.md, idea.md
-  - Hardcoded example dates replaced with GetTimestamp()/GetDate() tool calls
-
-- **Templates optimized** (Phase 1 - Top 7)
-  - suggest.md: 555 → 96 lines (82.7% reduction)
-  - ask.md: 386 → 73 lines (81.1% reduction)
-  - help.md: 348 → 90 lines (74.1% reduction)
-  - feature.md: 239 → 93 lines (61.1% reduction)
-  - init.md: 210 → 113 lines (46.2% reduction)
-  - ship.md: 148 → 79 lines (46.6% reduction)
-  - migrate-all.md: 120 → 61 lines (49.2% reduction)
-
-- **context-builder.js** - Enhanced timestamp documentation
-  - Clarified that timestamps come from system clock, not LLM
-  - Added inline comments explaining ISO format and YYYY-MM-DD format
-
-- **install.sh deprecation** - Enhanced messaging with legacy detection
-  - Now detects if user has legacy curl installation
-  - Shows version and location of legacy install
-  - Provides clear migration instructions
-  - Explains automatic cleanup process
-
-- **All Spanish removed from codebase** - 100% English documentation
-  - Updated all JSDoc comments to English
-  - Removed Spanish examples from templates
-  - Fixed: setup.js, postinstall.js, AGENTS.md
-
-### Fixed
-
-- **Session date accuracy** - All session files now use correct system date
-  - Previously: LLM generated timestamps (often January 1st)
-  - Now: System clock provides accurate timestamps via GetTimestamp() tool
-  - Duration calculations now accurate
-  - Progress tracking and analytics now reliable
-
-- **Windows compatibility** - Full cross-platform support
-  - Legacy installer detector works on Windows
-  - Platform detection via `process.platform === 'win32'`
-  - PowerShell profile cleanup (instead of bash/zsh)
-  - Skips symlink cleanup on Windows (Unix-only feature)
-  - Cross-platform path handling with `os.homedir()` and `path.join()`
-  - Command installer already works on Windows (no changes needed)
-
-## [0.8.6] - 2025-10-05
-
-### Fixed
-
-- **Critical: Command update system** - Fixed command synchronization to ALWAYS update to latest version
-  - ✅ Removed mtime comparison (was causing commands to stay outdated)
-  - ✅ ALWAYS overwrites existing commands with latest templates
-  - ✅ Guarantees all clients get updated commands on `npm update`
-  - ✅ Preserves legacy commands (removed: always 0)
-  - 🐛 **Bug fixed**: `now.md`, `done.md` and other commands now update correctly across all client installations
-
-- **Setup architecture redesigned** - Dual-defense strategy for reliable setup
-  - ✅ First-use setup check in `bin/prjct` (guaranteed execution)
-  - ✅ Optional postinstall optimization (when scripts enabled)
-  - ✅ Works in CI/CD environments with `--ignore-scripts`
-  - ✅ Version tracking via `editors-config.js`
-  - ✅ Zero manual steps required
-
-### Changed
-
-- **Command sync behavior** (`syncCommands()`)
-  - Previous: Compared mtime, only updated if source newer → ❌ Unreliable
-  - Now: ALWAYS overwrites existing commands → ✅ Always latest version
-  - Preserves legacy/custom commands not in templates
-  - Result: `{ added: X, updated: Y, removed: 0 }`
-
-- **Setup flow**
-  - Centralized all logic in `core/infrastructure/setup.js`
-  - `bin/prjct` checks version on every execution
-  - `scripts/postinstall.js` simplified to optional helper
-  - Auto-setup triggers on version mismatch or first use
-
-### Technical
-
-- Reduced `scripts/postinstall.js` from 250 → 69 lines
-- Created `core/infrastructure/setup.js` (167 lines) - single source of truth
-- Modified `bin/prjct` to include version check (34 lines)
-- Removed `.setup-complete` marker (using JSON version tracking instead)
-
-## [0.8.2] - 2025-10-05
-
-### Changed
-
-- **BREAKING: npm-only installation** - Simplified installation to npm-only
-  - ✅ Single command: `npm install -g prjct-cli`
-  - ✅ Automatic setup via postinstall hook
-  - ✅ Auto-migration of legacy projects
-  - ✅ Beautiful ASCII art on installation
-  - ⚠️ `curl -fsSL https://prjct.app/install.sh` now deprecated (shows migration message)
-
-### Added
-
-- **Automatic Post-Install Setup** (`scripts/postinstall.js`)
-  - Runs automatically after `npm install -g prjct-cli`
-  - Detects global vs local installation
-  - Installs/syncs commands to `~/.claude/commands/p/`
-  - Migrates legacy projects automatically
-  - Shows beautiful ASCII art with quick start guide
-
-- **Intelligent Command Sync** (`syncCommands()` in `command-installer.js`)
-  - Detects new commands and installs them
-  - Detects updated commands and refreshes them
-  - **Detects orphaned commands and removes them** (e.g., context.md, stuck.md)
-  - Reports: "✓ 2 nuevos, 5 actualizados, 2 eliminados"
-
-- **Beautiful ASCII Art** (`showAsciiArt()` in `commands.js`)
-  - Displays after `prjct setup` completion
-  - Shows prjct logo with colors
-  - Includes quick start guide
-  - Links to documentation
-
-- **Global Configuration** (`~/.claude/CLAUDE.md`)
-  - Automatically installs/updates global configuration for Claude Code
-  - Provides context for ALL `/p:*` commands across any prjct project
-  - Intelligent merge: preserves user content, updates only prjct section
-  - Includes path resolution rules, file structure, commit format, validation patterns
-  - Installed during `npm install -g prjct-cli` and `prjct setup`
-  - Single source of truth - no need to repeat in 25 command templates
-
-### Fixed
-
-- **Orphaned Commands Cleanup** - Removed deprecated commands
-  - Deleted `context.md` (replaced by context tracking in core)
-  - Deleted `stuck.md` (functionality merged into /p:ask)
-  - Total commands: 27 → 25 (cleaned up)
-
-- **Context Preservation** - All projects now use global storage
-  - Legacy projects in `.prjct/` automatically migrated to `~/.prjct-cli/projects/{id}/`
-  - Only `prjct.config.json` (2KB) remains in project directory
-  - Prevents context loss on updates
-
-### Documentation
-
-- Updated README.md with new installation flow
-- Added "Auto-Setup (NEW in v0.8.2)" section
-- Simplified installation instructions
-- Deprecated manual installation methods
-
-## [0.8.1] - 2025-10-05
-
-### Fixed
-
-- **Critical Installation Bug** - Fixed incorrect path in `install.sh` line 315
-  - Changed `./core/command-installer` → `./core/infrastructure/command-installer`
-  - Resolves "Cannot find module" error during installation
-
-- **Missing Method Error** - Added `installToAll()` method to command-installer
-  - Implements method called by install.sh line 316
-  - Acts as alias for `installCommands()` for backward compatibility
-
-- **Commands Not Auto-Updating** - Implemented automatic command synchronization
-  - After `git pull`, commands in `~/.claude/commands/p/` now update automatically
-  - Added visual confirmation: "Commands synchronized ✓"
-
-- **Missing Visual Confirmation** - Added ASCII confirmation in setup.sh
-  - Displays "✨ Setup Complete! ✨" after successful npm install
-  - Clear feedback that installation succeeded
-
-### Added
-
-- **Update Script** - New `scripts/update.sh` for easy updates
-  - Single command to update prjct-cli: `npm run update`
-  - Handles: git pull → npm install → command updates
-  - Visual progress indicators and confirmation
-
-- **Enhanced Logging** - Improved updateCommands() with visual feedback
-  - Shows "🔄 Updating commands with latest templates..."
-  - Displays "✅ Updated X commands" on success
-
-### Changed
-
-- **Installation Flow** - Simplified and more reliable
-  - Auto-updates commands after git pull (no manual reinstall needed)
-  - Single npm install (eliminated duplication)
-  - Clear visual feedback at each step
-
-## [0.8.0] - 2025-10-05
-
-### Added
-
-- **3-Tier Guided Workflow System** - Zero memorization interface for confused users
-  - **`/p:help`** - Contextual interactive guide that adapts to project state
-    - 5 different response contexts (Not initialized, Empty queue, Has active task, Has queue, Lost/confused)
-    - Shows relevant options based on current situation
-    - Educational approach with examples
-  - **`/p:ask`** - Intent to action translator with explanations
-    - Natural language understanding for any intent
-    - Recommends appropriate command flows with reasoning
-    - Works in any language (English, Spanish, etc.)
-    - Educational responses explain the "why" behind each recommendation
-    - Intent categories: Feature Development, Performance, Bug Fixing, Design, Lost/Confused
-  - **`/p:suggest`** - Context-aware smart recommendations
-    - Analyzes project state (active tasks, queue, velocity, momentum)
-    - Detects patterns: stuck tasks, losing momentum, over-planning, ready to work
-    - Provides urgency levels and actionable next steps
-    - Scenario-based suggestions with clear actions
-  - Updated from 9 to 13 core commands
-  - Version bumped to 0.7.0 → 0.8.0
-
-- **Enhanced Feature Templates** - Quick start templates for common workflows
-  - 6 interactive template categories: UI/UX, Performance, Features, Quality, Bugs, Docs
-  - Each category includes examples and natural language alternatives
-  - Integrated into `/p:feature` command for faster feature initialization
-
-- **Enhanced Onboarding** - Conversational first-time experience
-  - Updated `/p:init` with "What do you want to do first?" section
-  - 5 clear options with examples and natural language alternatives
-  - Guides users to appropriate commands based on their needs
-
-### Changed
-
-- **Website Transformation** - Complete shift from "memorize commands" to "conversational/agentic"
-
-  - **Hero Section** (`Hero.tsx`)
-    - Changed layout from centered to 60/40 asymmetric grid (better space utilization on LG screens)
-    - Updated messaging: "Just talk: 'p. I want to add auth' → Claude handles the rest"
-    - Added 3 conversational example cards showing real usage patterns
-    - Removed sequential command flow in favor of natural language examples
-    - Better visual hierarchy with left column (60%) for main content, right column (40%) for examples
-
-  - **Terminal Demo** (`Terminal.tsx`)
-    - Replaced 4 rotating examples with single comprehensive flow
-    - Shows complete journey: Installation → Setup → Usage → Progress → Shipping
-    - Demonstrates real `p.` trigger usage throughout
-    - Improved timing: 3500ms between steps (was 1500ms) for better comprehension
-    - 12s restart delay (was 10s) for proper reading time
-    - Title: "See It In Action - From installation to shipping"
-
-  - **How It Works Section** (`HowItWorks.tsx`)
-    - New 3-step visual flow: Talk Naturally → Claude Understands → You Ship
-    - Removed misleading chat-style UI examples (product is terminal-only)
-    - Clean, honest representation of terminal-based workflow
-    - Icon-based visual guide with examples
-
-  - **Command Guide** (`CommandGuide.tsx`)
-    - Added 2 priority scenarios at top:
-      - "I'm new/lost/don't know what to do" → `/p:help`, `/p:ask`, `/p:suggest`
-      - "I know what I want but not how to do it" → `/p:ask` (preferred)
-    - Updated Quick Decision Matrix to prioritize help commands
-    - All examples show `p.` trigger as preferred option with `/p:*` alternatives
-
-  - **Commands Page** (`Commands.tsx`)
-    - Added prominent "Start Here - No Memorization Needed" section
-    - Highlights 3 essential commands: `/p:help`, `/p:ask`, `/p:suggest`
-    - Moved all specific commands to "Advanced Reference" section
-    - Clear message: "You only need these 3 commands. Everything else? Just talk naturally."
-
-- **Command Registry Updates** (`command-registry.js`)
-  - Added `ask` and `suggest` to core commands
-  - Updated version from 0.7.0 to 0.8.0
-  - Increased core command count from 9 to 13
-  - Enhanced metadata for new help system commands
-
-- **Documentation Updates** (`CLAUDE.md`)
-  - Added complete "Guided Workflow System" section
-  - Documented 3-tier help architecture with examples
-  - Updated natural language system philosophy
-  - Added context validation patterns and examples
-
-### Philosophy Shift
-
-This release represents a fundamental shift in how users interact with prjct:
-
-**Before (0.7.x)**: "Learn these sequential commands: `/p:feature → /p:done → /p:ship`"
-**After (0.8.0)**: "Just talk: `p. I want to add auth` → Claude handles the rest"
-
-The 3-tier help system solves the core user frustration: **users know WHAT they want but don't know HOW to execute it**. Now they don't need to - they just describe their intent and the system guides them.
-
-### Technical Details
-
-- **New Templates**:
-  - `templates/commands/ask.md` - Intent translation with educational responses
-  - `templates/commands/suggest.md` - Context-aware recommendations
-  - Updated `templates/commands/help.md` - Contextual interactive guide
-  - Updated `templates/commands/init.md` - Conversational onboarding
-  - Updated `templates/commands/feature.md` - Interactive mode with templates
-
-- **Website Optimization**:
-  - Hero grid: `lg:grid-cols-5` with `lg:col-span-3` (60%) + `lg:col-span-2` (40%)
-  - Terminal timing: 3500ms step delay, 12s restart delay
-  - Removed chat UI mockups to avoid false expectations
-  - Consistent `p.` trigger examples throughout
-
-- **User Experience**:
-  - Zero memorization required for basic usage
-  - Natural language works in any language (English, Spanish, etc.)
-  - Context-aware help adapts to project state
-  - Educational responses explain the "why" behind recommendations
-
-## [0.7.3] - 2025-10-05
-
-### Added
-
-- **Comprehensive Testing Documentation** - Complete testing guide and setup documentation
-  - **TESTING.md** - Full testing guide with:
-    - Quick start commands for running tests
-    - Bun-based testing setup (core)
-    - Detailed configuration for both Node.js and React environments
-    - Testing best practices and examples
-    - CI/CD integration documentation
-    - Troubleshooting guide
-    - Complete command reference
-  - **README.md Testing Section** - Quick reference with:
-    - Quick start commands
-    - Test suites overview (Core CLI + Website)
-    - CI/CD automation status
-    - Link to comprehensive TESTING.md guide
-  - **Documentation Quality**: Professional-grade testing documentation for contributors and developers
-  - **Coverage**: Documents all 283 tests across both core and website projects
-
-### Fixed
-
-- **Lint Errors** - Removed 3 unused variables to pass ESLint
-  - Removed unused `globalProjectPath` in commands.js
-  - Removed unused `architectSession` require in commands.js
-  - Removed unused `fs` import in session-manager.js
-
-### Technical Details
-
-- **Testing Stack**: Bun test for unit tests
-- **Core Tests** (Node.js): 179 tests for agentic system, commands, and utilities
-- **Website Tests** (React): 104 tests with Testing Library for components
-- **CI/CD**: GitHub Actions workflow with parallel test execution
-- **Coverage**: V8 coverage provider with HTML reports
-
-## [0.7.2] - 2025-10-04
-
-### Fixed
-
-- **Vercel Deployment Configuration** - Fixed deployment build and configuration
-  - Updated vercel build commands to use npm prefix syntax
-  - Moved and simplified vercel.json config
-  - Added Vercel deployment config and removed CNAME file
-  - Fixed build output directory configuration
-
-### Changed
-
-- **Version Bump** - Updated from 0.7.1 to 0.7.2
-
-## [0.7.1] - 2025-10-04
-
-### Added
-
-- **Command Implementation Status** - Added setup and migrate-all commands
-  - Marked roadmap, status, and build commands as implemented in registry
-  - Added isSupported flag to agent detection for Claude and Terminal agents
-  - Better clarity on which commands are available in each environment
-
-## [0.7.0] - 2025-10-04
-
-### Added
-
-- **Vercel Analytics Integration** - Added Vercel Analytics and Speed Insights tracking
-  - Real-time performance monitoring for website
-  - User analytics and insights
-  - Speed metrics tracking
-
-- **AI Policy Page** - New dedicated page for AI usage policies
-  - Redesigned footer layout with AI Policy link
-  - Clear transparency about AI integration
-  - Updated navigation structure
-
-### Changed
-
-- **Repository Privacy** - Transitioned from open source to proprietary
-  - Removed all GitHub repository links from website
-  - Removed open source references
-  - Updated Terms of Use with proprietary license
-  - Repository made private due to AI agent privacy concerns and terms of use compliance
-  - FREE tier remains available to all users indefinitely
-  - Contact: jlopezlira@gmail.com or jlopezlira.dev
-
-- **Deployment Migration** - Migrated from GitHub Pages to Vercel
-  - Better build performance and CDN
-  - Automatic deployments
-  - Improved website hosting
-
-- **Workflow Simplification** - Reduced to 5 essential commands
-  - Streamlined developer experience
-  - Clearer command structure
-  - Focus on core functionality
-
-- **Documentation Updates**
-  - Added session-based architecture documentation with auto-archiving
-  - JSONL logs for better performance
-  - Moved Changelog link from header to footer
-
-### Fixed
-
-- **TypeScript Build Errors** - Resolved all TypeScript errors in website build
-  - Removed unused Globe import from Privacy.tsx
-  - Fixed type errors across components
-
-### Technical Details
-
-- **Session Architecture**: JSONL-based logging with auto-archiving after 30 days
-- **Deployment**: Vercel platform with automatic builds
-- **Analytics**: Vercel Analytics + Speed Insights integration
-- **Privacy**: Repository now private, free tier remains available
-
-## [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)
-  - **Changes**:
-    - Refactored `start()` function to use `detectClaude()` instead of `detectEditors()`
-    - Replaced `interactiveInstall()` with `installCommands()`
-    - Removed multi-editor logic (Cursor, Windsurf references)
-    - Updated messaging to be Claude-only with download link
-    - 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/`
-
-### 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)"
-    - Added clarity: "No extra costs or tokens required - just install and use with your existing Claude access"
-  - Updated `website/src/components/FAQ.tsx`:
-    - Replaced misleading "100% free" claims with accurate subscription info
-    - Emphasized "no extra setup", "no token management", "no API keys to configure"
-  - Updated `README.md`:
-    - Changed "100% free" → "works with free tier or Pro"
-    - Added clarity about zero additional costs beyond existing Claude subscription
-    - Explained Claude has free tier but isn't completely free
-    - **Editor Installation**: Removed multi-editor references (Cursor, Windsurf, Codex) - now shows Claude-only installation
-    - **Natural Language Section**: Renamed to "p. Trigger - Zero Memorization" and updated all examples to show p. prefix
-    - **Alignment**: All examples now consistently show "p. I want..." format
-    - **Data Storage**: Fixed inconsistent paths - changed `.prjct/` → `~/.prjct-cli/projects/{id}/` for accuracy
-    - **Team Workflow**: Updated to reflect global architecture with local data and shared config
-    - **FAQ Sections**: Both quick and detailed FAQs now aligned with global architecture
-  - **Why This Matters**: Being honest about costs builds trust - prjct-cli doesn't require extra payments, but Claude itself has subscription tiers
-
-- **Fixed TypeScript Errors** - Removed unused imports across website components
-  - Fixed `website/src/pages/Changelog.tsx`: Added missing `MessageSquare` import
-  - Fixed `website/src/components/Features.tsx`: Removed unused `Cpu` import
-  - Fixed `website/src/pages/Commands.tsx`: Removed unused `Cpu`, `Wind` imports
-  - Fixed `website/src/components/WindsurfExtension.tsx`: Removed unused `Zap`, `ChevronRight` imports
-  - Fixed `website/src/components/WindsurfPreview.tsx`: Removed unused `ArrowRight`, `GitBranch`, `PlayCircle`, `Layers`, `ChevronRight` imports
-  - 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
-    - '"p. I\'m done" → /p:done | "p. start building auth" → /p:now | "p. ship this" → /p:ship'
-  - Updated `website/src/components/ClaudeSuperpowers.tsx`:
-    - Changed "Natural Language" → "p. Trigger - Zero Memorization"
-    - All examples now show p. prefix: "p. I'm done", "p. start building auth", "p. ship this feature"
-  - Updated `website/src/pages/Commands.tsx`:
-    - Natural language examples now include p. trigger
-    - "p. I want to start building the login page", "p. I'm done", "p. ship this feature"
-  - Updated `website/src/pages/docs/QuickStart.tsx`:
-    - Changed examples to use p. trigger
-    - "p. I'm done" when finished, "p. ship this feature" to celebrate
-
-- **Copy Simplification for Creators** - Made all text stupidly simple to understand
-  - Updated `README.md` to speak to creators and small teams, not just developers:
-    - Changed "indie hackers" → "solo creators and founders"
-    - Changed "developer momentum" → "track progress, not meetings"
-    - Simplified technical jargon:
-      - "Git validation" → "Checks your actual code changes"
-      - "MCP Integration" → "AI tools that help you code"
-      - "Dynamic AI Agents" → "Smart AI helpers"
-    - Made benefits easier to understand for non-technical creators
-  - Updated `website/src/components/InteractiveTerminal.tsx` examples:
-    - "implement user authentication" → "build login feature"
-    - "JWT token not validating" → "login not working"
-    - "API rate limiting" → "prevent spam requests"
-    - "Design notification architecture" → "Design how notifications will work"
-    - "Setup WebSocket server" → "Setup real-time messaging"
-  - Added explanatory comments to `website/src/lib/utils.ts`:
-    - Simple explanation of what `cn()` function does
-    - 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.
-  - Auto-validates `.prjct/prjct.config.json` before execution
-  - Context-aware: Only works in prjct directories
-  - Provides friendly error when not in prjct project
-  - Implemented via CLAUDE.md instructions (no SDK needed)
-  - Zero API keys, zero additional costs
-
-- **Natural Language Context Validation** - Conversational responses when context is missing
-  - Automatic context validation before command execution
-  - Friendly guidance instead of technical errors
-  - Multi-language intent detection (English, Spanish, etc.)
-  - 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
-  - Implemented semantic intent understanding (Claude's native LLM capability)
-  - Updated `templates/commands/done.md` with context validation docs
-  - Updated `templates/examples/natural-language-examples.md`:
-    - Added Example 11: p. Trigger (zero memorization)
-    - Added Example 12: p. Trigger multi-language
-    - Added Example 13: p. Trigger without project
-    - Added Example 14: All three ways work (p. | /p: | natural)
-    - Added examples for missing context scenarios (Example 2b, 3b)
-    - Updated implementation notes (no SDK approach)
-  - Created `docs/p-trigger.md` - Complete p. trigger documentation
-
-- **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"
-    - Restored Windsurf Extension CTA with scroll-to-section functionality
-    - Added Sparkles and ArrowRight animated icons
-  - `website/src/components/Features.tsx`:
-    - Updated p. Trigger feature to show natural language first
-  - `website/src/components/CommandGuide.tsx`:
-    - Added p. trigger examples to all 6 scenarios (preferred option)
-    - Updated Quick Decision Matrix to show p. trigger format
-    - All examples now follow: `"p. [natural language]"` → `/p:command` pattern
-    - Demonstrates zero memorization approach throughout
-
-- **Windsurf Extension Preview Section** - Added complete Windsurf extension roadmap to homepage
-  - `website/src/components/WindsurfExtension.tsx`:
-    - Full section with hero, features grid, timeline, and early access form
-    - Development timeline (Oct 2025 - Feb 2026)
-    - 4 key features: Real-time Metrics, Focus Mode, Velocity Tracking, Smart Notifications
-    - Progress bar showing 10% completion (validation phase)
-    - Scroll target for Hero CTA (`.windsurf-extension-section`)
-  - `website/src/components/WindsurfPreview.tsx`:
-    - Interactive mockup of Windsurf extension UI
-    - Kanban-style roadmap with drag & drop
-    - AI Task Generator and PRJCT Control Center
-    - Project Rules management interface
-  - `website/src/components/EarlyAccessForm.tsx`:
-    - GitHub issue-based waitlist signup
-    - Animated with framer-motion
-    - Purple/blue gradient theme
-  - `website/src/pages/Home.tsx`:
-    - Added WindsurfExtension between Features and ClaudeSuperpowers
-    - 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)
-  - Affects ALL commands: /p:done, /p:ship, /p:stuck, /p:idea, /p:now
-  - 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)
-  - Simple file reads for context validation
-  - Works identically in Claude Code and Claude Desktop
-  - No additional costs for users
-
-### Coming Soon
-
-- **Windows Compatibility** - Native Windows support
-  - PowerShell and CMD command execution
-  - Windows path handling (`%USERPROFILE%\.prjct-cli\`)
-  - Windows-specific installation scripts
-  - Cross-platform file operations
-  - Windows Terminal integration
-
-## [0.5.0] - 2025-10-02
-
-### 🚨 BREAKING CHANGES
-
-- **100% Claude-Focused Architecture** - Removed support for all non-Claude environments
-  - ❌ **Removed**: OpenAI Codex support
-  - ❌ **Removed**: Cursor AI support
-  - ❌ **Removed**: Windsurf/Codeium support
-  - ✅ **Supported**: Claude Code (primary)
-  - ✅ **Supported**: Claude Desktop (secondary)
-
-- **Simplified Installation** - Now installs only to `~/.claude/`
-  - Single editor detection (Claude only)
-  - Removed multi-editor selection workflow
-  - Removed editor-specific adapters and formatters
-
-- **Deleted Files**:
-  - `core/agents/codex-agent.js` - OpenAI Codex adapter
-  - `core/agents/terminal-agent.js` - Terminal fallback
-  - `AGENTS.md` - Legacy Codex configuration
-  - `templates/workflows/` - Windsurf workflow templates
-
-- **Rewritten Modules** (breaking API changes):
-  - `command-installer.js` - Now Claude-only (208 lines, was 800+)
-  - `editors-config.js` - Simplified to single editor (160 lines, was 205)
-  - `agent-detector.js` - Claude detection only (183 lines, was 250)
-
-### 🚀 Why This Change? (Built for Claude - Ship Fast, No BS)
-
-**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
-- Just `/p:now` → work → `/p:done` → `/p:ship` → celebrate
-
-**By focusing 100% on Claude, we unlocked superpowers:**
-
-1. **🤖 Dynamic AI Agents**
-   - Auto-generated specialists (PM, Frontend, Backend, UX, QA, Scribe, Security, DevOps, Mobile, Data)
-   - Context-aware activation based on your project stack
-   - Impossible to build with multi-platform support
-
-2. **🔗 Native MCP Integration**
-   - Context7 - Automatic library documentation
-   - Sequential - Deep reasoning for complex problems
-   - Magic - UI component generation from patterns
-   - Playwright - Browser automation and E2E testing
-   - MCP is Claude-native, can't replicate elsewhere
-
-3. **✅ Git Validation**
-   - Last commit as source of truth
-   - Validates completed work against actual changes
-   - Prevents empty task completions
-   - Requires tight Claude integration
-
-4. **💬 Natural Language**
-   - Talk naturally in any language, no command memorization
-   - "I'm done" → `/p:done`, "ship this" → `/p:ship`
-   - Leverages Claude's language understanding
-
-5. **⚡ Technical Benefits**
-   - **50-60% less code** (800+ lines → 228 lines in command-installer alone)
-   - Faster features and bug fixes
-   - Proper testing of everything we support
-   - 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**
-
-**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
-    - Last commit as source of truth for validation
-    - Working directory status monitoring
-    - User claim validation against commit history
-    - Comprehensive git statistics and reporting
-
-  - **AgentGenerator Module** (`core/agent-generator.js`)
-    - Dynamic agent creation based on project analysis
-    - Project-specific context injection into agent templates
-    - Intelligent conditional agent detection
-    - Agent update and synchronization capabilities
-    - Support for both base and conditional agents
-
-  - **Base AI Agents** (Always Generated)
-    - PM (Project Manager) - Task coordination and breakdown
-    - FE (Frontend Engineer) - UI/UX, React, components, state management
-    - BE (Backend Engineer) - APIs, database, SOLID principles
-    - UX (UX Designer) - User experience, accessibility, design systems
-    - QA (QA Engineer) - Testing strategy and automation
-    - Scribe (Documentation) - Technical writing and changelog management
-
-  - **Conditional AI Agents** (Generated Based on Project Stack)
-    - DevOps - Docker, CI/CD, infrastructure (when Docker/CI/CD detected)
-    - Security - OWASP, threat modeling (when web app or auth detected)
-    - Mobile - React Native, Flutter (when mobile frameworks detected)
-    - Data - ML, data pipelines (when ML libraries detected)
-
-  - **Scribe Agent Workflows**
-    - Automatic documentation on `/p:done` completion
-    - Feature documentation on `/p:ship` deployment
-    - Git-based change detection for documentation scope
-    - User confirmation workflow before saving documentation
-    - Task docs saved to `analysis/task-docs/`
-    - Feature docs saved to `analysis/feature-docs/`
-
-- **Enhanced `/p:analyze` Command**
-  - Git repository integration and validation
-  - Last commit information and statistics
-  - Working directory status tracking
-  - Validation baseline for user claims
-  - Conditional agent detection based on stack
-  - Comprehensive project analysis report with git stats
-  - Agent recommendation system
-
-- **Enhanced `/p:init` Command**
-  - Automatic agent generation after project analysis
-  - Git-integrated analysis workflow
-  - Project-specific agent context injection
-  - Smart agent selection based on detected stack
-  - Agents stored in `~/.claude/agents/` directory
-
-- **New `/p:sync` Command**
-  - Re-analyze project for stack changes
-  - Update existing agents with new project context
-  - Add newly required agents based on stack evolution
-  - Remove obsolete agents with user confirmation
-  - 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)
-  - Project-specific naming: `p_agent_[type].md`
-  - Dynamic context injection from project analysis
-  - Limited expertise per agent (focused specialization)
-
-### Technical Details
-
-- **10 Agent Templates** in `templates/agents/`
-  - 6 base templates (always generated)
-  - 4 conditional templates (stack-dependent)
-  - Each template includes project context placeholders
-  - Specialized tools and color coding per agent type
-  - Defined expertise boundaries and trigger keywords
-
-- **Git Integration Features**
-  - Commit validation and claim verification
-  - Working directory change tracking
-  - Unverified work identification
-  - Comprehensive git statistics
-  - Multi-contributor support
-
-## [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
-  - Provides proper workflow context for comprehensive project analysis
-  - 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
-  - Ensures agents follow complete analysis instructions from workflow templates
-
-## [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
-  - Automatically cleans up `~/.prjct-cli/config/installed-editors.json`
-  - 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)"
-  - Allows selecting 0 editors (removes all)
-
-## [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
-  - Smart fusion of markdown files (now.md, next.md, shipped.md, ideas.md)
-  - Chronological merging of memory/context.jsonl entries
-  - Cleans up local `.prjct/` directory, keeping only `prjct.config.json`
-  - 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
-  - Removes blocking behavior that prevented normal usage
-  - 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
-
-## [0.4.7] - 2025-10-02
-
-### Fixed
-
-- **`prjct start` ASCII Art** - Restored beautiful Catppuccin-inspired colors
-  - 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
-- **`prjct start` Display Bug** - Fixed editor names showing as "undefined"
-  - Now correctly displays editor names (Claude Code, Cursor, etc.)
-  - Uses `commandInstaller.editors[key].name` to get proper editor names
-
-## [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)
-  - Interactive prompt to choose which editors to install commands to
-  - Replaces confusing `prjct install` command with clearer naming
-  - Only runs once (blocks if already configured, suggests `prjct setup` to reconfigure)
-
-- **Auto-Initialization** - Commands auto-run `prjct init` when needed
-  - All core commands (now, done, ship, next, idea, recap, stuck, context) check initialization
-  - Shows warning and runs init automatically if project not configured
-  - Zero friction - users don't need to remember to run init first
-  - 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)
-  - `prjct init` → Initialize project (links to global data)
-  - `prjct setup` → Reconfigure editors (replaces old `prjct install`)
-  - `npm update -g prjct-cli` → Auto-updates commands in tracked editors
-
-- **Post-Install Behavior**
-  - Removed auto-installation on npm install (was non-interactive and confusing)
-  - First install shows: `Run: prjct start to get started`
-  - Updates auto-update commands in previously selected editors
-  - Cleaner, more predictable behavior
+- **Read-before-write enforcement for templates** (PRJ-108)
+  - Agent files now preserve user customizations during regeneration
+  - All context files (now.md, next.md, ideas.md, shipped.md) preserve user sections
+  - Added validation and warnings for invalid preserve blocks
+  - Documented preserve markers in global CLAUDE.md template
 
 ### 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/`
-  - `getDaysSinceLastShip()` now reads from global `memory/context.jsonl` instead of local
-  - All commands verify project is initialized before execution
-  - Prevents creation of invalid local `.prjct/` structures
-  - **Fixed post-install.js** - `currentVersion` now declared before use (prevents ReferenceError)
-  - **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
-  - `ensureProjectInit()` - Helper function for auto-initialization
-- **Global Architecture**: All commands now use `pathManager.getGlobalProjectPath(projectId)`
-  - design(), cleanup(), getDaysSinceLastShip() fully migrated
-  - Prevents LOCAL .prjct/ creation
-  - Requires project initialization before command execution
-- **Auto-Init Integration**: now(), done(), ship(), next(), idea(), recap(), stuck(), context() all auto-initialize
-- **Migration Enhancement**: Added ~/Apps to common directories scan
-- **Post-Install Fix**: currentVersion variable properly declared at function start
-
-## [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`
-  - Post-install hook (`scripts/post-install.js`) auto-updates commands after `npm update -g prjct-cli`
-  - **Auto-installation on first install** - Detects AI editors and installs commands automatically
-  - Ensures version consistency across all configured editors (Claude, Cursor, Windsurf, Codex)
-  - No manual reinstallation needed - updates happen automatically
-  - Respects user's original editor choices from initial setup
-
-- **Automatic Cleanup on Uninstall** - Clean uninstallation removes all traces
-  - New `scripts/preuninstall.js` runs before `npm uninstall -g prjct-cli`
-  - Automatically removes commands from all tracked editors
-  - Deletes tracking configuration from `~/.prjct-cli/config/`
-  - Added `uninstallFromEditor()` and `uninstallFromAll()` methods to command installer
-  - Added `deleteConfig()` method to editors config
-  - Prevents orphaned commands when package is uninstalled
-  - Clean exit even if cleanup fails (doesn't block uninstall)
-
-- **Automatic Data Migration** - Seamless upgrade from v0.1.0 to v0.4.4
-  - Post-install hook automatically detects legacy `.prjct/` projects
-  - Migrates data from local structure to new global architecture (`~/.prjct-cli/projects/{id}/`)
-  - Scans common project directories (Projects, Documents, Developer, Code, **Apps**)
-  - Preserves all project data during migration (now, next, shipped, ideas, memory)
-  - Cleans up legacy directories while keeping config for compatibility
-  - No user intervention required - migration happens automatically on update
-  - 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/`
-  - `getDaysSinceLastShip()` now reads from global `memory/context.jsonl` instead of local
-  - All commands verify project is initialized before execution
-  - Prevents creation of invalid local `.prjct/` structures
-  - **Fixed post-install.js** - `currentVersion` now declared before use (prevents ReferenceError)
-  - **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
-  - **Migration**: Automatically detects and migrates legacy projects from v0.1.0
-  - Silent operation with debug mode via `DEBUG=1` environment variable
-  - **Fixed**: currentVersion variable now properly declared at function start
-  - **Enhanced**: Better error handling with debug logging
-- **Pre-Uninstall Hook**: Runs before `npm uninstall -g prjct-cli`
-  - Reads tracking config to find all installed editors
-  - Removes command directories from each editor
-  - Cleans up tracking configuration
-  - Fails gracefully to not block uninstall
-- **Migration System**: Automatic upgrade path from v0.1.0 to v0.4.4
-  - Scans common project directories including **~/Apps** (fast, non-intrusive)
-  - Migrates local `.prjct/` to global `~/.prjct-cli/projects/{id}/`
-  - Preserves all data: core, progress, planning, analysis, memory layers
-  - Cleans legacy directories while keeping compatibility config
-  - Zero data loss, seamless upgrade experience
-- **Global Architecture**: All commands now use `pathManager.getGlobalProjectPath(projectId)`
-  - design(), cleanup(), getDaysSinceLastShip() fully migrated
-  - Prevents LOCAL .prjct/ creation
-  - Requires project initialization before command execution
-
-## [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`
-  - Post-install hook (`scripts/post-install.js`) auto-updates commands after `npm update -g prjct-cli`
-  - **Auto-installation on first install** - Detects AI editors and installs commands automatically
-  - Ensures version consistency across all configured editors (Claude, Cursor, Windsurf, Codex)
-  - No manual reinstallation needed - updates happen automatically
-  - Respects user's original editor choices from initial setup
-
-- **Automatic Cleanup on Uninstall** - Clean uninstallation removes all traces
-  - New `scripts/preuninstall.js` runs before `npm uninstall -g prjct-cli`
-  - Automatically removes commands from all tracked editors
-  - Deletes tracking configuration from `~/.prjct-cli/config/`
-  - Added `uninstallFromEditor()` and `uninstallFromAll()` methods to command installer
-  - Added `deleteConfig()` method to editors config
-  - Prevents orphaned commands when package is uninstalled
-  - Clean exit even if cleanup fails (doesn't block uninstall)
-
-- **GitHub Packages Support** - Dual registry publication for better reliability
-  - Package now published to both npm and GitHub Packages automatically
-  - GitHub Actions workflow updated to publish to both registries in parallel
-  - Added comprehensive GitHub Packages documentation (`docs/GITHUB_PACKAGES.md`)
-  - Includes `.npmrc.example` for easy local configuration
-  - Provides fallback option if npm registry is unavailable
-  - 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)
-  - Clear instructions for both installation methods
-
-- **Command Installer Improvements**
-  - `installToSelected()` now always saves editor config (removed force-update restriction)
-  - Better tracking ensures updates work correctly even for force updates
-  - 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
-  - Auto-detects and installs to all AI editors on first install
-  - Auto-updates commands when version changes
-- **Pre-Uninstall Hook**:
-  - Runs only for global uninstallations
-  - Removes slash commands from `~/.claude/`, `~/.cursor/`, `~/.windsurf/`
-  - Removes AGENTS.md from `~/.codex/` if present
-  - Deletes tracking configuration
-- **Version Detection**: Compares current version with last installed version
-- **Force Update**: Automatically updates commands when version changes
-- **Parallel Publication**: npm and GitHub Packages jobs run simultaneously for faster releases
-
-## [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.)
-  - No longer throws "no such file or directory" error for normal projects
-  - Maintains full functionality for prjct-cli development projects
-
-- **Website Build Process** - Improved build script and component imports
-  - Fixed Badge component import casing (badge → Badge)
-  - Removed obsolete install.sh and setup.sh copying from build script
-  - Cleaner and faster website builds
-
-## [0.4.1] - 2025-10-01
+- **Codebase cleanup** - Resolved all 22 biome lint warnings
+  - Fixed forEach returning values (converted to for...of)
+  - Fixed unused type exports (exported or removed)
+  - Fixed implicit any types
+  - Fixed template literal usage
+  - Fixed void return type issues
 
-### 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
-  - Formatted notification with update command
-  - Shows only once per session to avoid notification spam
-  - Respects 24-hour cache to minimize npm registry requests
-
-- **Automated npm Publication** - GitHub Actions workflow for automatic npm publishing
-  - 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
-  - Cleaner package with optimized file inclusion
-  - Reduced package size: 104.6 KB (71 files)
+## [0.48.1] - 2026-01-30
 
-### Fixed
-
-- **Package Structure** - Improved npm package configuration
-  - Added `files` field to control package contents
-  - Created `.npmignore` for development file exclusion
-  - Proper global data directory separation (`~/.prjct-cli/` for data only)
-  - Fixed CI/CD tests to verify CLI functionality instead of individual modules
+### Improved
 
-### Technical Details
+- **Complete and improve help text documentation** (PRJ-133)
+  - New structured help system with `prjct help <command>` support
+  - Per-command help with usage, parameters, and features
+  - Commands grouped by category with `prjct help commands`
+  - Clean visual formatting with Quick Start, Terminal Commands, AI Agent Commands sections
 
-- **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/`)
-- **GitHub Actions**: `.github/workflows/publish-npm.yml` for automated npm publication
 
-## [0.4.0] - 2025-10-01
+## [0.48.0] - 2026-01-29
 
 ### 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 → Bun test, Vue → Bun test, Angular → Jest)
-  - **Installation Tracking**: Every tool installation becomes a visible, tracked workflow task
-  - **Interactive Prompts**: Never auto-skips steps - always asks user (install/skip/continue/pause)
-  - **Capability Detection**: Automatically detects design systems, test frameworks, and documentation tools
-  - **Auto-Configuration**: Installed tools are automatically configured with framework-specific settings
-  - **Workflow Types**: UI, API, Bug Fix, Refactor, and Feature workflows with specialized agent assignments
-
-- **New Core Modules**:
-  - `core/workflow-engine.js`: Orchestrates adaptive workflows with step management
-  - `core/workflow-rules.js`: Defines workflow pipelines by task type
-  - `core/workflow-prompts.js`: Interactive prompting engine with stack detection
-  - `core/capability-installer.js`: Handles tool installation, configuration, and verification
-  - `core/project-capabilities.js`: Detects existing project capabilities (design/test/docs)
-
-- **New Commands**:
-  - `workflowRespond(choice)`: Handle user responses to workflow prompts
-  - Enhanced `done()`: Checks for prompts, advances workflows intelligently
-  - 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
-- **Step Tracking**: All workflow steps now tracked with status, duration, and metadata
-- **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 → Bun test + Testing Library
-  - Vue → Bun test + @vue/test-utils
-  - Angular → Jest + @types/jest
-- **Auto-Configuration**:
-  - Creates config files for the selected tooling (e.g., jest.config.js, jsdoc.json)
-  - Updates package.json scripts
-  - Verifies installation success
-- **Duration Tracking**: Installation tasks show completion time (e.g., "1.2 min")
-
-## [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
-  - prompts provides simpler API with native CommonJS support
-  - Reduced package count from 68 to 40 dependencies
-  - Fixed "inquirer.prompt is not a function" and "createPromptModule is not a function" errors
-  - Interactive UI now works reliably across all Node.js versions
-  - Updated `scripts/interactive-install.js` and `core/command-installer.js` to use prompts
-
-## [0.3.1] - 2025-10-01
-
-### Fixed
+- **Workflow hooks via natural language** (PRJ-137)
+  - Configure hooks with `p. workflow "antes de ship corre los tests"`
+  - Supports before/after hooks for task, done, ship, sync commands
+  - Three scopes: permanent (persisted), session, one-time
+  - Uses existing memory system for storage
+  - No JSON config needed - just talk to the LLM
 
-- **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`
-  - Added comprehensive documentation in `tests/INSTALL_PATH_FIX.md`
-  - Thanks to [@danrocha](https://github.com/danrocha) for reporting the issue
 
-## [0.3.0] - 2025-09-30
+## [0.47.0] - 2026-01-29
 
 ### 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
-  - Auto-execution during `/p:init` when cloning repos with existing code
-  - Detects implemented commands by scanning `bin/prjct` and `core/commands.js`
-  - Detects completed features from:
-    - Git commit history (feat:, ship:, feature: prefixes)
-    - Package.json dependencies (major frameworks and libraries)
-    - Directory structure (auth/, api/, dashboard/, etc.)
-  - Automatically updates `next.md` by marking completed tasks
-  - Automatically adds detected features to `shipped.md`
-  - Generates detailed analysis reports in `analysis/repo-summary.md`
-  - Prevents duplicate work when multiple developers work on same codebase
-  - Provides real project status visibility across team members
-  - Zero-configuration sync for better collaboration without cloud storage
+- **Subtask progress dashboard with domain-specific colors** (PRJ-138)
+  - Visual progress table showing subtask status
+  - Domain-specific colors: frontend (cyan), backend (green), database (yellow), testing (magenta), devops (blue)
+  - Shows current subtask indicator and completion status
+  - Displays estimated vs actual time tracking
 
-- **Interactive Editor Selection** - Choose which AI editors to install commands to
-  - Interactive checkbox UI during `prjct install` and `prjct init`
-  - Detects all installed editors (Claude Code, Cursor, Codex, Windsurf)
-  - Shows installation paths for each detected editor
-  - Allows users to select only the editors they use
-  - `--no-interactive` flag to install to all detected editors without prompts
-  - Optimizes installation by avoiding unnecessary editor installations
 
-### Changed
-
-- **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
-
-## [0.2.1] - 2025-09-30
+## [0.46.0] - 2026-01-29
 
 ### 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
-  - Template-based command system in `~/.prjct-cli/templates/commands/`
-  - Commands automatically installed during `prjct init`
-  - Support for `--force`, `--editor`, and `--create-templates` flags
-  - Cross-editor data synchronization through global architecture
-  - Installation verification and detailed reports
-
-- **Global Migration System** - Automatic migration for all projects on user's machine
-  - `prjct migrate-all` command to find and migrate all legacy projects
-  - Scans common project directories: `~/Projects`, `~/Documents`, `~/Developer`, etc.
-  - Optional `--deep-scan` flag to scan entire home directory
-  - Optional `--remove-legacy` flag to clean up old `.prjct/` directories after migration
-  - Optional `--dry-run` flag to preview changes without making them
-  - Progress tracking with real-time updates during migration
-  - Comprehensive summary report with statistics and results
-
-- **Automated Project Discovery**
-  - `findAllProjects()` method to recursively search for `.prjct/` directories
-  - Intelligent directory skipping (node_modules, .git, dist, build, etc.)
-  - Configurable recursion depth for safety
-  - Handles permission errors gracefully
-
-- **Bulk Migration Support**
-  - `migrateAll()` method to process multiple projects in batch
-  - Per-project validation and error handling
-  - Continues on individual project failures
-  - Detailed error reporting for failed migrations
-  - 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
-  - Enhanced command-installer.js with editor-specific logic
-  - Standardized command format across all supported editors
-
-- **Repository Structure Reorganization**
-  - Moved source code to `src/` directory
-  - Moved scripts to `scripts/` directory
-  - Moved configuration to `.config/` directory
-  - Renamed `lp/` to `website/` for clarity
-  - Renamed `test/` to `tests/` for consistency
-  - Removed `.serena/` integration (unused)
-  - Cleaned up backup files and duplicates
-  - Added `templates/commands/` for command distribution
+- **Preserve user customizations during sync** (PRJ-115)
+  - Users can mark sections with `<!-- prjct:preserve -->` markers
+  - Preserved content survives regeneration
+  - Works in CLAUDE.md and other context files
 
-- **Documentation Updates**
-  - Updated CONTRIBUTING.md with new repository structure
-  - Added detailed migration documentation
-  - Documented v0.2.1 global structure and multi-editor support
-  - Added automatic migration instructions
-  - Updated README.md with Cursor and Codeium support
-  - Enhanced MIGRATION.md with command installation instructions
 
-- **CLI Interface**
-  - Added `install` command to CLI entry point for manual command installation
-  - Added `migrate-all` command to CLI entry point
-  - Added help text for new migration and installation commands
-  - Improved command error messages
-  - Enhanced init command with automatic editor installation
+## [0.45.5] - 2026-01-28
 
 ### Fixed
 
-- Added missing `getGlobalBasePath()` method to path-manager.js
-- Improved error handling in migration system
-- Fixed paths in GitHub Actions workflow after reorganization
-- Updated Prettier configuration paths after reorganization
-
-## [0.2.0] - 2025-09-30
-
-### 🚨 BREAKING CHANGES
-
-**⚠️ IMPORTANT**: This is a DATA RELOCATION, not deletion. ALL your data is preserved and moved to a better location.
-
-- **Data Storage Relocation**: All project data moved from `.prjct/` to `~/.prjct-cli/projects/[project-id]/`
-  - ✅ 100% data preservation - every file, log, and timestamp
-  - ✅ Automatic migration with validation
-  - ✅ Reversible process (`.prjct/` kept as backup by default)
-
-- **Migration Required**: Projects from v0.1.0 need one-time migration
-  - Zero data loss guarantee
-  - Automatic integrity validation
-  - Simple process via installer or `/p:migrate`
-
-- **Collaboration-Ready Architecture**: Designed for teams WITHOUT exposing personal data
-  - `.prjct/prjct.config.json` in project (safe to commit)
-  - Personal logs stay in `~/.prjct-cli/` (never committed)
-  - Author tracking enables future collaboration features
-  - Non-intrusive: Your velocity and notes stay private
-
-- **Author Tracking**: All operations now include author information
-  - Prepares for multi-user collaboration
-  - Tracks who did what without exposing personal metrics
-  - 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
-  - Maintains data locally while keeping projects clean
-  - Layered directory structure: core, progress, planning, analysis, memory
-
-- **Author Detection & Tracking**
-  - Multi-source author detection (GitHub CLI, git config)
-  - Author information included in all memory logs
-  - Automatic GitHub username detection via `gh api user`
-  - Fallback to git config for name and email
-  - Preparation for multi-user collaboration features
-
-- **Project Configuration System**
-  - New `.prjct/prjct.config.json` file in project
-  - Tracks project ID, data location, and author info
-  - Manages synchronization timestamps
-  - Version tracking for future migrations
-
-- **Automatic Migration System**
-  - Detects v0.1.0 projects automatically
-  - Migrates data to new global structure
-  - Preserves all existing data and history
-  - Creates configuration file automatically
-  - Validates migration integrity
-  - Optional legacy directory cleanup
-
-- **New Core Modules**
-  - `core/path-manager.js`: Manages local and global paths with hash-based project IDs
-  - `core/config-manager.js`: Handles prjct.config.json operations
-  - `core/author-detector.js`: Multi-method author detection system
-  - `core/migrator.js`: Complete migration logic and validation
-
-- **Enhanced Installer Visual Design** (from previous unreleased)
-  - New ASCII art logo for prjct/cli branding
-  - Improved visual hierarchy with better spacing and borders
-  - Professional appearance similar to modern CLI tools
-
-- **Version Management System** (from previous unreleased)
-  - Automatic version checking during installation
-  - Smart update prompts only when new versions are available
-  - Force reinstall option with `--force` flag
-
-- **Installation Options** (from previous unreleased)
-  - `--force`, `-y`, `--silent`, `--dev`, `--help` flags
-  - 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)
-- **Initialization**: Creates global structure and config file
-- **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
-/p:init
-
-# Or run explicit migration
-/p:migrate
-```
-
-### 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
-- ✅ Future collaboration features enabled
-- ✅ 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
+- **Silent memory application** (PRJ-103)
+  - Memory decisions applied without verbose output
+  - Cleaner sync experience
 
-- Arithmetic operation syntax error in command counting (from previous unreleased)
-- Version detection for existing installations (from previous unreleased)
 
-## [0.1.0] - 2024-01-XX
+## [0.45.0] - 2026-01-28
 
 ### Added
 
-- Initial release of prjct-cli
-- 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
+- Initial public release
+- Core workflow: sync, task, done, ship
+- Domain agents: frontend, backend, database, testing, devops
+- Linear integration via MCP
+- Context layer for Claude Code and Gemini CLI