prjct-cli 0.8.4 → 0.8.8

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

package/templates/commands/init.md

@@ -31,7 +31,7 @@ description: 'Initialize prjct project (with architect mode for blank projects)'
 6. Create: directory structure + base files
 7. Generate: initial roadmap
 8. Generate: agents
-9. Ask: "¿Empezamos con la primera feature?"
+9. Ask: "Ready to start with the first feature?"
 
 ## Directory Structure
 
@@ -74,97 +74,23 @@ description: 'Initialize prjct project (with architect mode for blank projects)'
 🎯 WHAT DO YOU WANT TO DO FIRST?
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-Choose your path:
+5 clear paths:
+1. 🚀 Add feature → /p:feature "{desc}"
+2. 🐛 Fix bug → /p:bug "{desc}"
+3. 🔍 Analyze deeper → /p:analyze
+4. 📊 See status → /p:status or /p:recap
+5. 💡 Not sure? → /p:suggest or /p:help
 
-1. 🚀 Add a new feature
-   Tell me what you want to build!
-
-   Examples:
-   • "add user authentication"
-   • "implement dark mode"
-   • "optimize performance"
-
-   → /p:feature "{description}"
-
-2. 🐛 Fix a bug
-   Describe what's broken
-
-   Example:
-   • "login button not working"
-
-   → /p:bug "{description}"
-
-3. 🔍 Analyze deeper
-   Discover TODOs and improvements
-
-   → /p:analyze
-
-4. 📊 See current status
-   View what's in your project
-
-   → /p:status (visual dashboard)
-   → /p:recap (detailed overview)
-
-5. 💡 Not sure yet?
-   Get personalized suggestions
-
-   → /p:suggest
-   → /p:help
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💬 OR JUST TELL ME:
-
-You can talk naturally:
-  "I want to add authentication"
-  "Help me fix this performance issue"
-  "What should I do?"
-
-I understand! No need to memorize commands.
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
+💬 OR JUST TELL ME: "I want to add authentication" / "What should I do?"
 
 Let's ship something! 🚀
 ```
 
 ## Response: Blank Project
 
-```
-✅ prjct initialized!
-
-📐 ARCHITECT MODE ACTIVATED
-
-Your idea: "{idea}"
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-🎨 TECH STACK RECOMMENDATIONS:
-
-Based on your idea, I recommend:
-
-  ⭐ Option 1: Next.js + TypeScript + Tailwind
-     → Best for: Full-stack apps, SEO, modern UI
-     → Why: Fast, scalable, great DX
-
-  Option 2: React + Vite + shadcn/ui
-     → Best for: SPAs, rapid prototyping
-     → Why: Lightweight, flexible
-
-  Option 3: Vue 3 + Nuxt
-     → Best for: Progressive apps, content sites
-     → Why: Easy learning curve, performant
-
-  Custom: Tell me your preference
-     → Any stack works with prjct!
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Which option works for you? (1, 2, 3, or describe your choice)
-
-[After user confirms:]
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
+After ARCHITECT MODE activates and user confirms stack:
 
+```
 ✅ Structure created!
 
 📁 Project: {path}
@@ -176,35 +102,12 @@ Which option works for you? (1, 2, 3, or describe your choice)
 🎯 WHAT'S NEXT?
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-Your roadmap is ready! You can:
-
-1. 🚀 Start with first feature (RECOMMENDED)
-   → /p:feature "{first_feature}"
-   I'll break it down and we'll start building
-
-2. 📊 See your roadmap
-   → /p:roadmap
-   View all planned features
-
-3. 🔍 Review project structure
-   → /p:recap
-   See what was created
-
-4. 💡 Modify the plan
-   Just tell me:
-   "I also want to add {feature}"
-   "Let's do {different_feature} first"
+1. 🚀 Start first feature (RECOMMENDED) → /p:feature "{first_feature}"
+2. 📊 See roadmap → /p:roadmap
+3. 🔍 Review structure → /p:recap
+4. 💡 Modify plan → Just tell me
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💬 REMEMBER:
-
-You can talk naturally! Just tell me what you want:
-  "Start with authentication"
-  "Show me the roadmap"
-  "I want to add another feature"
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
+💬 REMEMBER: Talk naturally! "Start with auth" / "Show roadmap" / "Add another feature"
 
 Ready to start building? 🚀
 ```