Regenerate GitHub Issues Skill (DEPRECATED)

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

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