One-click install
npx skills add https://github.com/miethe/boxbrain-2 --skill plan-status-miethe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-status
Source: https://github.com/miethe/boxbrain-2/tree/main/.claude/skills/plan-status
Command: npx skills add https://github.com/miethe/boxbrain-2 --skill plan-status-miethe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, and includes scripts (resource) components.

What problem does it solve?

This Skill provides a reliable cross-feature view of implementation plans, PRDs, progress files, and planning workflows, helping teams identify active work, stale statuses, mismatches, orphaned plans, and the next actionable tasks without manually inspecting every artifact.

Core Features & Use Cases

  • Status Reporting: Aggregate planning artifacts by effective status, including inferred completion from implementation and progress records.
  • Mismatch Auditing: Detect stale frontmatter, incomplete task states, and discrepancies between declared plan status and actual task progress.
  • Planning Triage: Investigate superseded or abandoned PRDs, surface ready-to-promote design specs, triage findings, and identify the next implementation wave.
  • Use Case: A software team can quickly determine which features are active, which progress files need remediation, and which approved planning wave should be implemented next.

Quick Start

Ask the plan-status skill to show the current planning status for the repository and summarize active work, inferred completions, and mismatches.

Frequently Asked Questions about plan-status

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

FAQPage Schema
How do I aggregate scattered implementation plans and PRD tracking files to see feature status?

To audit implementation progress and detect stale PRD frontmatter, scan planning directories to compare declared statuses against actual task progress, surfacing incomplete task states, orphaned plans, and mismatches between documentation and reality.

What is the best way to triage superseded plans and identify the next implementation wave?

Yes, you need Python and PyYAML to track project planning status, as the tool requires these dependencies to parse repository-local planning directories and frontmatter conventions for status propagation and artifact discovery.

Can I infer feature completion from implementation records without manually checking every progress file?

Yes, you can infer feature completion from implementation records by aggregating progress files and planning artifacts, which automatically reveals effective statuses and discrepancies without the need to manually inspect each file.

What are the limitations of using frontmatter conventions for status propagation in project planning?

Limitations of using frontmatter conventions for status propagation include relying on consistent frontmatter formatting across all planning artifacts, requiring repository-local directory structures, and potential mismatches if declared statuses are not updated alongside actual task progress.