Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions workflows/shared/formatting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
# Shared content formatting fragment — imported by other fragments
---

## Content Structure

Structure your output with an overview followed by detailed content:

1. **Content Overview**: Start with 1-2 paragraphs that summarize the key findings, highlights, or main points of your report. This should give readers a quick understanding of what the report contains without needing to expand the details.

2. **Detailed Content**: Place the rest of your report inside HTML `<details>` and `<summary>` tags to allow readers to expand and view the full information. **IMPORTANT**: Always wrap the summary text in `<b>` tags to make it bold.

**Example format:**

`````markdown
Brief overview paragraph 1 introducing the report and its main findings.

Optional overview paragraph 2 with additional context or highlights.

<details>
<summary><b>Full Report Details</b></summary>

## Detailed Analysis

Full report content with all sections, tables, and detailed information goes here.

### Section 1
[Content]

### Section 2
[Content]

</details>
`````

## Footer Attribution

**Do NOT add footer lines** like `> AI generated by...` to your comment. The system automatically appends attribution after your content to prevent duplicates.
36 changes: 3 additions & 33 deletions workflows/shared/reporting.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,11 @@
---
# No frontmatter configuration needed - this is a pure instructions file
imports:
- shared/formatting.md
---

## Report Formatting

Structure your report with an overview followed by detailed content:

1. **Content Overview**: Start with 1-2 paragraphs that summarize the key findings, highlights, or main points of your report. This should give readers a quick understanding of what the report contains without needing to expand the details.

2. **Detailed Content**: Place the rest of your report inside HTML `<details>` and `<summary>` tags to allow readers to expand and view the full information. **IMPORTANT**: Always wrap the summary text in `<b>` tags to make it bold.

**Example format:**

`````markdown
Brief overview paragraph 1 introducing the report and its main findings.

Optional overview paragraph 2 with additional context or highlights.

<details>
<summary><b>Full Report Details</b></summary>

## Detailed Analysis

Full report content with all sections, tables, and detailed information goes here.

### Section 1
[Content]

### Section 2
[Content]

</details>
`````
Follow the content structure and formatting guidelines from the imported formatting fragment above.

## Reporting Workflow Run Information

Expand Down Expand Up @@ -74,7 +48,3 @@ When your analysis is based on information mined from one or more workflow runs,
- Choose the most relevant or representative runs (e.g., failed runs, high-cost runs, or runs with significant findings)
- Always use the actual URL from the workflow run data (specifically, use the `url` field from `RunData` or the `RunURL` field from `ErrorSummary`)
- If analyzing more than 3 runs, select the most important ones for references

## Footer Attribution

**Do NOT add footer lines** like `> AI generated by...` to your comment. The system automatically appends attribution after your content to prevent duplicates.