Skip to content

docs(plan): add cross-repo epic guidance to plan command prompt#1008

Merged
acreeger merged 1 commit into
mainfrom
docs/plan-prompt-cross-repo-epics
Apr 28, 2026
Merged

docs(plan): add cross-repo epic guidance to plan command prompt#1008
acreeger merged 1 commit into
mainfrom
docs/plan-prompt-cross-repo-epics

Conversation

@acreeger
Copy link
Copy Markdown
Collaborator

Summary

  • Adds a new "One Epic Per Repo for Cross-Repo Work" core principle to `templates/prompts/plan-prompt.txt`.
  • Tells the planner to identify the repos involved, ask per-repo where each epic should be filed (trackers/projects may differ across repos), and offer two paths via AskUserQuestion:
    • Option A: create epics + children for every repo in this session (faster, contracts coordinate cross-repo).
    • Option B: create only the epics now, then re-run `il plan ` per repo (most accurate decomposition, but slower and requires more user effort).
  • Reinforces: never create blocking dependencies across repos — coordinate via shared contracts in epic bodies and a sequencing recommendation in the ADR comment.

Test plan

  • Manual: run `il plan` on a cross-repo feature and verify the planner now offers the two options instead of trying to fold everything into one epic.

Adds a "One Epic Per Repo for Cross-Repo Work" core principle to plan-prompt.txt: identify the repos involved, ask per-repo where each epic lives (trackers may differ), and offer two paths — create epics + children for every repo in this session, or just create the epics now and re-run the planning process per repo (slower but most accurate). Also reminds the planner not to create cross-repo blocking dependencies and to coordinate via shared contracts instead.
@acreeger acreeger merged commit 8873e1a into main Apr 28, 2026
4 checks passed
@acreeger acreeger deleted the docs/plan-prompt-cross-repo-epics branch April 28, 2026 15:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant