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.