prjct-cli 0.8.6 → 0.8.8

package/templates/commands/build.md

@@ -1,6 +1,7 @@
 ---
-allowed-tools: [Read, Write]
+allowed-tools: [Read, Write, GetTimestamp]
 description: 'Start task with agent assignment'
+timestamp-rule: 'CRITICAL - ALWAYS use GetTimestamp() tool for id and started fields. NEVER generate timestamps manually.'
 ---
 
 # /p:build
@@ -16,18 +17,20 @@ description: 'Start task with agent assignment'
 2. Detect: `TaskSchema.detectAgent(task)` + complexity
 3. Get: GitHub dev from `git config user.name` + remote
 4. Create: task metadata with agent, complexity, estimate
-5. Write: `core/now.md` with frontmatter
+5. Write: `core/now.md` with frontmatter (use GetTimestamp() for id and started)
 
 ## Frontmatter
 
+**Use GetTimestamp() tool for both id and started fields:**
+
 ```yaml
 ---
-id: task-{timestamp}
+id: task-{GetTimestamp()}
 agent: {detected_agent}
 dev: @{github_username}
 complexity: {trivial|simple|moderate|complex|epic}
 estimated: {time_range}
-started: {iso_timestamp}
+started: {GetTimestamp()}
 ---
 {task_description}
 ```

package/templates/commands/feature.md

@@ -1,6 +1,7 @@
 ---
-allowed-tools: [Read, Write, Bash]
+allowed-tools: [Read, Write, Bash, GetTimestamp, GetDate]
 description: 'Value analysis + roadmap + task breakdown + auto-start'
+timestamp-rule: 'CRITICAL - ALWAYS use GetTimestamp() and GetDate() tools for ALL timestamps and dates. NEVER generate dates manually. LLM does not know current date.'
 ---
 
 # /p:feature
@@ -21,128 +22,16 @@ description: 'Value analysis + roadmap + task breakdown + auto-start'
 
 ## Interactive Mode (No Parameters)
 
-When executed without parameters, `/p:feature` enters interactive mode with quick start templates.
+When executed without parameters, show 6 category templates:
 
-### Response: Interactive Mode
+**1. 🎨 UI/UX**: dark mode, redesign, responsiveness, animations
+**2. ⚡ Performance**: load time, memory leaks, code splitting, API speed
+**3. 🔐 Features**: authentication, payments, admin dashboard, notifications
+**4. 🧪 Quality**: unit tests, E2E testing, error tracking, coverage
+**5. 🐛 Bug Fixes**: refactoring, memory leaks, deprecated code, error handling
+**6. 📚 Docs**: API docs, onboarding, developer setup, examples
 
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-💡 WHAT FEATURE DO YOU WANT TO ADD?
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-You can describe freely or choose a template:
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📋 QUICK START TEMPLATES:
-
-1. 🎨 UI/UX Improvements
-   Examples:
-   • "add dark mode"
-   • "redesign dashboard"
-   • "improve mobile responsiveness"
-   • "add animations and transitions"
-
-2. ⚡ Performance Optimization
-   Examples:
-   • "optimize page load time"
-   • "reduce memory leaks"
-   • "implement code splitting"
-   • "improve API response time"
-
-3. 🔐 Features & Functionality
-   Examples:
-   • "implement user authentication"
-   • "add payment system"
-   • "create admin dashboard"
-   • "implement real-time notifications"
-
-4. 🧪 Quality & Testing
-   Examples:
-   • "add unit tests"
-   • "implement E2E testing"
-   • "add error tracking"
-   • "improve code coverage"
-
-5. 🐛 Bug Fixes & Refactoring
-   Examples:
-   • "refactor authentication flow"
-   • "fix memory leaks"
-   • "clean up deprecated code"
-   • "improve error handling"
-
-6. 📚 Documentation & DevX
-   Examples:
-   • "add API documentation"
-   • "create onboarding guide"
-   • "improve developer setup"
-   • "add code examples"
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💬 HOW TO USE:
-
-Choose a number (1-6) or just describe what you want:
-  "I want to add authentication"
-  "Need to optimize performance"
-  "3" (shows feature examples)
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-What feature do you want to add?
-```
-
-### Template Category Deep Dive
-
-If user selects a category number (1-6):
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-{CATEGORY_ICON} {CATEGORY_NAME}
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Common features in this category:
-
-{template_options_with_descriptions}
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Choose one or describe your own:
-```
-
-**Example for Performance (Category 2):**
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-⚡ PERFORMANCE OPTIMIZATION
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Common features in this category:
-
-1. "Optimize page load time"
-   → Bundle analysis, lazy loading, CDN setup
-   Impact: HIGH | Effort: 6-8h
-
-2. "Reduce memory leaks"
-   → Profiling, cleanup, optimization
-   Impact: HIGH | Effort: 4-6h
-
-3. "Implement code splitting"
-   → Route-based, component-based splitting
-   Impact: MEDIUM | Effort: 3-4h
-
-4. "Improve API response time"
-   → Caching, query optimization, CDN
-   Impact: HIGH | Effort: 6-10h
-
-5. "Optimize rendering performance"
-   → React.memo, useMemo, virtualization
-   Impact: MEDIUM | Effort: 4-6h
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Choose a number or describe your specific need:
-```
+User can: choose category number OR describe freely
 
 ## Flow
 
@@ -158,22 +47,26 @@ Choose a number or describe your specific need:
 
 Append to `planning/sessions/{YYYY-MM}/{YYYY-MM-DD}.jsonl`:
 
+**Use GetTimestamp() and GetDate() tools to get real system time:**
+
 ```jsonl
-{"ts":"2025-10-04T14:30:00Z","type":"feature_add","name":"{feature}","tasks":{N},"impact":"{high/med/low}","effort":"{Xh}","status":"queued"}
+{"ts":"{GetTimestamp()}","type":"feature_add","name":"{feature}","tasks":{N},"impact":"{high/med/low}","effort":"{Xh}","status":"queued"}
 ```
 
 ## Index Update
 
 Append to `planning/roadmap.md` (keep only last 30 days):
 
+**Use GetDate() tool for current date:**
+
 ```markdown
 ## Queued
-- [ ] {feature_name} ({N} tasks, {Xh} estimated) - Added 2025-10-04
+- [ ] {feature_name} ({N} tasks, {Xh} estimated) - Added {GetDate()}
 ```
 
-If roadmap.md > 30 days old entries, archive them to `planning/archive/roadmap-{YYYY-MM}.md`
+If roadmap.md > 30 days old entries, archive to `planning/archive/roadmap-{YYYY-MM}.md`
 
-## Value Analysis
+## Value Analysis Format
 
 ```
 Feature: {description}
@@ -185,20 +78,6 @@ Value Analysis:
 • Recommendation: {do_now/defer/needs_X_first}
 ```
 
-## Task Breakdown
-
-```
-Roadmap: {feature_name}
-
-Tasks:
-1. [ ] {task_1}
-2. [ ] {task_2}
-3. [ ] {task_3}
-... (as many as needed)
-
-Estimated: {total_hours}h
-```
-
 ## Response
 
 ```
@@ -213,27 +92,7 @@ Tasks:
 2. {task_2}
 ...
 
-¿Empezamos con tarea 1?
+Ready to start with task 1?
 
 /p:done (when task complete) | /p:ship (when feature complete)
 ```
-
-## Example
-
-```
-User: p. feature "agregar unit testing"
-
-Claude analyzes:
-- Impact: HIGH (quality improvement)
-- Effort: 8h
-- Timing: NOW (before shipping more features)
-
-Tasks created:
-1. Setup Jest/Vitest configuration
-2. Write tests for core utilities
-3. Write tests for components
-4. Add CI/CD test runner
-5. Update docs with testing guide
-
-"¿Empezamos con tarea 1: Setup Jest/Vitest?"
-```

package/templates/commands/help.md

@@ -7,7 +7,7 @@ description: 'Interactive contextual guide - helps users based on their current
 
 ## Purpose
 
-Contextual help system that analyzes project state and provides relevant guidance. Different responses based on user's current situation.
+Contextual help that analyzes project state and provides relevant guidance based on user's current situation.
 
 ## Flow
 
@@ -16,333 +16,75 @@ Contextual help system that analyzes project state and provides relevant guidanc
 3. **Provide relevant help**: Suggestions based on context
 4. **Show examples**: Concrete examples for their situation
 
-## Response Based on Context
+## Context-Based Responses
 
-### Context 1: Project Not Initialized
+### 1. Not Initialized
+→ Show welcome, explain `/p:init` vs `/p:init "idea"` (ARCHITECT MODE)
 
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-👋 WELCOME TO PRJCT!
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Ship Fast. No BS.
+### 2. Empty Queue + No Active Task
+→ Suggest: `/p:feature "{desc}"`, `/p:analyze`, `/p:roadmap`
+→ Emphasize: Can talk naturally, no need to memorize commands
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-🚀 FIRST STEP: Initialize
+### 3. Has Active Task
+→ Show: current task, duration, started time
+→ Suggest: `/p:done` (finished?), `/p:stuck "{issue}"` (blocked?), `/p:next` (see queue?)
+→ Emphasize: Focus on one task → Ship faster
 
-For existing project:
-  /p:init
+### 4. Has Queue, No Active Task
+→ Suggest: `/p:next` (see top 5), `/p:build 1` (start #1), `/p:build "{name}"` (start specific)
+→ Show: queue size, last ship time
+→ Tip: `/p:suggest` for personalized recommendations
 
-For new blank project:
-  /p:init "your idea here"
-  → Activates ARCHITECT MODE
-  → Conversational setup
-  → Tech stack recommendations
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
+### 5. Lost/Confused
+→ Show 5 scenarios with examples:
+  - Want to build? → `/p:feature "{desc}"`
+  - Something broken? → `/p:bug "{desc}"`
+  - Don't know what to do? → `/p:suggest`
+  - See progress? → `/p:status` or `/p:recap`
+  - Need guidance? → `/p:ask "{what you want}"`
+→ Emphasize: Natural language works (English & Spanish)
 
-After init, I'll help you:
-  • Break down features into tasks
-  • Track your progress
-  • Ship faster
-
-Let's start! 🎉
-```
-
-### Context 2: Initialized, No Active Task, Empty Queue
+## Response Format
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎯 WHAT DO YOU WANT TO DO?
+🎯 HELP - {CONTEXT_TITLE}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 📊 Your status:
-  • Project: initialized ✅
-  • Active task: none
-  • Queue: empty
-  • Ready to work!
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💡 RECOMMENDED NEXT STEPS:
-
-1. 🚀 Add a feature
-   Tell me what you want to build:
-   → /p:feature "add dark mode"
-   → /p:feature "implement auth"
-   → /p:feature "optimize performance"
-
-   I'll analyze value, break it into tasks, and start working!
-
-2. 🔍 Analyze your project
-   → /p:analyze
-   Find TODOs, improvements, and opportunities
-
-3. 📋 See your roadmap
-   → /p:roadmap
-   View planned features and progress
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💬 TALK NATURALLY:
-
-You can just tell me:
-  "I want to add authentication"
-  "Help me optimize the app"
-  "What should I do?"
-
-I understand! No need to memorize commands.
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-🆘 NEED MORE HELP?
-
-→ /p:ask "what you want to do"
-  (I'll guide you step by step)
-
-→ /p:suggest
-  (I'll analyze and recommend actions)
-```
-
-### Context 3: Initialized, Has Active Task
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎯 HELP - CURRENT STATUS
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📊 Your status:
-  • Working on: "{current_task}"
-  • Started: {time_ago}
-  • Queue: {N} tasks waiting
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💡 WHAT YOU CAN DO:
-
-1. ✅ Finished current task?
-   → /p:done
-   Marks complete, moves to next automatically
-
-2. ❓ Stuck or need help?
-   → /p:stuck "{what's blocking you}"
-   I'll help troubleshoot
-
-3. 📊 See what's next?
-   → /p:next
-   View your priority queue
-
-4. 🎯 Check progress?
-   → /p:status (visual dashboard)
-   → /p:recap (detailed overview)
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💬 OR JUST TELL ME:
-
-  "I'm done"
-  "I'm stuck with X"
-  "What's next?"
-  "Show me my progress"
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-⏱️  ACTIVE TASK INFO:
-
-Task: {current_task}
-Duration: {duration}
-Started: {timestamp}
-
-Focus on one task at a time → Ship faster!
-```
-
-### Context 4: Initialized, No Active Task, Has Queue
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎯 HELP - READY TO WORK!
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-📊 Your status:
-  • Active task: none
-  • Queue: {N} tasks ready
-  • Last ship: {time_ago}
+  • {relevant_state_info}
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 💡 RECOMMENDED ACTIONS:
 
-1. ⚡ Start working (RECOMMENDED)
-   → /p:next
-   See your top 5 priority tasks
-
-   → /p:build 1
-   Start task #1 immediately
-
-   → /p:build "task name"
-   Start specific task
-
-2. 📊 Check your progress
-   → /p:status (visual dashboard)
-   → /p:recap (detailed overview)
+1. {action_1}
+   → {command_or_natural_language}
 
-3. 💡 Add new feature
-   → /p:feature "{description}"
-   Analyze, break down, and start
+2. {action_2}
+   → {command_or_natural_language}
 
-4. 🐛 Report a bug
-   → /p:bug "{description}"
-   Auto-prioritized and queued
+3. {action_3}
+   → {command_or_natural_language}
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 💬 OR JUST SAY:
-
-  "Show me what's next"
-  "Start task 1"
-  "I want to work on X"
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💡 TIP:
-
-You have {N} tasks waiting!
-→ /p:suggest for personalized recommendations
-```
-
-### Context 5: Lost/Confused
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🆘 HOW CAN I HELP?
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-No worries! Let me guide you.
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-🎯 CHOOSE YOUR SCENARIO:
-
-1. 💡 "I want to build something new"
-   → /p:feature "{what you want to build}"
-
-   Examples:
-   • /p:feature "add user authentication"
-   • /p:feature "improve performance"
-   • /p:feature "redesign homepage"
-
-2. 🐛 "Something is broken"
-   → /p:bug "{description}"
-
-   Example:
-   • /p:bug "login button not working"
-
-3. ❓ "I don't know what to do"
-   → /p:suggest
-   I'll analyze your project and recommend
-
-4. 📊 "I want to see my progress"
-   → /p:status (visual)
-   → /p:recap (detailed)
-
-5. 🤔 "I need to understand something"
-   → /p:ask "{what you want to do}"
-
-   I'll translate your intent into actions!
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💬 REMEMBER:
-
-You can talk naturally! Just tell me what you want:
-
-  "I want to add dark mode"
-  "Help me fix this bug"
-  "What should I work on?"
-  "I'm stuck with X"
-
-I understand both:
-  • Natural language ✅
-  • Commands ✅
-  • English & Spanish ✅
+  "{natural_example_1}"
+  "{natural_example_2}"
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-🚀 PRJCT PHILOSOPHY:
-
-Ship Fast. No BS.
-
-  • One task at a time
-  • Track progress automatically
-  • Celebrate every ship
-  • No ceremonies, no overhead
-
-Just build and ship! 🎉
+📚 CORE COMMANDS:
+Planning: /p:feature, /p:roadmap, /p:bug
+Working: /p:next, /p:build, /p:done
+Shipping: /p:ship
+Progress: /p:status, /p:recap
+Help: /p:ask, /p:suggest, /p:stuck
 ```
 
-## Core Commands Reference
-
-Always include at the end of contextual help:
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📚 CORE COMMANDS (if you prefer)
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Planning:
-  /p:feature "{desc}"  → Add feature with roadmap
-  /p:roadmap          → View strategic plan
-  /p:bug "{desc}"     → Report and track bug
-
-Working:
-  /p:next             → See priority queue
-  /p:build {1-5}      → Start task
-  /p:now              → Show current task
-  /p:done             → Complete task
-
-Shipping:
-  /p:ship "{name}"    → Commit, push, celebrate
-
-Progress:
-  /p:status           → Visual dashboard
-  /p:recap            → Detailed overview
-
-Help:
-  /p:ask "{intent}"   → Intent → Action guide
-  /p:suggest          → Smart recommendations
-  /p:stuck "{issue}"  → Get help
-
-Setup:
-  /p:init             → Initialize project
-  /p:analyze          → Deep analysis
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-But remember: You can just talk naturally! 💬
-```
-
-## Key Principles
-
-1. **Context-aware**: Different help based on state
-2. **Actionable**: Always show what to do next
-3. **Examples**: Concrete examples, not abstract
-4. **Encouraging**: Positive, helpful tone
-5. **Bilingual**: Support English and Spanish
-6. **No jargon**: Simple, clear language
-7. **Progressive**: Start simple, show depth if needed
-
 ## Validation
 
 - **Optional**: Works before project initialized
-- **Adaptive**: Response changes based on state
 - **Read-only**: Never modifies files
-
-## Success Criteria
-
-After using `/p:help`, user should:
-- ✅ Know exactly what to do next
-- ✅ Understand they can talk naturally
-- ✅ Feel confident to proceed
-- ✅ Have concrete commands to try
-- ✅ Not feel overwhelmed
+- **Adaptive**: Response changes based on state

package/templates/commands/idea.md

@@ -1,6 +1,7 @@
 ---
-allowed-tools: [Write]
+allowed-tools: [Write, GetTimestamp, GetDate]
 description: 'Quick idea capture'
+timestamp-rule: 'CRITICAL - ALWAYS use GetTimestamp() tool for timestamps. NEVER generate timestamps manually. LLM does not know current date/time.'
 ---
 
 # /p:idea
@@ -13,15 +14,17 @@ description: 'Quick idea capture'
 
 ## Flow
 
-1. **Append to session**: `planning/sessions/{YYYY-MM}/{YYYY-MM-DD}.jsonl`
-2. **Update index**: Append to `planning/ideas.md` (keep only last 30 days)
+1. **Append to session**: `planning/sessions/{YYYY-MM}/{YYYY-MM-DD}.jsonl` (use GetTimestamp())
+2. **Update index**: Append to `planning/ideas.md` (keep only last 30 days, use GetDate())
 3. If actionable → add to `core/next.md`
 4. **Archive old**: If ideas.md > 30 days, move to `planning/archive/ideas-{YYYY-MM}.md`
 
 ## Session Log Format
 
+**Use GetTimestamp() tool for real system time:**
+
 ```jsonl
-{"ts":"2025-10-04T16:00:00Z","type":"idea_add","idea":"{text}","actionable":{true/false},"priority":"{high/med/low}"}
+{"ts":"{GetTimestamp()}","type":"idea_add","idea":"{text}","actionable":{true/false},"priority":"{high/med/low}"}
 ```
 
 ## Response