docs: lead README with governance; remove build-hero + images#124
Merged
stackbilt-admin merged 1 commit intomainfrom Apr 18, 2026
Merged
docs: lead README with governance; remove build-hero + images#124stackbilt-admin merged 1 commit intomainfrom
stackbilt-admin merged 1 commit intomainfrom
Conversation
The repo's identity is already governance-first (description: "Local-first AI agent governance CLI. Modular .ai/ context system (ADF) replaces monolithic CLAUDE.md files."), but the README opened with a `stackbilt run` scaffolding demo and hero image, contradicting the repo's own framing. README changes: - Replace "Your first Cloudflare Workers project shouldn't take a week" hero + Quick Start with governance-first opener using `charter bootstrap`. - Rewrite "What you get" to lead with governance bullets (ADF, metric ceilings, blast/surface analysis, drift/audit, MCP server). Demote the ecosystem-packages table to a one-line inline reference. - Drop the "Free to try — charter login --key ..." line; scaffold auth is moving out and is already env-var-authed (#111). - Reorder Commands: Govern → ADF → Analyze → Build (last). - Flag Build commands as deprecated with a callout pointing at RFC #112 (@stackbilt/build extraction). Image cleanup: - Remove stackbilt-charter-{2,3,4}.png (scaffolding hero series). - Remove ADF_1.png + its reference in packages/adf/README.md. Can be re-added with governance-aligned visuals in a follow-up. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This was referenced Apr 18, 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
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
The repo's own description already reads "Local-first AI agent governance CLI. Modular .ai/ context system (ADF) replaces monolithic CLAUDE.md files." But the README opened with a
stackbilt runscaffolding demo andstackbilt-charter-4.pnghero, contradicting that framing. This PR aligns the README with the repo's identity — governance-first, with scaffolding flagged as deprecated and moving to@stackbilt/build.Changes
README opening
charter runQuick Start with a governance-first opener built aroundcharter bootstrap --yes.Auth line
**Free to try.** \charter login --key sb_live_xxx` ...` — scaffold auth is moving out via RFC RFC: Extract commercial surface from @stackbilt/cli into @stackbilt/build #112 and has already been env-var-authed as of feat(cli): STACKBILT_API_KEY env var auth; deprecate charter login #111.Commands reorder + deprecation
@stackbilt/buildextraction.charter login --keyline annotated with "prefer STACKBILT_API_KEY env var."Image cleanup
stackbilt-charter-{2,3,4}.png(scaffolding hero series — named for the binary that's moving out).ADF_1.pngand its reference inpackages/adf/README.md.What this does not change
charter login,charter run,charter architect,charter scaffoldstill work — they're documented as deprecated, not removed. Removal happens in Charter 1.0 per RFC RFC: Extract commercial surface from @stackbilt/cli into @stackbilt/build #112 Phase 4.Test plan
grep -r 'stackbilt-charter\|ADF_1' --include='*.md'returns zero hits.🤖 Generated with Claude Code