conductor-status

Conductor Status - Project Status Viewing Tool

Overview

Conductor Status is a project management status query tool used to display the overall progress of a Conductor project, active tracks, and suggested next actions.

Use Cases

1. Daily development progress synchronization

Quickly check the current project status before starting work each day to see which tracks are in progress and which tasks need priority, helping the team stay aligned.

2. Project onboarding and overview

When a new member joins the project or a quick overview of the project is needed, a complete progress report provides a fast understanding of project progress, including completed and pending tracks and tasks.

3. Stand-up preparation and blocker detection

Run the status query before the daily stand-up to quickly learn the current focus tasks, identify blocked tasks, and view suggested next actions to improve stand-up efficiency.

Core Features

1. Overall project status display

Automatically scans the Conductor project directory and aggregates completion status for all tracks, including counts of completed, in-progress, and pending tracks, as well as the overall progress percentage. Supports progress bar visualization.

2. Detailed track analysis

For a single track, displays its full task list, current phase, current task, acceptance criteria completion status, and related Git commit history to help developers pinpoint their work location.

3. Multiple output formats

Supports standard table output, a quick concise mode (--quick), single-track detail mode (specify track-id), and a machine-readable JSON format (--json) to meet different use-case needs.

Frequently Asked Questions

How do I use Conductor Status?

Run /conductor:status to view the overall project status. If you only want to view a specific track's status, add the track ID, for example /conductor:status auth_20250110. Use --quick or -q to quickly view a brief summary.

Does it support exporting to JSON?

Yes. Use the --json option to export project status in JSON format, which is convenient for scripts or integration with other tools. The JSON output includes the project name, timestamp, track statistics, task statistics, current focus tasks, and a list of blockers.

Will it error if the project is not initialized?

Yes. Conductor Status first checks whether conductor/product.md and conductor/tracks.md exist. If these files are missing, it will display an error and prompt you to run /conductor:setup to initialize the project. If the project is initialized but no tracks have been created, it will prompt you to create the first track.