prjct-cli 0.8.6 → 0.9.1

package/templates/commands/help.md

@@ -1,348 +1,61 @@
 ---
 allowed-tools: [Read]
-description: 'Interactive contextual guide - helps users based on their current state'
+description: 'Contextual help'
 ---
 
 # /p:help
 
-## Purpose
-
-Contextual help system that analyzes project state and provides relevant guidance. Different responses based on user's current situation.
-
 ## Flow
+Check state → Determine context → Show relevant help
 
-1. **Check project state**: Read core files if initialized
-2. **Determine context**: What state is the user in?
-3. **Provide relevant help**: Suggestions based on context
-4. **Show examples**: Concrete examples for their situation
-
-## Response Based on Context
-
-### Context 1: Project Not Initialized
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-👋 WELCOME TO PRJCT!
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Ship Fast. No BS.
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-🚀 FIRST STEP: Initialize
-
-For existing project:
-  /p:init
-
-For new blank project:
-  /p:init "your idea here"
-  → Activates ARCHITECT MODE
-  → Conversational setup
-  → Tech stack recommendations
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-After init, I'll help you:
-  • Break down features into tasks
-  • Track your progress
-  • Ship faster
-
-Let's start! 🎉
-```
+## Contexts
+1. **Not init**: Show `/p:init` guide
+2. **Empty**: Suggest `/p:feature` or `/p:analyze`
+3. **Active task**: Show task, suggest `/p:done`
+4. **Has queue**: Suggest `/p:work 1`
+5. **Lost**: Show all options with examples
 
-### 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!
+  "{natural_example_1}"
+  "{natural_example_2}"
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-💬 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 ✅
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-🚀 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 Reference
-
-Always include at the end of contextual help:
-
+📚 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 (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,34 +1,16 @@
 ---
-allowed-tools: [Write]
+allowed-tools: [Read, Write, GetTimestamp, GetDate]
 description: 'Quick idea capture'
+timestamp-rule: 'GetTimestamp() and GetDate() for timestamps'
 ---
 
 # /p:idea
 
-## Usage
-
-```
-/p:idea <text>
-```
-
 ## 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)
-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
-
-```jsonl
-{"ts":"2025-10-04T16:00:00Z","type":"idea_add","idea":"{text}","actionable":{true/false},"priority":"{high/med/low}"}
-```
+1. Log: `planning/sessions/{YY-MM}/{DD}.jsonl`
+   `{"ts":"{GetTimestamp()}","type":"idea_add","idea":"{text}"}`
+2. Update: `planning/ideas.md` with {GetDate()}
+3. If actionable → `core/next.md`
 
 ## Response
-
-```
-💡 {idea}
-{✅ Added to queue | 📝 Saved to backlog}
-
-/p:now "{idea}" | /p:next
-```
+`💡 {idea} | Saved | Start: /p:feature "{idea}"`

package/templates/commands/init.md

@@ -1,210 +1,34 @@
 ---
 allowed-tools: [Read, Write, Bash]
-description: 'Initialize prjct project (with architect mode for blank projects)'
+description: 'Initialize prjct'
 ---
 
 # /p:init
 
-## Usage
+## Flow
 
-```
-/p:init                    # Existing project
-/p:init "[idea]"          # New blank project (architect mode)
-```
-
-## Flow: Existing Project
-
-1. Generate: project ID from path hash
-2. Create: `~/.prjct-cli/projects/{id}/` structure (including `agents/`)
-3. Write: `.prjct/prjct.config.json`
-4. Run: `/p:analyze` to understand stack
-5. Generate: agents based on stack
-6. Log: `memory/context.jsonl`
-
-## Flow: Blank Project (Architect Mode)
-
-1. Generate: project ID
-2. Activate: ARCHITECT role
-3. Analyze: idea/requirements
-4. Recommend: tech stack options (Next.js, React, Vue, etc.)
-5. User confirms: choice
-6. Create: directory structure + base files
-7. Generate: initial roadmap
-8. Generate: agents
-9. Ask: "¿Empezamos con la primera feature?"
-
-## Directory Structure
-
-```
-~/.prjct-cli/projects/{id}/
-├── core/          # now.md, next.md, context.md
-├── progress/      # shipped.md, metrics.md
-├── planning/      # ideas.md, roadmap.md
-├── analysis/      # repo-summary.md
-├── agents/        # AI agent definitions
-└── memory/        # context.jsonl
-```
-
-## Config Format
-
-```json
-{
-  "version": "0.6.0",
-  "projectId": "{id}",
-  "dataPath": "~/.prjct-cli/projects/{id}",
-  "author": {
-    "name": "{from git}",
-    "email": "{from git}",
-    "github": "{from remote}"
-  }
-}
-```
-
-## Response: Existing Project
-
-```
-✅ prjct initialized!
-
-📁 Data: ~/.prjct-cli/projects/{id}
-📝 Config: .prjct/prjct.config.json
-📊 Analysis: {stack_summary}
-🤖 Agents: {N} agents generated
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-🎯 WHAT DO YOU WANT TO DO FIRST?
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Choose your path:
-
-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
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
+**Existing**: ID → dirs → config → analyze → agents
+**Blank + idea**: ARCHITECT → analyze → recommend stack → create → roadmap
 
-💬 OR JUST TELL ME:
+## Structure
+`~/.prjct-cli/projects/{id}/`: core, progress, planning, analysis, agents, memory
 
-You can talk naturally:
-  "I want to add authentication"
-  "Help me fix this performance issue"
-  "What should I do?"
+## Config
+`.prjct/prjct.config.json`: version, projectId, dataPath, author
 
-I understand! No need to memorize commands.
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-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:]
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-✅ Structure created!
-
-📁 Project: {path}
-📦 Stack: {chosen_stack}
-📋 Initial roadmap: {N} features
-🤖 Agents: {N} specialists generated
+## Response
+`✅ Init | {stack} | {N} agents | Next: /p:feature or /p:help`
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━
 🎯 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
+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
 
-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"
-
-━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-💬 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? 🚀
 ```