--- description: Show current workflow progress and status --- # Titanium Status Command You are reporting on the current workflow state and progress. This command provides a comprehensive view of where the project stands, what's been completed, and what's remaining. ## Overview This command will: 1. Check for active workflow state 2. Query Pieces for recent work 3. Analyze TodoWrite progress (if available) 4. Check for existing plan 5. Calculate progress metrics 6. Present formatted status report 7. Optionally provide voice summary --- ## Step 1: Check for Active Workflow ### Check Workflow State File ```bash uv run ${CLAUDE_PLUGIN_ROOT}/hooks/utils/workflow/workflow_state.py get "$(pwd)" ``` **If workflow exists**: - Parse the JSON response - Extract: - workflow_type - goal - status (planning/in_progress/completed/failed) - current_phase - started_at timestamp - phases history **If no workflow exists**: - Report: "No active workflow found in this project" - Check for plan anyway (might be planning only) - Query Pieces for any previous work --- ## Step 2: Query Pieces for Context Use Pieces LTM to get recent work history: ``` mcp__Pieces__ask_pieces_ltm( question: "What work has been done in the last session on this project at [current directory]? What was being worked on? What was completed? What was left unfinished?", chat_llm: "claude-sonnet-4-5", topics: ["workflow", "implementation", "development"], application_sources: ["Code"] ) ``` **Extract from Pieces**: - Recent activities - What was completed - What's in progress - Any issues encountered - Last known state --- ## Step 3: Check for Plan ```bash # Check if plan exists ls .titanium/plan.json ``` **If plan exists**: - Read `.titanium/plan.json` - Extract: - Total epics count - Total stories count - Total tasks count - Estimated total time - List of agents needed **Calculate progress** (if TodoWrite is available): - Count completed tasks vs total tasks - Calculate percentage complete - Identify current task (first pending task) --- ## Step 4: Analyze TodoWrite Progress (if in active session) **Note**: TodoWrite state is session-specific. This step only works if we're in the same session that created the workflow. If TodoWrite is available in current session: - Count total tasks - Count completed tasks - Count pending tasks - Identify current task (first in_progress task) - Calculate progress percentage If TodoWrite not available: - Use plan.json task count as reference - Note: "Progress tracking available only during active session" --- ## Step 5: Calculate Metrics ### Progress Metrics **Overall Progress**: ``` progress_percentage = (completed_tasks / total_tasks) * 100 ``` **Time Metrics**: ``` elapsed_time = current_time - workflow.started_at remaining_tasks = total_tasks - completed_tasks avg_time_per_task = elapsed_time / completed_tasks (if > 0) estimated_remaining = avg_time_per_task * remaining_tasks ``` **Phase Progress**: - Identify which phase is active - List completed phases with timestamps - Show phase transition history --- ## Step 6: Present Status Report ### Format: Comprehensive Status ``` 📊 Titanium Workflow Status ═══════════════════════════════════════════════ 🎯 Goal: [workflow.goal] 📍 Current Phase: [current_phase] Status: [status emoji] [status] ⏱️ Timeline: Started: [formatted timestamp] ([X] hours/days ago) [If completed: Completed: [timestamp]] [If in progress: Elapsed: [duration]] ─────────────────────────────────────────────── 📈 Progress: [X]% Complete ✅ Completed: [X] tasks ⏳ Pending: [Y] tasks 🔄 Current: [current task name if known] ─────────────────────────────────────────────── 📦 Project Structure: Epics: [X] Stories: [Y] Tasks: [Z] Total Estimated Time: [time] 🤖 Agents Used/Planned: [List agents with their roles] ─────────────────────────────────────────────── 📝 Recent Work (from Pieces): [Summary from Pieces query - what was done recently] Key Accomplishments: - [Item 1] - [Item 2] - [Item 3] Current Focus: [What's being worked on now or what's next] ─────────────────────────────────────────────── 🔄 Phase History: 1. ✅ Planning - Completed ([duration]) 2. 🔄 Implementation - In Progress (started [time ago]) 3. ⏳ Review - Pending 4. ⏳ Completion - Pending ─────────────────────────────────────────────── ⏰ Time Estimates: Elapsed: [duration] Est. Remaining: [duration] (based on current pace) Original Estimate: [total from plan] [If ahead/behind schedule: [emoji] [X]% [ahead/behind] schedule] ─────────────────────────────────────────────── 📁 Key Files: Created/Modified: [List from Pieces or plan if available] Configuration: - Plan: .titanium/plan.json - State: .titanium/workflow-state.json [If exists: - Review: .titanium/review-report.md] ─────────────────────────────────────────────── 💡 Next Steps: [Based on current state, suggest what should happen next] 1. [Next action item] 2. [Second action item] 3. [Third action item] ─────────────────────────────────────────────── 🔊 Voice Summary Available Say "yes" for voice summary of current status ``` --- ## Step 7: Status Variations by Phase ### If Phase: Planning ``` 📊 Status: Planning Phase 🎯 Goal: [goal] Current Activity: - Analyzing requirements - Generating implementation plan - Validating with vibe-check Next: Implementation phase will begin after plan approval ``` ### If Phase: Implementation ``` 📊 Status: Implementation In Progress 🎯 Goal: [goal] Progress: [X]% ([completed]/[total] tasks) Current Task: [task name] Agent: [current agent] Recently Completed: - [Task 1] by @agent-1 - [Task 2] by @agent-2 - [Task 3] by @agent-3 Up Next: - [Next task 1] - [Next task 2] Estimated Remaining: [time] ``` ### If Phase: Review ``` 📊 Status: Quality Review Phase 🎯 Goal: [goal] Implementation: ✅ Complete ([X] tasks finished) Current Activity: - Running quality review - @code-reviewer analyzing code - @security-scanner checking vulnerabilities - @tdd-specialist reviewing tests Next: Address review findings, then complete workflow ``` ### If Phase: Completed ``` 📊 Status: Workflow Complete ✅ 🎯 Goal: [goal] Completion Summary: - Started: [timestamp] - Completed: [timestamp] - Duration: [total time] Deliverables: - [X] epics completed - [Y] stories delivered - [Z] tasks finished Final Metrics: - Test Coverage: [X]% - Quality Review: [findings summary] - All work stored in Pieces ✅ Next: Run /catchup in future sessions to resume context ``` ### If No Active Workflow ``` 📊 Status: No Active Workflow Current Directory: [pwd] No .titanium/workflow-state.json found Checking for plan... [If plan exists: Plan found but not yet executed] [If no plan: No plan found] Checking Pieces for history... [Results from Pieces query] --- Ready to start a new workflow? Run: - /titanium:plan [requirements] - Create implementation plan - /titanium:work [requirements] - Start full workflow ``` --- ## Step 8: Voice Summary (Optional) **If user requests voice summary or says "yes" to voice option**: Create concise summary for TTS (under 100 words): ``` "Workflow status: [Phase], [X] percent complete. [Completed count] tasks finished, [pending count] remaining. Currently working on [current task or phase activity]. [Key recent accomplishment]. Estimated [time] remaining. [Next major milestone or action]." ``` **Example**: ``` "Workflow status: Implementation phase, sixty-seven percent complete. Eight tasks finished, four remaining. Currently implementing the login form component with the frontend developer agent. Just completed the backend authentication API with all tests passing. Estimated one hour remaining. Next, we'll run the quality review phase." ``` **Announce using existing TTS**: - Voice hooks will handle the announcement - No need to call TTS directly --- ## Integration with Workflow Commands ### After /titanium:plan ``` User: /titanium:plan [requirements] [... plan created ...] User: /titanium:status Shows: - Phase: Planning (completed) - Plan details - Ready for /titanium:work ``` ### During /titanium:work ``` User: /titanium:work [... implementation in progress ...] User: /titanium:status Shows: - Phase: Implementation (in progress) - Progress: X% - Current task - Time estimates ``` ### After /titanium:work ``` User: /titanium:work [... completes ...] User: /titanium:status Shows: - Phase: Completed - Summary of deliverables - Quality metrics ``` ### Next Session ``` User: (new session) /titanium:status Shows: - Workflow state from file - Pieces context from previous session - Can resume work ``` --- ## Error Handling ### If Workflow State File Corrupted ``` ⚠️ Workflow state file exists but is corrupted Attempting to recover from Pieces... [Query Pieces for last known state] [If recovery successful: Use Pieces data] [If recovery fails: Report what's known, suggest starting fresh] ``` ### If Pieces Not Available ``` Note: Pieces MCP not available. Status based on local files only. To enable full context recovery: 1. Install Pieces OS (https://pieces.app) 2. Install Pieces CLI (pip3 install pieces-cli) 3. Configure MCP (pieces mcp setup claude_code --stdio) 4. Restart Claude Code ``` ### If No Information Available ``` 📊 Status: No Data Available Current Directory: [pwd] - No workflow state file (.titanium/workflow-state.json) - No plan file (.titanium/plan.json) - Pieces query returned no results This appears to be a new project or no workflows have been run yet. Ready to start? Run: - /titanium:plan - Create implementation plan - /titanium:work - Start full workflow ``` --- ## Use Cases ### Use Case 1: Check Progress Mid-Workflow ``` User: How's the workflow going? Claude: Let me check the status. [Runs /titanium:status] Claude: We're 60% through implementation. 6 of 10 tasks complete. Currently working on the frontend login form. About 2 hours remaining. ``` ### Use Case 2: Resume After Interruption ``` User: (new session) What was I working on? Claude: Let me check. [Runs /titanium:status] Claude: You were implementing user authentication. Phase: Implementation (in progress) Last completed: Backend API by @api-developer Next up: Frontend forms by @frontend-developer Would you like to continue with /titanium:work? ``` ### Use Case 3: Check Before Review ``` User: Is implementation done? Can we review? Claude: Let me check status. [Runs /titanium:status] Claude: Yes! Implementation is 100% complete. All 12 tasks finished. Ready for quality review. Run /titanium:review to start the review process. ``` ### Use Case 4: Daily Standup Info ``` User: What did we accomplish yesterday? Claude: Checking status and history... [Runs /titanium:status + Pieces query] Claude: Yesterday's work: - Completed Backend API epic (3 stories, 7 tasks) - @api-developer implemented JWT middleware - @api-developer created login/register endpoints - @test-runner wrote integration tests - All tests passing Today: Moving to Frontend epic ``` --- ## Voice Feedback Voice hooks may announce: - "Status check complete" (after generating report) - "[X] percent complete" (if voice summary requested) --- ## Advanced Features (Future) Potential enhancements: - Progress visualization (ASCII charts) - Time series data (velocity over time) - Agent performance metrics - Quality trend tracking - Burndown charts --- **This command provides comprehensive workflow status with context from state files, Pieces LTM, and current session, enabling users to track progress and make informed decisions about next steps.**