cf-later-do

/cf-later-do

CLI Requirement: NONE — Works without coding-friend-cli. Reads docs/later/ files directly and dispatches existing skills; no CLI features are required. See CLI requirements for the full matrix.

Process the deferred side-tasks in docs/later/: pick one, fix it (via /cf-fix or /cf-plan), remove it once verified, then move to the next.

Background

plugin/lib/capture-later.sh is the write side — execution skills call it to record an out-of-scope problem as docs/later/YYYY-MM-DD-<name>.md with frontmatter (date, source, optional slug/problem, conversation_id). This skill is the read/resolve side that closes the loop.

Workflow

Step 0: Custom Guide

Custom guide — auto-loaded below (if the raw command shows instead of its output, run it yourself):

bash "<plugin-root>/lib/load-custom-guide.sh" cf-later-do

If output is not empty, integrate returned sections: ## Before → before first step, ## Rules → apply throughout, ## After → after final step.

Step 1: Resolve the backlog directory

• LATER_DIR = $CF_DOCS_ROOT/later (prefer CF_DOCS_ROOT from the SessionStart bootstrap context; if absent, run pwd for $CWD and use $CWD/{docsDir}/later, where docsDir comes from .coding-friend/config.json, default docs).
• If LATER_DIR does not exist OR contains no *.md files → print > No deferred items in docs/later/. and stop cleanly.

Step 2: Scan and parse

Read every LATER_DIR/*.md. For each file, parse the YAML frontmatter (date, source, slug?, problem?, conversation_id), the # title line, and the body. Build an in-memory list of items.

Step 3: Present the picker

Show a numbered list, sorted by date oldest-first (longest-deferred first). One line per item:

[N] <title> — <date> · source: <source> · <problem or one-line body summary>

Ask the user to choose: a number N, or q to quit. (Use a plain numbered list + an open question — do NOT use a direct user question, since the item count is dynamic and may exceed 4.) If the user quits → stop cleanly.