## Description The Quick Start guide jumps directly into installation steps without explaining what users will build or why. Beginners don't understand the purpose of the example workflow before installing it. ## Problem **Current Experience**: Step 2 asks users to run `gh aw add githubnext/agentics/daily-repo-status` without explaining: - What "agentics" is - Why we're pulling from a different repository - What the workflow does before installing it - How to verify it worked **Impact**: Beginners feel confused ("Is this a typo? Why isn't this in gh-aw docs?") and lack context about what they're installing. ## Suggested Changes Add a "What You'll Build" section at the top of the Quick Start guide (before Step 1): ```markdown ## What You'll Build In this tutorial, you'll install a **daily repository status workflow** that: - Automatically runs every morning at 9 AM - Analyzes your repository's health (open issues, PRs, recent commits) - Posts a summary report as a GitHub Discussion This example demonstrates how agentic workflows work: you write instructions in plain English, and an AI agent executes them automatically. The workflow comes from the [githubnext/agentics](https://github.com/githubnext/agentics) repository, which contains community-contributed workflow templates you can install with a single command. ``` ## Files Affected - `docs/src/content/docs/setup/quick-start.md` (add before Step 1) ## Success Criteria - New section explains what users will build and why - Clarifies the "agentics" repository reference - Sets expectations about workflow behavior - Takes 2-3 minutes to read - Reduces beginner confusion about tutorial purpose ## Source Extracted from [Documentation Noob Test Report discussion #12885](https://github.com/githubnext/gh-aw/discussions/12885) ## Priority **High** - Critical for new user onboarding and understanding ## Estimated Effort 10 minutes <!-- gh-aw-tracker-id: discussion-task-miner --> > AI generated by [Discussion Task Miner - Code Quality Improvement Agent](https://github.com/githubnext/gh-aw/actions/runs/21542110507) > - [x] expires <!-- gh-aw-expires: 2026-02-14T09:08:33.282Z --> on Feb 14, 2026, 9:08 AM UTC <!-- gh-aw-agentic-workflow: Discussion Task Miner - Code Quality Improvement Agent, gh-aw-tracker-id: discussion-task-miner, engine: copilot, run: https://github.com/githubnext/gh-aw/actions/runs/21542110507 --> <!-- gh-aw-workflow-id: discussion-task-miner -->