# 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:**
   ```bash
   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