Skip to content

docs: minor fixes & expands future directions#2165

Open
mnkiefer wants to merge 11 commits intotoken-efficiency-paperfrom
mnkiefer/token-efficienty-review
Open

docs: minor fixes & expands future directions#2165
mnkiefer wants to merge 11 commits intotoken-efficiency-paperfrom
mnkiefer/token-efficienty-review

Conversation

@mnkiefer
Copy link
Copy Markdown

@mnkiefer mnkiefer commented Apr 23, 2026

  • Minor fixes/ typos & standardized tense: past for the work and findings, present for general truths.
  • Added workflow links.
  • Expanded "What's next" with discussion of future directions for system- & portfolio-level optimization.

@github-actions

This comment has been minimized.

@github-actions

This comment has been minimized.

@github-actions

This comment has been minimized.

@mnkiefer mnkiefer changed the title docs: clarifications and review on token efficieny [WIP] docs: clarifications and review on token efficieny Apr 23, 2026
Co-authored-by: Copilot <copilot@github.com>
@github-actions

This comment has been minimized.

This was referenced Apr 24, 2026
@github-actions

This comment has been minimized.

@mnkiefer mnkiefer self-assigned this Apr 24, 2026
@github github deleted a comment from github-actions Bot Apr 24, 2026
Co-authored-by: Copilot <copilot@github.com>
@github github deleted a comment from github-actions Bot Apr 24, 2026
@github github deleted a comment from github-actions Bot Apr 24, 2026
@github github deleted a comment from github-actions Bot Apr 24, 2026
@github github deleted a comment from github-actions Bot Apr 24, 2026
@github github deleted a comment from github-actions Bot Apr 24, 2026
mnkiefer and others added 2 commits April 24, 2026 08:03
Co-authored-by: Copilot <copilot@github.com>
@mnkiefer mnkiefer changed the title [WIP] docs: clarifications and review on token efficieny docs: minor fixes & epands future directions Apr 24, 2026
@mnkiefer mnkiefer changed the title docs: minor fixes & epands future directions docs: minor fixes & expands future directions Apr 24, 2026
@mnkiefer mnkiefer marked this pull request as ready for review April 24, 2026 06:53
@mnkiefer mnkiefer requested a review from Mossaka as a code owner April 24, 2026 06:53
@mnkiefer mnkiefer requested review from Copilot and lpcox April 24, 2026 06:53
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Polishes and expands the token-efficiency blog post draft, aiming to fix wording/tense and add more detailed future directions around system- and portfolio-level optimization.

Changes:

  • Refines wording for clarity and tense consistency across the draft.
  • Reworks descriptions of token-usage logging and optimization workflows.
  • Expands “What’s next?” with system-level “episode” framing and portfolio-level optimization opportunities.
Show a summary per file
File Description
scripts/paper/blog-post-draft.md Copy edits throughout and expanded “What’s next?” section to discuss broader optimization directions.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comments suppressed due to low confidence (3)

scripts/paper/blog-post-draft.md:18

  • Typo: “againts” → “against”.
The repositories that build GitHub Agentic Workflows use agentic workflows for their own CI. Those workflows include [Auto-Triage Issues]() workflow for labeling new issues, a [Contribution Check]() for auditing new pull requests againts contributor guidelines, [Test Quality Sentinel]() for reviewing test depth on every ready-for-review PR, [Glossary Maintainer]() for keeping documentation in sync with code changes, and three daily quality checks: [Daily Syntax Error Quality](), [Daily Compiler Quality](), and [Daily Community Attribution](). These run on production hardware against production API rate limits.

scripts/paper/blog-post-draft.md:34

  • [**Daily Token Optimizer**]() has an empty link target. Please add the intended URL or remove the link markup until it’s available.
A [**Daily Token Optimizer**]() goes further. When the Auditor flags a heavy workflow,it examines the workflow's source and recent run logs, then creates a new issue decribing concrete inefficiencies and recommended changes. It has consistently found inefficiencies that we had missed.

scripts/paper/blog-post-draft.md:34

  • Missing space after comma in “workflow,it”; should be “workflow, it”.
A [**Daily Token Optimizer**]() goes further. When the Auditor flags a heavy workflow,it examines the workflow's source and recent run logs, then creates a new issue decribing concrete inefficiencies and recommended changes. It has consistently found inefficiencies that we had missed.
  • Files reviewed: 1/1 changed files
  • Comments generated: 6

Comment thread scripts/paper/blog-post-draft.md Outdated
Comment thread scripts/paper/blog-post-draft.md Outdated
Comment thread scripts/paper/blog-post-draft.md Outdated
Comment thread scripts/paper/blog-post-draft.md Outdated
Comment thread scripts/paper/blog-post-draft.md Outdated
Comment thread scripts/paper/blog-post-draft.md Outdated
@mnkiefer
Copy link
Copy Markdown
Author

mnkiefer commented Apr 24, 2026

@lpcox Wonderful work! ❤️ Just a few minor suggestions (mostly optional and based on language preferences) and I've expanded the "What’s next" section as discussed.

I also added the workflow links (if people want to check them out and reuse), though we might want to think about moving them into githubnext/agentics.

@github-actions

This comment has been minimized.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@github-actions

This comment has been minimized.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@github github deleted a comment from github-actions Bot Apr 24, 2026
@github-actions

This comment has been minimized.

mnkiefer and others added 2 commits April 24, 2026 09:28
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@github-actions

This comment has been minimized.

@github github deleted a comment from github-actions Bot Apr 24, 2026
@github github deleted a comment from github-actions Bot Apr 24, 2026
@github github deleted a comment from github-actions Bot Apr 24, 2026
@github github deleted a comment from github-actions Bot Apr 24, 2026
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.

2 participants