docs(framework): streamline README, add recipes, extract marketplace doc#280
Merged
Conversation
Rework the README to a lean landing page: who we are + contact, a supported-tools table (Claude Code recommended), a quick start centered on /aidd-context:00-onboard and the dev flow, plugins, recipes, and a trimmed docs index. 343 -> 193 lines. Move marketplaces / scopes / versioning / LLM-tier reference out of the README into docs/MARKETPLACE.md (linked, no duplication). Add recipes/ as task-oriented how-to sheets: an index plus recipes/mcp_installation.md (migrated from the README MCP section), whose shape doubles as the de-facto recipe template. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…TA, less emoji Drop the Claude-Code-only framing and the top nav links. Trim section emoji. Make the community section a Discord/training CTA (remove personal links). Add a real Installation section explaining marketplace (recommended) vs flat archives per tool. Redraw the flow as a top-down diagram with a concrete example. Reduce the Documentation table to the docs/ folder only (GitHub surfaces root community files natively). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
A stray copy of the cook skill (which belongs to PR #281) had leaked into plugins/ and the count hook picked it up, inflating the README to 38/13. This PR adds no skill — restore 37 skills / aidd-context 12. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…pe table, mermaid styling Add emojis to section titles, link the GitHub releases page, turn the install/quick-start explanations into short numbered lists, give Recipes a two-column table, and bold the skill commands in the flow diagram with a green "tested · shipped" end node. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…per community & contributing Add a compatibility matrix up top (Gemini/Mistral marked in progress). Expand non-Claude install into detailed per-tool steps (Copilot, Codex, Cursor, OpenCode) and drop the unneeded flat/tier note. Recommend installing all plugins. Mention /cook in Recipes. Make the community section a who-we-are pitch with a training CTA (drop the socials line), and the contributing section more inviting with a Core Team note. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…th release links Adopt the "Vibe Coding for professional developers" tagline and a marketplace-focused intro with an SDLC-orchestration tffline. Add a compatibility note (Claude Code first, others ensured). Collapse the non-Claude installs into <details> (Claude Code stays fully visible), each with a link to the release asset. Fix the programme/ecosystem links. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Rename recipes/mcp_installation.md -> recipes/mcp-installation.md (kebab, consistent with repo conventions and the /cook upsert slug), fix links, and add emoji + numbered steps to match the recipe template. Also ignore .claude/worktrees/ so agent worktrees never get committed again. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
alexsoyes
force-pushed
the
docs/readme-refacto
branch
from
d7adb58 to
69f968f
Compare
…ity table Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…en recipe, link roadmap Move a one-line "who we are" into the intro block (3y R&D, 500+ devs, 100% AI code) and keep Community to the CTAs only. Remove the "Built for Claude Code" badge (mixed signal vs multi-tool). Drop the not-yet-written token recipe row. Link the roadmap from the contributing note. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…ing, drop /cook note Move the Discord/training/ecosystem CTAs into three bullets right under who-we-are and remove the now-duplicate Community section. Trim Contributing to issues/discussions + Discord (keeping the roadmap CTA and the Core Team note). Drop the /cook line from Recipes. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
… | Level) Make recipes/README.md use the same Goal column /cook's list emits and upsert maintains, sourced from the recipe's `> **Goal:**` line, so the index, the list output, and the recipe never drift. Capitalize the Goal. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
… "in France" Align the recipe title and index with the README table (plural), and remove the "(in France)" aside from who-we-are (the badge and footer already say it). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
blafourcade
approved these changes
Jun 16, 2026
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
Rework the README into a lean landing page and introduce a
recipes/cookbook.README
/aidd-context:00-onboard+ a top-down flow diagram (idea → tested, shipped PR)docs/-only documentation tableMoved out (no duplication)
docs/MARKETPLACE.md— marketplaces, install scopes, versioning, LLM tier reference (was inline in the README)Recipes (new)
recipes/README.md— indexrecipes/mcp-installation.md— "MCP installations" (migrated from the README MCP section); its shape doubles as the de-facto recipe templateCompanion PR
/cookskill (list/upsertrecipes) + canonical recipe template. Merge together with this PR.🤖 Generated with Claude Code