check-gitignore

Plan Cascade - Check and Update .gitignore

This command checks if your project's .gitignore is configured to exclude Plan Cascade temporary files, and updates it if needed.

Why This Matters

Plan Cascade creates various temporary files during planning and execution:

• prd.json, mega-plan.json - Planning documents
• .worktree/ - Git worktree directories
• .plan-cascade-link.json - Project link file
• State files (.agent-status.json, .iteration-state.json, etc.)

These files should NOT be committed to version control because:

1. They are regenerated each session
2. They may contain environment-specific paths
3. They can cause merge conflicts
4. They clutter the repository history

Step 1: Check Current Status

First, check the current state of .gitignore:

uv run python -c "
from plan_cascade.utils.gitignore import GitignoreManager
from pathlib import Path

manager = GitignoreManager(Path.cwd())
result = manager.check()

print('=== .gitignore Status ===')
print()
print(f'File exists: {result.gitignore_exists}')
print(f'Has Plan Cascade section: {result.has_plan_cascade_section}')
print(f'Needs update: {result.needs_update}')
print()

if result.missing_entries:
    print('Missing entries:')
    for entry in result.missing_entries:
        print(f'  - {entry}')
else:
    print('All Plan Cascade entries are present.')
"

Step 2: Update if Needed

If the check shows missing entries, update .gitignore:

uv run python -c "
from plan_cascade.utils.gitignore import GitignoreManager
from pathlib import Path

manager = GitignoreManager(Path.cwd())
result = manager.update()

if result.success:
    if result.action == 'created':
        print('Created .gitignore with Plan Cascade entries')
    elif result.action == 'updated':
        print(f'Updated .gitignore: added {len(result.entries_added)} entries')
    else:
        print('No update needed - all entries already present')
else:
    print(f'Error: {result.message}')
"

Step 3: Show Summary