Skip to content

Comments

agent: integrate plan-issue workflow into make-task-issue and update issue templates#17

Merged
p-iknow merged 2 commits intomainfrom
i16-agent/enhance-make-task-issue-with-planning
Oct 25, 2025
Merged

agent: integrate plan-issue workflow into make-task-issue and update issue templates#17
p-iknow merged 2 commits intomainfrom
i16-agent/enhance-make-task-issue-with-planning

Conversation

@p-iknow
Copy link
Contributor

@p-iknow p-iknow commented Oct 25, 2025

Requirement

Resolves #16

Integrate the interactive planning workflow from /plan-issue into /make-task-issue to enable comprehensive issue creation with structured context gathering, requirement definition, solution design, and test planning. Standardize all non-bug issue templates to support this new workflow and clarify separation of concerns between the two commands.

Implementation

Agent Command Enhancement

/make-task-issue command:

  • Added editor-based user input collection workflow with structured sections:
    • Context (required): Background and motivation
    • Requirement (required): What needs to be done and expected outcome
    • Solution (optional): Proposed approach or design
    • Constraints (optional): Limitations and considerations
    • Test Plan (optional): Success criteria and validation
  • Implemented AI context gathering stage using Read/Glob/Grep tools to enhance user input with codebase insights
  • Added auto-generated issue title based on requirement analysis
  • Changed from template-based approach to structured body creation using --body flag
  • Added required tools to frontmatter: Read, Glob, Grep, Write
  • Updated documentation with detailed workflow, examples, and error handling

/plan-issue command:

  • Updated to work best with issues created by /make-task-issue
  • Added documentation for expected issue structure (Context, Requirement, Solution, Test Plan, Reference)
  • Clarified separation of concerns:
    • /make-task-issue: Problem definition (Context, Requirement, Solution, Test Plan)
    • /plan-issue: Implementation planning (breaking down into actionable steps)
  • Updated workflow to focus on implementation steps rather than re-doing problem analysis
  • Added "Separation of Concerns" section to Best Practices

Template Standardization

Updated 8 issue templates with unified structure:

  • feat.md, fix.md, doc.md, config.md, refactor.md, agent.md, test.md, perf.md
  • New standardized sections: Context, Requirement, Solution, Test Plan, Reference
  • Removed template-specific fields in favor of unified approach
  • Kept bug.md unchanged (serves different purpose for bug reporting)

Test

  • Verify /make-task-issue command documentation is complete and clear
  • Verify all 8 templates have identical structure (Context, Requirement, Solution, Test Plan, Reference)
  • Verify bug.md template is unchanged
  • Verify /plan-issue documentation clarifies separation of concerns
  • Check markdown formatting in all modified files

Human Check

🤖 Generated with Claude Code

  • I reviewed it

Requirement:
Integrate comprehensive context gathering and requirement analysis into /make-task-issue command to enable well-structured issue creation from the start. Clarify separation of concerns between /make-task-issue (problem definition) and /plan-issue (implementation planning) to eliminate duplication and improve workflow efficiency.

Implementation:
- Added editor-based user input collection workflow with required/optional sections (Context, Requirement, Solution, Constraints, Test Plan)
- Added AI context gathering stage using Read/Glob/Grep tools to enhance user input with codebase insights
- Added auto-generated issue title based on requirement analysis
- Changed from template-based to structured body creation with --body flag
- Updated plan-issue.md to focus on implementation steps from well-structured issues
- Added separation of concerns documentation in both commands
- Added required tools (Read, Glob, Grep, Write) to make-task-issue frontmatter

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@github-actions github-actions bot added the agent Agent rules and commands label Oct 25, 2025
Requirement:
Each issue type (feat, fix, doc, test, perf, refactor) has unique characteristics that don't fit a one-size-fits-all template structure. Generic sections like "Solution" and "Test Plan" are inappropriate for documentation and testing issues.

Implementation:
- Customized templates for type-specific needs:
  - doc: Changed "Solution" to "Content Outline", "Test Plan" to "Verification"
  - test: Changed "Solution" to "Test Scope", "Test Plan" to "Verification"
  - perf, refactor: Changed "Test Plan" to "Verification"
  - fix: Added bug-specific guidance in comments
  - feat, config, agent: Kept standard structure (Context, Requirement, Solution, Test Plan)
- Updated make-task-issue.md to document type-specific sections:
  - Added type-to-section mapping table
  - Added examples for feat, doc, and test types
  - Updated workflow to handle type-specific section names
  - Updated issue body generation with type-specific structures

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@p-iknow p-iknow force-pushed the i16-agent/enhance-make-task-issue-with-planning branch from 1531103 to 72b9f9b Compare October 25, 2025 08:28
@p-iknow p-iknow marked this pull request as ready for review October 25, 2025 08:29
@p-iknow p-iknow merged commit a2ce595 into main Oct 25, 2025
4 checks passed
@p-iknow p-iknow deleted the i16-agent/enhance-make-task-issue-with-planning branch October 25, 2025 08:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

agent Agent rules and commands

Projects

None yet

Development

Successfully merging this pull request may close these issues.

agent: integrate plan-issue workflow into make-task-issue and update issue templates

1 participant