Skip to content

docs(articles): revamp agentic workflow article with technical details#144

Open
lfarci wants to merge 2 commits into
mainfrom
article/agentic-workflow-pr-quality-checks-revamp
Open

docs(articles): revamp agentic workflow article with technical details#144
lfarci wants to merge 2 commits into
mainfrom
article/agentic-workflow-pr-quality-checks-revamp

Conversation

@lfarci
Copy link
Copy Markdown
Owner

@lfarci lfarci commented Apr 3, 2026

Summary

Revamps the agentic workflow PR quality checks article to be more technical and concise. Adds real code samples from the companion repo lfarci/pull-request-quality-checks.

What Changed

  • Trimmed verbose prose: merged intro, removed redundant "Why Intern PRs?", "Why The Workflow Matters", and "Why Shared Skills Matter" sections
  • Added real workflow source YAML front matter snippet (engine:, tools:, safe-outputs:)
  • Added VS Code agent YAML front matter snippet showing trigger phrases
  • Added repository structure tree (.github/ layout)
  • Added 3-step setup section with gh aw compile command
  • Updated checks table from 9 items (A-I) to the actual 6 (A-F) matching the real workflow
  • Linked companion repo in intro and references
  • Added gh-aw CLI reference
  • Updated front matter description and tags

Validation / Tests

Article renders correctly — no build changes required, content-only update.

- Trim verbose prose (merged intro, removed redundant sections)
- Add real workflow source YAML front matter snippet
- Add VS Code agent YAML front matter snippet
- Add repository structure tree
- Add 3-step setup section with gh aw compile command
- Update checks table to match actual 6 checks (A-F)
- Link companion repo prominently in intro and references
- Add gh-aw CLI reference
- Update front matter description and tags

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant