docs(framework): clarify README pitch, terms, and install list#410
Merged
Conversation
The install-first rework still left a first-time reader with an abstract pitch, undefined Marketplace/Flat terms, a 7-vs-6 plugin count mismatch in the install block, and an asymmetric row in the plugins table. - Ground the pitch in one runnable /aidd-dev:00-sdlc example instead of a list of nouns. - Define Marketplace vs Flat where the compatibility table first uses them, not only inside the Cursor details block. - Note that the Claude Code install list covers the 6 stable plugins (aidd-ui is alpha) so the count matches the header badge. - Pad the aidd-ui table row to three cells like every other row. - Add a FAQ entry answering "why not just write my own skills?", linked from the new pitch.
blafourcade
approved these changes
Jul 9, 2026
blafourcade
pushed a commit
that referenced
this pull request
Jul 10, 2026
* docs(framework): clarify README pitch, terms, and install list The install-first rework still left a first-time reader with an abstract pitch, undefined Marketplace/Flat terms, a 7-vs-6 plugin count mismatch in the install block, and an asymmetric row in the plugins table. - Ground the pitch in one runnable /aidd-dev:00-sdlc example instead of a list of nouns. - Define Marketplace vs Flat where the compatibility table first uses them, not only inside the Cursor details block. - Note that the Claude Code install list covers the 6 stable plugins (aidd-ui is alpha) so the count matches the header badge. - Pad the aidd-ui table row to three cells like every other row. - Add a FAQ entry answering "why not just write my own skills?", linked from the new pitch. * Missing part with aidd-ui, details for claude's commande lineand remove td at the end
Merged
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
2 participants
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.
🎯 What & why
The install-first rework still left a first-time reader with an abstract pitch, undefined Marketplace/Flat terms, a 7-vs-6 plugin count mismatch, and an asymmetric table row small frictions that add up when scanning the README end to end.
🛠️ How it works
/aidd-dev:00-sdlc "..."chained through its real actions (spec → plan → implement → review → ship), matched againstplugins/aidd-dev/skills/00-sdlc/SKILL.mdso the example doesn't drift from the skill.<details>block further down.aidd-uiis alpha) so the count matches the header badge: README.md:64.aidd-uirow to three cells like every other row in the plugins table: README.md:276.🧪 How to verify
README.mdanddocs/FAQ.md: the pitch example, the Marketplace/Flat note, and the plugins table should read correctly with no dangling anchors.Doc-only change, scoped to the points listed above. Other feedback raised during review (star-CTA placement,
next-branch stability messaging) was left untouched those are maintainer/branding calls, not folded into this PR.✅ I certify