Workflows to Update
The following workflows generate reports/discussions but don't include markdown style guidelines in their prompts:
| Workflow File |
Issues Found |
.github/workflows/audit-workflows.md |
Missing header level guidelines, no progressive disclosure instructions |
.github/workflows/daily-safe-output-integrator.md |
Missing header level guidelines, no progressive disclosure instructions |
.github/workflows/daily-regulatory.md |
Missing header level guidelines |
Required Changes
For each workflow listed above, update the prompt to include these formatting guidelines (reference: daily-performance-summary.md which already has this):
1. Header Levels
Add instruction: "Use h3 (###) or lower for all headers in your report to maintain proper document hierarchy."
2. Progressive Disclosure
Add instruction: "Wrap long sections in <details><summary>Section Name</summary> tags to improve readability and reduce scrolling."
Example:
<details>
<summary><b>Full Analysis Details</b></summary>
[Long detailed content here...]
</details>
3. Report Structure
Suggest a structure like:
- Brief summary (always visible)
- Key metrics or highlights (always visible)
- Detailed analysis (in
<details> tags)
- Recommendations (always visible)
Design Principles (Airbnb-Inspired)
The updated workflows should create reports that:
- Build trust through clarity: Most important info immediately visible
- Exceed expectations: Add helpful context, trends, comparisons
- Create delight: Use progressive disclosure to reduce overwhelm
- Maintain consistency: Follow the same patterns as other reporting workflows
Example Reference
See .github/workflows/daily-performance-summary.md for a good example of the style instruction pattern:
- **Report Formatting**: Use h3 (###) or lower for all headers in your report to maintain proper document hierarchy. Wrap long sections in `<details><summary>Section Name</summary>` tags to improve readability and reduce scrolling.
Agent Task
Update each workflow file listed in the table above to include the formatting guidelines in the prompt instructions. Test the updated workflows by compiling them to ensure they remain valid.
Generated by Workflow Normalizer · ● 1.1M · ◷
Workflows to Update
The following workflows generate reports/discussions but don't include markdown style guidelines in their prompts:
.github/workflows/audit-workflows.md.github/workflows/daily-safe-output-integrator.md.github/workflows/daily-regulatory.mdRequired Changes
For each workflow listed above, update the prompt to include these formatting guidelines (reference:
daily-performance-summary.mdwhich already has this):1. Header Levels
Add instruction: "Use h3 (###) or lower for all headers in your report to maintain proper document hierarchy."
2. Progressive Disclosure
Add instruction: "Wrap long sections in
<details><summary>Section Name</summary>tags to improve readability and reduce scrolling."Example:
3. Report Structure
Suggest a structure like:
<details>tags)Design Principles (Airbnb-Inspired)
The updated workflows should create reports that:
Example Reference
See
.github/workflows/daily-performance-summary.mdfor a good example of the style instruction pattern:Agent Task
Update each workflow file listed in the table above to include the formatting guidelines in the prompt instructions. Test the updated workflows by compiling them to ensure they remain valid.