Improve README opening with stronger value proposition#25
Merged
Alan-Jowett merged 2 commits intomicrosoft:mainfrom Mar 19, 2026
Merged
Improve README opening with stronger value proposition#25Alan-Jowett merged 2 commits intomicrosoft:mainfrom
Alan-Jowett merged 2 commits intomicrosoft:mainfrom
Conversation
Add a compelling hook and value prop paragraph to the README opening: - Hook: 'Agentic prompts are the most important code you're not engineering' - Problem: ad hoc prompts are copy-pasted, untested, inconsistent - Value prop: PromptKit applies software engineering rigor (modularity, reuse, testing, code review) to prompts Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Strengthens the README opening by adding a problem-framing hook and clearer value proposition while keeping the existing subtitle.
Changes:
- Adds a bold hook statement to frame the importance of “agentic prompts”.
- Adds a short problem statement describing common prompt workflow issues.
- Adds a value proposition paragraph explaining PromptKit’s “prompts as code” approach.
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Improves the README opening by adding a stronger hook, problem framing, and a clearer value proposition while keeping the existing subtitle.
Changes:
- Adds a bold “hook” statement to contextualize why PromptKit matters.
- Introduces a short problem statement describing common prompt workflow issues.
- Expands the value proposition to describe PromptKit’s “prompts as code” approach and components.
| Designed for software engineers who design, develop, and debug software. | ||
|
|
||
| **Agentic prompts are the most important code you're not engineering.** | ||
| Every AI-assisted task — investigating bugs, writing requirements, reviewing code — lives or dies by the prompt that drives it. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a compelling hook and value proposition paragraph to the README opening.
Before: Generic one-liner — 'A composable, versioned library of prompt templates.'
After: Problem-framing hook + value prop:
The original subtitle is preserved above the new paragraphs.