Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[guidelines] workshop/23-ab-experiments.md: multi-line prompt violates single-sentence prompt rule

Closed Beginner friendly
  • Is something wrong?
#3,589 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
90/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
github-actions
Domain
documentation

Research direction

Edit workshop/23-ab-experiments.md, starting with the multi-line prompt block identified under the Prompt-simplicity rule. Collapse its instructions into one clear sentence while preserving the A/B experiment, compilation, and commit intent. Done means the prompt follows the single-sentence guideline and the surrounding workflow guidance remains intact.

Written by the indexing model from the issue text.

Description

documentation guidelines

File reviewed

workshop/23-ab-experiments.md

Violations

Prompt-simplicity rule (AI agent guidance)

Offending text:

Add an A/B experiment to .github/workflows/daily-status.md.
Use the /agentic-workflows skill.
Set experiments: { output_style: [concise, detailed] }.
Add conditional prompt blocks for concise and detailed.
Run gh aw compile daily-status and fix any errors.
Commit both workflow files.

Suggested fix:
Guidelines require every ```prompt block to be "a single clear sentence... Avoid multi-part instructions, bullet-formatted prompts, or over-engineered phrasing" and let the /agentic-workflows skill handle decomposition. Collapse this six-line, multi-step prompt into one natural sentence, e.g. "Use the `/agentic-workflows` skill to add an A/B experiment to `.github/workflows/daily-status.md` testing concise vs. detailed output style, then compile and commit."

[!WARNING]

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • github.github.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "github.github.com"

See Network Configuration for more information.

Generated by 📋 Guidelines Enforcer · copilot · auto · 162.9 AIC · ⌖ 14.5 AIC · ⊞ 9.1K · ◷

  • expires on Sep 27, 2026, 4:03 AM UTC
Dominant language
JavaScript
Stars
51
Forks
23
Avg merge
10h 14m
Merged PRs (30d)
25

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

  • No Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from githubnext/gh-aw-workshop

All issues in githubnext/gh-aw-workshop

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.