Todo Add

Purpose

Manually create a new todo item when automatic detection is not applicable or when user wants to add a personal task.

Prerequisites

•A Todos/ directory must exist in the knowledge base
•The Todos/ directory should have a RULE.md with todo configuration
•If not exists, offer to create the directory structure

Execution Flow

Phase 1: Locate Todos Directory

•Search for Todos/ directory in the current working directory or its parents
•If not found, search in common knowledge base locations

•If still not found, ask user:

code

"No Todos directory found. Would you like me to create one?"
Options:
- "Yes, create in [suggested path]"
- "Yes, but in a different location"
- "No, cancel"

Phase 2: Gather Todo Information

Use AskUserQuestion to collect information:

Question 1: Title (required)

json

{
  "question": "What is the todo item?",
  "header": "Todo Title",
  "options": [
    {"label": "Type your answer", "description": "Describe the task briefly"}
  ],
  "multiSelect": false
}

Question 2: Priority

json

{
  "question": "What is the priority?",
  "header": "Priority",
  "options": [
    {"label": "High", "description": "Urgent or time-sensitive task"},
    {"label": "Medium (Recommended)", "description": "Normal priority task"},
    {"label": "Low", "description": "Can be done when time permits"}
  ],
  "multiSelect": false
}

Question 3: Due Date (optional)

json

{
  "question": "When is this due?",
  "header": "Due Date",
  "options": [
    {"label": "No deadline", "description": "No specific due date"},
    {"label": "Today", "description": "Due by end of today"},
    {"label": "Tomorrow", "description": "Due by end of tomorrow"},
    {"label": "This week", "description": "Due by end of this week"}
  ],
  "multiSelect": false
}

Phase 3: Create Todo File

•
Generate filename:
- •Format: YYYY-MM-DD_[slug-from-title].md
- •Example: 2025-01-13_reply-client-email.md
- •Slug: lowercase, hyphens instead of spaces, max 50 chars
•
Create file in Todos/active/:

yaml

---
title: [User provided title]
status: pending
priority: [high|medium|low]
created_at: [Current date YYYY-MM-DD]
due_date: [If provided, YYYY-MM-DD format]
source_file: null
source_type: manual
tags: []
dependencies: []
related_files: []
---

# [Title]

## Task Details

[Description if provided, otherwise leave for user to fill]

## Checklist

- [ ] [First step - user can edit]

## Execution Log

### [Current Date]
- Todo created manually
- Status: pending
- Priority: [priority]

Phase 4: Update Governance

•
Update Todos/active/README.md:
- •Add new entry to the file list
- •Format: - [filename](filename) - [title] (Priority: [priority], Due: [date or 'none'])
- •Update "Last updated" timestamp
•
Update Todos/README.md:
- •Update active todo count
- •Add to "Recent Changes" section

Phase 5: Report

Confirm creation with summary:

code

✅ Todo created successfully!

Title: [title]
Priority: [priority]
Due Date: [date or 'No deadline']
Location: Todos/active/[filename]

You can:
- View all todos with /todo-list
- Mark complete with /todo-complete
- Update details with /todo-update

Error Handling

No Todos Directory

If no Todos/ directory exists:

•Offer to create the directory structure
•
If user agrees, create:
- •Todos/RULE.md (with default todo governance rules)
- •Todos/README.md (index file)
- •Todos/active/README.md
- •Todos/completed/README.md

Duplicate Title

If a todo with similar title exists:

•Notify user: "A similar todo already exists: [title]"
•
Offer options:
- •"Create anyway with different name"
- •"Open existing todo"
- •"Cancel"

Default RULE.md Template

If creating new Todos directory, use this template:

markdown

# Todos - Personal Task Management

## Purpose

Centralized management of all todo items.

## Todo Tracking

enabled: true
todos_directory: [current path]

## Structure

Todos/
├── active/      # Active todos
└── completed/   # Completed todos

## Naming Convention

YYYY-MM-DD_todo-title-slug.md

## Allowed Operations

- Create: Allowed
- Update: Allowed (must update execution log)
- Delete: Not allowed (archive to completed/ instead)
- Move: Only between active/ and completed/