Plan Management

Conventions for .devloop/plan.md file format and updates.

Plan Location

Primary: .devloop/plan.md

Plan Format

# Devloop Plan: [Feature Name]

**Created**: YYYY-MM-DD
**Updated**: YYYY-MM-DD HH:MM
**Status**: Planning | In Progress | Complete
**Issue**: #123 (https://github.com/owner/repo/issues/123) (optional, if started from GH issue)
**Branch**: feat/feature-name (optional)
**PR**: https://github.com/.../pull/123 (after PR created)

## Overview

Brief description of the plan.

## Phase 1: [Phase Name]

- [ ] Task 1.1: Description
  - Acceptance: Criteria
  - Files: Expected files

## PR Feedback (after review)

PR #123 - @reviewer (CHANGES_REQUESTED)

### Blockers
- [ ] [PR-123-1] Fix issue (@reviewer)

### Suggestions
- [ ] [PR-123-2] Consider alternative (@reviewer)

## Progress Log
- [timestamp]: Event

Task Markers

PR Feedback Task IDs

Format: [PR-{number}-{item}]

Example: [PR-123-1] = First feedback item from PR #123

Parallelism Markers

• [parallel:A] - Can run with other Group A tasks
• [depends:N.M] - Must wait for Task N.M

Update Rules

1. Mark tasks in progress: - [~]
2. Mark tasks complete: - [x]
3. Add Progress Log entry
4. Update timestamps
5. Add PR link after PR creation
6. Add PR Feedback section after review
7. Add Issue link if started from GitHub Issue

GitHub Issues Integration

When using issue-driven development (configured in local.md):

Starting from Issue

Use /devloop:plan --from-issue 123 to fetch issue details and create a plan with:

• **Issue**: #123 (URL) in the header
• Issue title becomes plan title
• Issue body provides context for planning

On Plan Completion

When all tasks are [x] and Issue is linked:

1. Generate completion summary (tasks done, time elapsed)
2. Post summary as comment on the issue
3. Optionally close the issue (based on github.auto-close setting)

Issue Reference Format

**Issue**: #123 (https://github.com/owner/repo/issues/123)

The number after # is parsed by archive-plan.sh for GitHub integration.