docs: roadmap cleanup — README sync, dependency graph, When-to-use sections, verified pnpm-store×nub compat - #94
Merged
Merged
Conversation
The "Features" narrative and "Available Features" table only listed 13 of 21 features. Added the 8 missing ones (helpers4-common, copilot-dev, claude-dev, mistral-dev, cline-dev, nub, bitwarden-secrets-manager, org-workspace) to both sections, matching the existing per-feature format. Closes the "Sync README.md feature list with AGENTS.md / actual src/ tree" roadmap item. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…EADME The feature table was a raw list with no sense of what depends on what, or which combinations are meant to be used together. Added a Mermaid graph built from the actual dependsOn edges (helpers4-common as the implicit base; essential-dev -> typescript-dev -> vite-plus/playwright-dev; node -> nub/playwright-dev; github-dev -> org-workspace), plus 4 ready-to-copy feature blocks: web dev, web dev + E2E, AI pairing, and a multi-repo org bootstrap using org-workspace as the replacement for this org's own .dev repo's hand-written mounts. Closes the "Root README: add dependency diagram and ready-to-copy full stacks" roadmap item. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Roadmap item flagged this feature as missing the "why/alternatives" section that nub, playwright-dev, pnpm-store, essential-dev, and typescript-dev already had. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Roadmap item flagged this feature as missing the "why/alternatives" section that nub, playwright-dev, pnpm-store, essential-dev, and typescript-dev already had. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…ection Roadmap item flagged this feature as missing the "why/alternatives" section that nub, playwright-dev, pnpm-store, essential-dev, and typescript-dev already had. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…ection Roadmap item flagged this feature as missing the "why/alternatives" section that nub, playwright-dev, pnpm-store, essential-dev, and typescript-dev already had. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Roadmap item flagged this feature as missing the "why/alternatives" section that nub, playwright-dev, pnpm-store, essential-dev, and typescript-dev already had. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
angular-dev, auto-header, shell-history-per-project, bitwarden-secrets-manager, and github-dev were bumped for their new "When to use / alternatives" sections. Closes the "Add 'When to use / alternatives' section to feature READMEs that lack one" roadmap item. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Tested directly in a real container: nub install doesn't shell out to the pnpm binary, but it does read the same store-dir/storeDir config pnpm-store writes and hardlinks package content from it (confirmed via matching inodes, and an offline reinstall with nub's own cache wiped that still succeeded from pnpm-store's persisted content). Documents the pairing as supported now that it's actually been verified. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Reciprocal note to nub's README — see that commit for how this was tested. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
…docs Closes the "Test pnpm-store compatibility with nub" roadmap item — verified directly in a real container rather than left undocumented. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Evaluated adding @devcontainers/cli to essential-dev or as a new dedicated feature (per the roadmap item), but ghcr.io/devcontainers-extra/features/ devcontainers-cli already does exactly this — a thin wrapper around `npm install -g @devcontainers/cli`. Per this repo's own add-devcontainer- feature conventions, an existing feature that covers the whole need should be depended on rather than reimplemented, and there's no real value a helpers4-specific version would add here. Documented it in the Testing section instead of building anything. Closes the "devcontainer: exposer le CLI devcontainer via une feature" roadmap item. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
✅ PR Validation Passed
📋 Pipeline Status
🤖 Generated by @helpers4 CI • 2026-09-09 |
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
1 participant
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
helpers4-common,copilot-dev,claude-dev,mistral-dev,cline-dev,nub,bitwarden-secrets-manager,org-workspace) were missing from the public-facing docs while already present inAGENTS.md/src/.dependsOnedges, plus 4 ready-to-copy feature-block stacks (web dev, web dev + E2E, AI pairing, multi-repo org bootstrap).angular-dev,auto-header,shell-history-per-project,bitwarden-secrets-manager,github-dev).nub's compatibility withpnpm-storedirectly in a real container (inode comparison + an offline reinstall withnub's own cache wiped) — confirmednub installhardlinks package content frompnpm-store's shared store instead of duplicating it. Documented the verified finding in both READMEs.@devcontainers/clias a new feature or folding it intoessential-dev— foundghcr.io/devcontainers-extra/features/devcontainers-clialready does exactly this, so pointed to it from the root README instead of reimplementing it.shellcheckjob inpr-validation.yml).Closes 6 items on the
helpers4/1roadmap project's devcontainer backlog.Test plan
jq emptyon every touched manifestnub/pnpm-storecompatibility claim