devenv-refresh-implementation-plan

Assess and remediate stale implementation plans against current codebase state.

Updated Jul 4, 2024
One-click install
npx skills add https://github.com/workinprogress-ai/devenv --skill devenv-refresh-implementation-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: devenv-refresh-implementation-plan
Source: https://github.com/workinprogress-ai/devenv/tree/main/copilot/skills/devenv-refresh-implementation-plan
Command: npx skills add https://github.com/workinprogress-ai/devenv --skill devenv-refresh-implementation-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the problem of implementation plan drift, where documentation becomes outdated as the codebase evolves, leading to confusion and wasted effort during development.

Core Features & Use Cases

  • Staleness Assessment: Automatically detects if a plan is slightly stale, significantly stale, or purely intent-based by checking file paths, symbol references, and git history.
  • Automated Remediation: Offers format normalization and targeted patching to bring plans back in sync with the current codebase.
  • Use Case: When returning to a project after a long sprint, use this skill to identify which tasks are already completed, which file references are broken, and how to realign the plan with the current architecture.

Quick Start

Use the devenv-refresh-implementation-plan skill to assess the staleness of the file Implementation_plan-issue-42-001.md.

Frequently Asked Questions about devenv-refresh-implementation-plan

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

FAQPage Schema
How do I update an outdated implementation plan to match my current codebase?

To update an outdated implementation plan, you can assess staleness by checking file anchors, symbol references, and git history, then apply format normalization and targeted path patching to resync the document with your current codebase state.

Why does my implementation plan reference broken file paths after a refactoring sprint?

Broken file paths occur due to implementation plan drift when codebase refactoring moves or deletes files. Detecting this drift requires comparing document content against current symbol references and git history to identify stale anchors.

Can I check the staleness of an implementation plan directly from a GitHub issue?

Yes, you can assess staleness by operating directly on GitHub issue artifacts to identify drift in file anchors, symbol references, and task completion status against the live codebase.

What is the best way to normalize the format of a stale implementation plan?

The best way to normalize a stale implementation plan is through automated remediation that applies format normalization and intent-based re-planning to maintain documentation integrity and align tasks with current architecture.

Does this approach work for purely intent-based plans that lack specific file references?

Yes, staleness assessment categorizes plans as slightly stale, significantly stale, or purely intent-based, executing intent-based re-planning to realign tasks lacking specific file references with the current architecture.