add-todo

The add-todo skill provides a structured method for capturing tasks, bugs, and feature requests within an AI-driven development environment. By enforcing a consistent syntax in the TODOS.md file, it allows secondary skills like /list-todos and /run-todos to reliably parse, prioritize, and execute work items. This skill is designed for software developers and AI agents operating within the AI Coding Project Toolkit framework, ensuring that project state is maintained and actionable.

• Automatically checks for the presence of TODOS.md and initializes it with a standard template if missing.

• Guides the user through a multi-step interactive process to define title, priority (P0-P2), effort (Low-High), and optional detailed descriptions.

• Supports section-specific insertion, allowing users to categorize tasks into In Progress or Future Concepts sections.

• Validates input to ensure actionable language and professional formatting, defaulting to safe values when requirements are ambiguous.

• Integrates with the project's broader workflow, providing clear next steps for prioritization and implementation.

• Ensure TODOS.md exists in your root directory before usage for best results.

• Use descriptive, action-oriented titles starting with verbs like Add, Fix, or Update.

• Follow the prompts strictly to maintain compatibility with automated planning scripts.

• The skill helps track high-level project goals and technical debt, acting as a bridge between high-level specs and low-level code execution.

• Ideal for use during active development sessions to prevent losing track of bug fixes or iterative improvements while working on primary project branches.

• Built-in error handling manages file permissions and large file scenarios, recommending archival practices if TODOS.md exceeds standard operational sizes.