file-todos

Manage file-based todo tracking with Markdown and YAML frontmatter.

Updated Jun 28, 2022
One-click install
npx skills add https://github.com/pcasaretto/nix-home --skill file-todos-pcasaretto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: file-todos
Source: https://github.com/pcasaretto/nix-home/tree/main/home-manager/modules/common/pi/compound-engineering/skills/file-todos
Command: npx skills add https://github.com/pcasaretto/nix-home --skill file-todos-pcasaretto

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill streamlines the management of code review feedback, technical debt, and feature requests by providing a structured, file-based system for tracking and prioritizing work items.

Core Features & Use Cases

  • Todo Creation: Easily create new todo items from findings or feedback, complete with detailed problem statements, proposed solutions, and acceptance criteria.
  • Lifecycle Management: Manage the status of todos from pending to ready to complete, including triaging and updating work logs.
  • Dependency Tracking: Define and manage dependencies between todo items to ensure proper workflow sequencing.
  • Use Case: When a code review identifies a piece of technical debt, you can create a new todo file, assign a priority, detail the problem, and add it to the backlog for future work.

Quick Start

Create a new todo file for a critical bug fix with the description 'fix-login-bug'.

Frequently Asked Questions about file-todos

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track technical debt and code review feedback using Markdown files?

You can track technical debt and code review feedback by creating Markdown files with YAML frontmatter, which structure problem statements, proposed solutions, and acceptance criteria for each todo item.

What is the best way to manage task dependencies in a file-based todo system?

Dependency tracking in a file-based todo system works by defining dependencies between individual todo files, ensuring proper workflow sequencing so that prerequisite tasks are completed before dependent ones.

How do I triage and update the lifecycle status of development tasks?

You triage and update development task lifecycles by using shell commands to manipulate Markdown files, moving todo statuses from pending to ready and finally to complete while logging work updates.

Can I use shell commands to automate task management for feature requests?

Yes, task management for feature requests requires shell commands to manipulate the Markdown files, enabling you to create new todo items, update statuses, and manage the backlog efficiently.

When do I need a file-based todo system instead of a database tracker?

A file-based todo system is needed when you want to streamline code review feedback and technical debt management directly within your repository, providing a structured format for tracking and prioritizing work items without external databases.