List Projects Skill

List all available projects in the Conductor workspace.

Overview

This skill scans the

projects/

directory and displays all initialized projects with their current status.

Usage

/list-projects

Prerequisites

• Access to the

  projects/

  directory and SurrealDB connection for status.

Outputs

• A table of projects with phase/status metadata.

Output Format

# Available Projects

| Project | Phase | Status | Last Updated |
|---------|-------|--------|--------------|
| my-feature | 3 - Implementation | 40% complete | 2026-01-22 |
| auth-system | 5 - Completion | Done | 2026-01-21 |
| api-refactor | 2 - Validation | Awaiting review | 2026-01-20 |

## Project Details

### my-feature
- **Path**: projects/my-feature/
- **Current Phase**: 3 - Implementation
- **Tasks**: 2/5 completed
- **Has PRODUCT.md**: Yes
- **Has Documents/**: Yes

### auth-system
- **Path**: projects/auth-system/
- **Current Phase**: 5 - Completion
- **Status**: Workflow complete
- **Has PRODUCT.md**: Yes

### api-refactor
- **Path**: projects/api-refactor/
- **Current Phase**: 2 - Validation
- **Status**: Awaiting Cursor/Gemini approval
- **Has PRODUCT.md**: Yes

Discovery Logic

# Find all projects
ls -d projects/*/

# For each project, check:
# 1. Has a workflow state entry in SurrealDB?
# 2. Has PRODUCT.md?
# 3. Has Documents/?

Project Validation

A valid project has:

• Directory exists in

  projects/

• Contains

  PRODUCT.md

  (required for workflow)
• Uses SurrealDB for workflow state (created on first run)

Status Indicators

Status	Meaning
Not started	Has PRODUCT.md but no workflow_state record
In progress	Has active workflow state record
Awaiting review	Waiting for agent approval
Blocked	Has errors or blockers
Done	Workflow completed successfully

Integration

Called by:

• User directly

• /orchestrate

  - To select a project
• Shell script:

  ./scripts/init.sh list

Example Discovery

# List project directories
for dir in projects/*/; do
    project_name=$(basename "$dir")

    # Check for state in DB (pseudo)
    if surrealdb_has_state "$project_name"; then
        phase=$(surrealdb_get_phase "$project_name")
        echo "$project_name: Phase $phase"
    elif [ -f "$dir/PRODUCT.md" ]; then
        echo "$project_name: Not started"
    else
        echo "$project_name: Missing PRODUCT.md"
    fi
done

Error Handling

• If SurrealDB is unreachable, list projects without phase data and warn.
• If

  projects/

  is missing, return an empty result with a clear error.

Related Skills

• /status

  - Project workflow status

• /phase-status

  - Detailed phase status for a project