📝[Enhancement]: Add structured reporting during the process

[MariusStorhaug]

Description

This pull request updates the workflow prompts for the GitHub automation scripts to improve user communication and reporting. The main change is that each major phase (specification, clarification, planning, task generation, and analysis) now posts a clear status comment to the GitHub issue, summarizing progress and next steps for users. Additionally, the analysis and clarification steps now produce more structured, readable markdown reports.

Key improvements include:

User Communication Enhancements:

• Each major workflow step (specify, clarify, plan, tasks, analyze) now posts a standardized status comment to the issue, clearly indicating completion and next recommended actions. [1] [2] [3] [4] [5]

Analysis and Clarification Reporting:

• The analysis step now posts a detailed markdown comment with tables grouped by severity, a summary, and explicit next actions, making findings easier to review and act upon.
• The clarification step now posts a markdown summary table of questions and answers if any were asked, improving traceability of clarifications.

Process and Flow Improvements:

• The planning step now checks for clarifications before proceeding, pausing if ambiguous areas remain and instructing the user on how to resolve them.
• Each phase's reporting is reorganized to ensure the status comment is posted before the detailed completion report, improving user guidance and flow. [1] [2] [3]

These changes collectively make the workflow more transparent, actionable, and user-friendly.

Type of change

• 📖 [Docs]
• 🪲 [Fix]
• 🩹 [Patch]
• ⚠️ [Security fix]
• 🚀 [Feature]
• 🌟 [Breaking change]

Checklist

• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas

[Copilot]

Pull Request Overview

This pull request enhances the GitHub automation workflow by adding structured status comments and improved reporting at each major phase. The primary goal is to improve user communication and workflow transparency by providing clear progress updates and actionable next steps.

• Added standardized status comments for each workflow phase (specify, clarify, plan, tasks, analyze)
• Enhanced analysis and clarification steps with structured markdown reports including tables and summaries
• Improved process flow with better user guidance between phases

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
.github/prompts/tasks.prompt.md	Added final status comment indicating task completion and next actions
.github/prompts/specify.prompt.md	Added completion status comment for specification phase
.github/prompts/plan.prompt.md	Added completion status comment for planning phase
.github/prompts/clarify.prompt.md	Added structured markdown table for clarification summaries
.github/prompts/analyze.prompt.md	Added comprehensive issue comment with severity-based tables and analysis summary

[Copilot]

Pull Request Overview

Copilot reviewed 7 out of 8 changed files in this pull request and generated 1 comment.