Skip to content

Refactor PLAN.md template management for better Copilot integration#6821

Draft
Copilot wants to merge 1 commit intodocs-v2-jts-agentic-workflowfrom
copilot/sub-pr-6809
Draft

Refactor PLAN.md template management for better Copilot integration#6821
Copilot wants to merge 1 commit intodocs-v2-jts-agentic-workflowfrom
copilot/sub-pr-6809

Conversation

Copy link
Contributor

Copilot AI commented Feb 12, 2026

Addresses design feedback on #6809 regarding PLAN.md template organization and Copilot usability.

The current implementation embeds the PLAN.md template within .claude/commands/plan.md command documentation. This works but requires parsing markdown to extract the template programmatically.

Recommendation

Extract template to dedicated file:

  • Create .claude/templates/plan-template.md with the canonical template structure
  • Update .claude/commands/plan.md to reference the template file instead of embedding it
  • Maintains current PLAN.md at repo root for testing cleanup workflow

Benefits

  • Programmatic access: Read template directly without markdown parsing
  • Single source of truth: Command docs reference template instead of duplicating content
  • Consistency: Eliminates risk of template drift between documentation and usage
  • Separation of concerns: Commands describe behavior, templates provide structure

Current template structure (from .claude/commands/plan.md lines 48-70):

# [Title]

## Source
- **Repo**: [org/repo](https://github.com/org/repo)
- **Issue**: [#123](https://github.com/org/repo/issues/123)
- **Branch**: `branch-name`
- **Created**: YYYY-MM-DD

## Objective
<!-- What are we trying to accomplish? -->

## Tasks
- [ ] Task 1
- [ ] Task 2

## Notes
<!-- Research, decisions, blockers -->

This refactoring improves Copilot's ability to programmatically create and manage planning documents while maintaining the cleanup workflow testing approach.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI changed the title [WIP] Refactor context and planning file management based on review feedback Refactor PLAN.md template management for better Copilot integration Feb 12, 2026
Copilot AI requested a review from jstirnaman February 12, 2026 17:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants