write-todos

Generate self-contained todos with constraints and acceptance criteria from plan artifacts.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/v36372/pi-stuff --skill write-todos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-todos
Source: https://github.com/v36372/pi-stuff/tree/main/skills/write-todos
Command: npx skills add https://github.com/v36372/pi-stuff --skill write-todos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams generate clear, self-contained todos that preserve architectural intent so workers can execute tasks without needing context from planning discussions.

Core Features & Use Cases

  • Self-contained todos: Each todo includes Plan, What, Constraints, Files, and Expected Outcome to prevent drift.
  • Architectural guardrails: Todos embed explicit constraints to enforce design decisions and avoid drift from the plan.
  • Plan-to-workflow translation: Converts planning artifacts (plans/YYYY-MM-DD-<name>.md) into executable work items for engineering teams.

Quick Start

Provide a plan artifact and generate a ready-to-execute set of todos that preserve architectural intent.

Frequently Asked Questions about write-todos

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

FAQPage Schema
How do I generate self-contained todos from a software plan artifact?

Decomposing software architecture plans into actionable todos preserves architectural intent by embedding explicit constraints, example patterns, and verifiable acceptance criteria within each task body, ensuring workers execute design decisions without needing context from original planning discussions.

How do I prevent architectural drift when delegating software engineering tasks?

To prevent architectural drift when delegating tasks, generate todos that embed explicit constraints and verifiable acceptance criteria directly within each task body, ensuring workers execute design decisions without needing context from original planning discussions.

What format should plan artifacts follow for task decomposition?

Plan artifacts should follow the plans/YYYY-MM-DD-<name>.md file path format to enable accurate task decomposition. This structured markdown format allows the system to extract architectural intent and generate self-contained todos with proper plan path references.

Can I include architectural constraints and acceptance criteria in generated todos?

Yes, generated todos include explicit architectural constraints and verifiable acceptance criteria. Each todo body contains design guardrails, an example pattern, and expected outcomes as verifiable acceptance criteria to enforce architectural decisions and ensure measurable task completion.

What are the limitations of using automated todo generation for software planning?

Automated todo generation requires existing plan artifacts in the plans/YYYY-MM-DD-<name>.md format to function, limiting its use to teams already maintaining structured planning documents. It cannot generate architectural intent from scratch, but only decomposes and translates existing plans into work items.