tendril/docs/PROMPTS/00-Project-Status-Check-Prompt.md

Project Status Check Prompt

Purpose: Check current status of all project phases in the Tendril repository and provide a comprehensive status summary.

How to Use: Drag this entire document into a Cursor chat session. The AI assistant will read all phase blueprints and provide a status overview including phase completion, deliverables, and any issues.

---

CRITICAL: Information Gathering

Required Information (You should provide this)

No additional information required. The AI will automatically:

• Find all phase directories in tendril/phases/
• Read phase blueprint files
• Extract status information

If Information is Missing

ALWAYS ASK for missing required information before proceeding. Do not make assumptions about:

• Phase directory structure
• Blueprint file locations
• Status indicator formats

---

Step-by-Step Process

Phase 1: Discover Phase Directories

1. Find all phase directories:

   find tendril/phases -type d -name "phase-*" | sort
   

   • Should list all phase directories
   • Format: tendril/phases/phase-XX-name/

2. Validation:

   • Verify phase directories are found
   • Check naming follows phase-XX-name pattern
   • Confirm directories exist

Phase 2: Read Phase Blueprints

For each phase directory found:

1. Read the blueprint file:

   • Path: tendril/phases/phase-XX-name/blueprint.md
   • Extract: Phase name, status, key deliverables, milestones

2. Read the tasks file:

   • Path: tendril/phases/phase-XX-name/tasks.md
   • Extract: Task completion status, open tasks

3. Validation:

   • Verify blueprint file exists
   • Confirm status indicators are readable
   • Check deliverables are listed

Phase 3: Compile Status Summary

1. Organize by status:

   • ✅ Complete phases
   • 🔄 In Progress phases
   • ⏳ Planned phases

2. Count phases:

   • Total phases
   • Complete count
   • In Progress count
   • Planned count

3. Extract key information:

   • Phase names and numbers
   • Current status for each
   • Key deliverables per phase
   • Any blockers or issues mentioned

4. Validation:

   • All phases are accounted for
   • Status counts are accurate
   • No phases are missing

Phase 4: Present Status Report

1. Create summary table:

   • Phase | Status | Key Deliverables | Notes

2. Provide overview:

   • Total phases: X
   • Complete: X
   • In Progress: X
   • Planned: X

3. Highlight issues:

   • Any phases with blockers
   • Phases behind schedule
   • Missing or incomplete deliverables

4. Validation:

   • Summary is complete
   • All phases are included
   • Status is accurate

---

Error Handling

Common Issues

Phase Directory Not Found

• Error message: "No phase directories found" or "Directory does not exist"
• Fix:
  1. Verify you're in the repository root
  2. Check tendril/phases/ directory exists
  3. Confirm phase naming follows phase-XX-name pattern
• Prevention: Always check directory structure before reading files

Blueprint File Missing

• Error message: "File not found: blueprint.md"
• Fix:
  1. Check if blueprint.md exists in phase directory
  2. Verify file name is exactly blueprint.md (case-sensitive)
  3. Check file permissions
• Prevention: Verify file exists before attempting to read

Invalid Status Format

• Error message: "Status indicator not recognized"
• Fix:
  1. Check status format in blueprint
  2. Look for: ✅ Complete, 🔄 In Progress, ⏳ Planned
  3. Handle variations or typos gracefully
• Prevention: Document expected status formats

No Phases Found

• Error message: "No phase directories found"
• Fix:
  1. Verify repository structure
  2. Check if phases directory exists
  3. Confirm you're in correct repository
• Prevention: Validate repository structure before starting

---

Validation Checklist

Before completing, verify:

• All phase directories discovered
• All blueprint files read successfully
• Status extracted for each phase
• Phase counts are accurate (total = complete + in progress + planned)
• Summary table includes all phases
• Key deliverables listed for each phase
• Issues or blockers identified (if any)
• Report is clear and actionable

---

Important Notes for AI Assistant

1. Read all phases: Don't skip any phase directories, even if they seem incomplete
2. Preserve status indicators: Use exact status indicators (✅, 🔄, ⏳) from blueprints
3. Handle missing data gracefully: If a blueprint is missing information, note it but continue
4. Provide context: Include phase numbers and names in the summary
5. Be thorough: Check both blueprint.md and tasks.md for complete status
6. Use Tendril terminology: Reference "Tendril" project, not "pairs" or placeholders
7. Gitea context: Note that this is a Gitea repository (not GitHub)

---

Location: docs/PROMPTS/00-Project-Status-Check-Prompt.md
Related:

• tendril/phases/ - Phase directories
• docs/PROMPTS/LLM-Usage-Guide.md - LLM execution guidelines
• docs/PROMPTS/Prompt-Creation-Guide.md - Prompt creation guide