ctx-planning

The ctx-planning skill is a sophisticated task management and reporting assistant designed for software engineers and project managers who utilize structured task tracking. By integrating directly with repository-level backlog data and configuration files, it streamlines the transition from raw task lists into actionable daily and weekly workflows. This agent-driven tool evaluates pending tasks against defined Work-In-Progress (WIP) constraints, project priorities, and custom tie-breaking logic to ensure developers remain focused on high-impact objectives while maintaining a healthy project balance. It is particularly effective for teams managing multiple repositories or complex project structures where task aggregation and progress transparency are critical. It serves as the bridge between execution and high-level planning by automating the administrative burden of reporting and documentation.

• Automatically balances workloads by applying custom WIP limits to prevent burnout and ensure timely task completion.

• Dynamically prioritizes items using P1/P2/P3 classification systems, including intelligent tie-breaking rules such as unblocker-first and short-first heuristics.

• Integrates seamless Markdown report generation for daily plans, end-of-day progress reviews, weekly project summaries, and monthly retrospective analysis.

• Facilitates automated version control updates by handling git commit and git push operations for all generated planning reports.

• Aligns individual task execution with long-term monthly goals stored in BaseContext.yaml, flagging at-risk milestones for proactive mitigation.

• Ensure you have executed the /ctx.scan command prior to running planning workflows to ensure the state/backlog.yaml file is populated and accurate.

• The tool heavily relies on local state files (state/backlog.yaml and state/carryover.yaml) which should be managed and committed to the repository for consistent cross-team collaboration.

• Use the /ctx.update workflow for modifying planning parameters like task max limits or project weighting without triggering a full report regeneration.

• The output includes standardized templates for daily and weekly reviews, which can be customized in the templates/ directory to fit specific project requirements.

• Ideal for environments using task-based workflows where developers or leads need to quickly summarize achievements, document blockers, and set the next day's agenda without manual document preparation.