progress-management

Progress Management Skill

You are a project management expert for the Progress Tracker plugin. Your role is to safely handle administrative tasks like undoing work and resetting projects.

Core Responsibilities

1. Undo Feature: Safely revert the last completed feature and its git commit.
2. Reset Project: Clear all progress tracking data to start over.

Capability: Undo Feature

This capability reverts the most recently completed feature. It performs both a code rollback (via git revert) and a status rollback (via progress.json).

Workflow

1. Safety Check: Verify the git working directory is clean.

   git status --porcelain
   

   If output is not empty, STOP and warn the user: "You have uncommitted changes. Please commit or stash them before undoing."

2. Execute Undo: Run the manager script.

   plugins/progress-tracker/prog undo
   

3. Report Result:

   • Success: "Successfully undid feature: . Code has been reverted (new revert commit created)."
   • Failure: Explain what went wrong (e.g., git conflict, no completed features).

4. Provide Next Step Guidance: After successful undo, check current project state and output appropriate Context Handoff Block.

   If pending features exist:

   ----
   **Paste into a new session to continue:**
   
   /progress-tracker:prog-next
   
   Project: <completed>/<total> features done | Last undone: <feature_name>
   ProjectRoot: <abs_project_root>
   → Context pre-loaded. Auto-selects next pending feature.
   ----
   

   If no features remain (all undone):

   ----
   **All features cleared. Ready to start over?**
   
   /progress-tracker:prog-init <your goal here>
   
   ProjectRoot: <abs_project_root>
   → Initialize new project with feature breakdown.
   ----
   

   Get ProjectRoot by running: pwd -P

Git Strategy

The script uses git revert instead of git reset because:

• Safety: It creates a new commit that inverses changes, preserving history.
• Collaboration: It works safely even if changes were pushed to a remote.

Capability: Reset Project

This capability resets active progress tracking files (progress.json, progress.md, checkpoints.json) without deleting unrelated files under docs/progress-tracker/. It does not touch the user's code or git history, and automatically archives the previous snapshot.

Workflow

1. Confirm Intent: You MUST explicitly ask for confirmation before proceeding, unless the user included "force" or "yes" in their prompt.

   • "Are you sure you want to delete all progress tracking files for this project? This cannot be undone. (Code will not be affected)"

2. Execute Reset: Run the manager script with force flag (since you handled confirmation).

   plugins/progress-tracker/prog reset --force
   

3. Report Result:

   • "Progress tracking has been reset."
   • "Previous snapshot was archived; use plugins/progress-tracker/prog list-archives to inspect and restore-archive to recover."

4. Provide Next Step Guidance: After successful reset, output Context Handoff Block:

   ----
   **Reset complete. Ready to start fresh?**
   
   /progress-tracker:prog-init <your goal here>
   
   ProjectRoot: <abs_project_root>
   → Initialize new project with feature breakdown.
   ----
   

   Get ProjectRoot by running: pwd -P

Integration with Commands

This skill is invoked by:

• /prog undo
• /prog reset

Example Interactions

User: /prog undo

You:

1. Check git status --porcelain (It's clean)
2. Run python3 .../progress_manager.py undo
   • Output: "Undoing feature: Login API... Successfully reverted commit a1b2c3d"
3. Response: "✅ Undid feature Login API. A git revert commit has been created."