stubbing-temporary-comments

Insert structured STUB markers to plan code changes before implementation.

1|Updated Apr 13, 2015
One-click install
npx skills add https://github.com/tyler-dot-earth/.dotfiles --skill stubbing-temporary-comments
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stubbing-temporary-comments
Source: https://github.com/tyler-dot-earth/.dotfiles/tree/main/agents/skills/stubbing-temporary-comments
Command: npx skills add https://github.com/tyler-dot-earth/.dotfiles --skill stubbing-temporary-comments

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Plans changes by inserting structured temporary stub comments and then replacing them with real code in a second pass. Use for complex features, multi-file refactors, or when the user asks to plan implementation directly in code before writing full logic.

Core Features & Use Cases

  • Two-pass workflow (Recon Pass and Stub Pass) to map changes before editing.
  • Structured STUB markers with IN, OUT, EDGE, DONE to capture intent and requirements.
  • Cleanup and quality checks to ensure no unresolved STUB markers remain.

Quick Start

Place STUB blocks at intended implementation sites, then replace them with working code in a second pass.

Frequently Asked Questions about stubbing-temporary-comments

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

FAQPage Schema
How do I plan code changes across multiple files before writing the actual logic?

You can plan code changes by inserting structured STUB blocks at intended implementation sites to map out logic before writing the real code. This two-pass workflow uses a Recon Pass to map changes and a Stub Pass to insert markers.

What is the two-pass stubbing workflow for code refactoring?

The two-pass stubbing workflow separates planning from implementation by first mapping changes with structured STUB markers, then replacing those markers with working code in a second pass to ensure organized code refactoring.

How do I make sure my code planning comments survive into the final implementation?

To make code planning comments survive into final implementation, use structured STUB blocks with IN, OUT, and EDGE markers to capture intent and requirements, ensuring rationale is preserved during the second implementation pass.

Does this comment-first coding approach work for complex multi-file features?

Yes, this comment-first coding approach is specifically designed for complex multi-file features and refactors with uncertain details, allowing you to place STUB blocks across files before implementing the real logic.

How do I check that all temporary code planning markers are resolved before merging?

You can verify all temporary code planning markers are resolved by using the built-in cleanup and quality checks that enforce a DONE criterion, ensuring no unresolved STUB markers remain in the final code.