track-pending

Write deferred work entries into walter-pending.md with frontmatter metadata and TP IDs.

6|1|Updated May 13, 2026
One-click install
npx skills add https://github.com/Xipher-Labs/walter-os --skill track-pending
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: track-pending
Source: https://github.com/Xipher-Labs/walter-os/tree/main/skills/track-pending
Command: npx skills add https://github.com/Xipher-Labs/walter-os --skill track-pending

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents scope drift and lost context by giving deferred follow-ups a consistent, repository-root home instead of scattering them into TODO comments or ad-hoc notes.

Core Features & Use Cases

  • Creates a bounded pending ledger: Writes structured entries into walter-pending.md at the repo root so future self can find what to do next.
  • Standardizes entry metadata and triggers: Uses strict frontmatter fields (e.g., severity, area, created, defer-until, owner) to support predictable review and cleanup.
  • Improves planning and review hygiene: Separates out-of-scope follow-ups from the current PR while keeping the why and the trigger phrase tied to the work context.

Quick Start

Use the instruction "Track this follow-up by writing a new TP entry in walter-pending.md with the correct type, severity, area, created date, and defer-until condition."

Frequently Asked Questions about track-pending

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

FAQPage Schema
How do I track deferred work and scope drift in a repository without losing context?▼

To track deferred work and prevent scope drift, you can capture follow-ups in a structured repository ledger at the repo root. This keeps context tied to the work instead of scattering it into TODO comments or ad-hoc notes.

What is the best way to document out-of-scope follow-ups discovered mid-PR?▼

The best way to document out-of-scope follow-ups discovered mid-PR is writing structured entries into a markdown ledger. This separates follow-ups from the current PR while preserving the trigger phrase and work context for future review.

How do I manage stale docs, missing tests, and flaky CI assertions without cluttering my current pull request?▼

You can manage stale docs, missing tests, and flaky CI assertions by logging them as structured entries in a pending ledger file. This removes clutter from your current pull request while ensuring the deferred items are resolvable later.

Does tracking deferred engineering ops items require a specific file format at the repository root?▼

Yes, tracking deferred engineering ops items requires writing entries to a markdown file at the repo root. Entries must use strict frontmatter metadata fields like severity, area, created date, and defer-until triggers to support predictable review.

When should I not use TODO comments for repository documentation follow-ups?▼

You should not use TODO comments for repository documentation follow-ups when you need to prevent lost context and scope drift. TODO comments scatter follow-ups and lack the strict metadata needed for predictable review and cleanup.

Can I use a markdown ledger to standardize entry metadata for follow-up refactors?▼

Yes, you can use a markdown ledger to standardize entry metadata for follow-up refactors. The ledger applies strict frontmatter fields including severity, area, owner, and defer-until conditions to ensure each tracked item is resolvable.