Claude Code Plugins

Community-maintained marketplace

Feedback

plan-regenerate-issues

@mvillmow/ProjectOdyssey
8
0

DEPRECATED: The notes/plan/ directory has been removed. Planning is now done directly through GitHub issues. See gh-read-issue-context and gh-post-issue-update skills instead.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name plan-regenerate-issues
description DEPRECATED: The notes/plan/ directory has been removed. Planning is now done directly through GitHub issues. See gh-read-issue-context and gh-post-issue-update skills instead.
mcp_fallback none
category plan
deprecated true

Regenerate GitHub Issues Skill (DEPRECATED)

DEPRECATED: This skill is no longer used. The notes/plan/ directory has been removed. Planning is now done directly through GitHub issues.

See .claude/shared/github-issue-workflow.md for the new workflow.

Replacement Skills

  • gh-read-issue-context - Read context from GitHub issues
  • gh-post-issue-update - Post structured updates to GitHub issues

To Update Issues

Use the GitHub CLI directly:

# Update issue title
gh issue edit <number> --title "New title"

# Update issue body
gh issue edit <number> --body "New body content"

# Add comment
gh issue comment <number> --body "Update message"

Legacy Documentation (for reference only)

Regenerate issue descriptions from updated plans.

When to Use

  • After editing plan.md files
  • Plan structure changes
  • Need to update issue descriptions
  • Before creating new issues

Quick Reference

# Regenerate all issues
python3 scripts/regenerate_github_issues.py

# Regenerate specific section
python3 scripts/regenerate_github_issues.py --section 01-foundation

# Regenerate single component
./scripts/regenerate_single_issue.sh notes/plan/01-foundation/plan.md

Workflow

# 1. Edit plan.md
vim notes/plan/01-foundation/plan.md

# 2. Regenerate github_issue.md
python3 scripts/regenerate_github_issues.py --section 01-foundation

# 3. Review changes
git diff notes/plan/01-foundation/github_issue.md

# 4. Commit both files
git add notes/plan/01-foundation/plan.md
git add notes/plan/01-foundation/github_issue.md
git commit -m "docs: update foundation plan"

Important Rules

Never edit github_issue.md manually

  • Source of truth is plan.md
  • Always regenerate after plan changes
  • Regeneration preserves issue numbers

Script Behavior

The script:

  • Extracts title from plan.md
  • Formats sections for GitHub
  • Preserves issue numbers if already created
  • Updates labels based on phase
  • Maintains hierarchy links
  • Validates output format

Regeneration Options

All Issues

python3 scripts/regenerate_github_issues.py
# Processes all plans in notes/plan/
# Updates all github_issue.md files

Section Only

python3 scripts/regenerate_github_issues.py --section 02-shared-library
# Only processes plans in that section

Single Component

./scripts/regenerate_single_issue.sh notes/plan/01-foundation/02-structure/plan.md
# Regenerates single github_issue.md

Validation After Regeneration

# Validate format
./scripts/validate_issue_format.sh notes/plan/01-foundation/github_issue.md

# Test issue creation (dry-run)
./scripts/create_single_component_issues.py notes/plan/01-foundation/github_issue.md --dry-run

# Check for errors
./scripts/check_issue_format.sh

Error Handling

Error Fix
"Missing plan.md" Create plan.md in component directory
"Invalid title" Ensure title is # Component Name
"Broken links" Fix relative paths in plan.md
"Bad format" Verify all 9 sections present

Scripts Available

  • scripts/regenerate_github_issues.py - Regenerate all issues
  • scripts/regenerate_single_issue.sh - Regenerate one issue
  • scripts/validate_issue_format.sh - Validate format
  • scripts/check_issue_format.sh - Check all issues

References

  • Plan format: CLAUDE.md
  • Related skill: plan-validate-structure for validation
  • Related skill: plan-create-component for creating plans
  • Script docs: scripts/README.md