managing-feature-plans

austinjan's avatarfrom austinjan

Comprehensive feature plan document, creation, editing, and archiving. When LLM needs to work with feature plan documents for (1) Starting a new feature, (2) Reviewing progress of a feature, (3) Reviewing an existing feature plan's requirements, references, and TODOs, or (4) Marking a plan as achieved.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026
[Project Management]

When & Why to Use This Skill

The Managing Feature Plans skill streamlines the software development lifecycle by automating the creation, maintenance, and archiving of comprehensive feature documentation. It ensures project consistency by enforcing standardized templates and naming conventions, allowing developers and AI agents to track progress, manage requirements, and maintain a clear audit trail of completed features.

Use Cases

  • New Feature Initiation: Automatically generate a structured feature plan document from a template to define goals, requirements, and milestones at the start of a project.
  • Progress Tracking and Review: Periodically update existing plans to check off completed tasks, refine TODO lists, and ensure implementation stays aligned with original requirements.
  • Requirement Auditing: Review technical plans to identify missing references, dependencies, or incomplete acceptance criteria before moving to the next development phase.
  • Automated Archiving: Clean up active workspaces by automatically moving finalized feature plans to a dedicated archive folder once all project goals are met.
namemanaging-feature-plans
descriptionComprehensive feature plan document, creation, editing, and archiving. When LLM needs to work with feature plan documents for (1) Starting a new feature, (2) Reviewing progress of a feature, (3) Reviewing an existing feature plan's requirements, references, and TODOs, or (4) Marking a plan as achieved.

When to use this skill

  • User asks to implement a new feature, plan a feature, or refine a feature scope.
  • User asks to review progress of a feature.
  • User asks to review an existing feature plan's requirements, references, and TODOs.
  • User says a plan is done and should be archived as achieved.

This skill is idea for:

  • Creating/Review feature plans as part of development process.
  • Establish trackable, meaningful feature progress and documentation.
  • Automating the feature development process.

Key Features

  1. Feature Plan Creation
  • Creates properly formatted feature plan documents in doc/plan/{feature-name}-plan.md see template file plan-template.md
  • Writes Plan content to file path: doc/plan/{feature-name}-plan.md
  • Enforces naming conventions, Plan file name format: {feature-name}-plan.md example storage-interface-plan.md
  1. Review Feature Plan
  • Confirms incomplete items, missing references, and TODOs.
  • Modifies requirements and implementation tasks, TODOs.
  • Updates existing feature plan documents with new information.
  1. Feature Plan Archiving
  • Verifies feature plan completeness.
  • Archives completed feature plans, move the plan to doc/plan/archived folder example: doc/plan/archived/{feature-name}-plan.md.

How it Works

  1. Resolve feature name

    • If user provided a name: normalize to kebab-case.
    • If name is ambiguous (e.g., "UI", "storage", "fix bug"): suggest better names and choose one.

  2. Locate plan

    • Check whether doc/plan/{feature-name}-plan.md exists.
    • If not exists: create it from plan-template.md (or inline template if template file not available).
    • If exists: update it (append new info, re-scope, move items between TODO/DONE, keep changelog).

  3. Review Content

    • Fill/refresh: Goals, Non-goals, Requirements, Design, Milestones, Tasks.
    • Capture dependencies, risks, and acceptance criteria.
    • Maintain TODO/DONE lists with checkboxes.

  4. Achieve

    • If TODO is empty and acceptance criteria are met:
      • Move plan file to doc/plan/achieved/ wiht python script archive_plan.py
      python archive_plan.py {feature-name}
      • Add a completion stamp in the plan (date + summary)

Requirements

  • Python 3.7+ for archive_plan.py script.
  • Write access to skill creation plan, and archived folder.
  • Write access to create and update feature plan documents.
  • Read access to feature plan documents.