What happens if I manually try to check a box in tasks.md?

The skill intercepts the manual edit, blocks it to prevent data inconsistency, and automatically generates and runs the equivalent task-tracker command to update all relevant files simultaneously.

Is this skill compatible with both Windows and Unix-based systems?

Yes, it features platform detection logic to execute the appropriate task-tracker scripts for your environment, supporting both Bash and PowerShell workflows.

Which files does this skill primarily manage?

It manages the relationship between tasks.md (your checklist) and NOTES.md (your progress log), ensuring that updates to one are reflected accurately in the other.

Can it handle multiple tasks being worked on at once?

Yes, but it includes safety checks to prevent 'WIP bloat' by warning you if more than two tasks are marked as in-progress simultaneously.

How does this skill support Test-Driven Development (TDD)?

The skill includes validation logic that checks the status of related tasks; for example, it will warn you if you attempt to complete an implementation task before its corresponding test task is finished.

Task Status Synchronizer

Name: Task Status Synchronizer
Author: marcusgoll

bymarcusgoll

•

Productivity & Workflow

Ensures atomic synchronization between project task lists and progress notes by enforcing command-line tracking and preventing manual file edit inconsistencies.

About

The Task Status Synchronizer is a specialized skill for Claude Code that maintains absolute consistency between tasks.md and NOTES.md files. By intercepting manual edit attempts and converting them into atomic task-tracker commands, it eliminates data fragmentation and ensures that every checkbox update is accompanied by the necessary progress markers. It is particularly effective for teams using Spec-Driven Development, as it enforces TDD cycles, validates task transitions, and generates auditable artifacts with velocity metrics without requiring the user to remember complex CLI syntax.

Key Features

Ensures 1:1 synchronization between tasks.md checkboxes and NOTES.md completion markers
Monitors parallel work limits and detects file path conflicts between active tasks
18 GitHub stars
Enforces TDD workflows by validating that tests are completed before implementation tasks
Automatically catches and fixes common mistakes like invalid task IDs or incorrect status transitions
Intercepts manual file edits and auto-converts them into atomic task-tracker CLI commands

Use Cases

Maintaining a consistent project state and auditable history during Spec-Driven Development
Automating the synchronization of implementation notes with technical task lists
Preventing documentation drift and merge conflicts in shared task-tracking files

About

Key Features

Ensures 1:1 synchronization between tasks.md checkboxes and NOTES.md completion markers
Monitors parallel work limits and detects file path conflicts between active tasks
18 GitHub stars
Enforces TDD workflows by validating that tests are completed before implementation tasks
Automatically catches and fixes common mistakes like invalid task IDs or incorrect status transitions
Intercepts manual file edits and auto-converts them into atomic task-tracker CLI commands

Use Cases

Maintaining a consistent project state and auditable history during Spec-Driven Development
Automating the synchronization of implementation notes with technical task lists
Preventing documentation drift and merge conflicts in shared task-tracking files