Repository navigation
Claude first: the library as the vibe plugin, the design method retired, AGENTS.md at 50 lines - #94
Merged
Merged
Conversation
The installed design method goes: its per-project config, the CI job that ran its detector and the renders row that named it. The renders class is answered honestly as a manual browser walkthrough before a release, with a defer marker that names the upgrade trigger (a screenshot check in CI). What still refers to the method in the framework layer is retired in the commits that follow. Traces-to: explicit request: remove impeccable from Groundwork Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AYLQAo8KDkwopGjTZiK2Af
The installed method is gone from the checks and the docs: the enforcement signal that read its version, the stack gate that looked for its detector, the third-party declaration in checks/config.json, the ignore rules for its payload, and every mention in DESIGN.md, PRODUCT.md, the manifest and the global standards. Decision 0023 records why and supersedes 0020; the word is in the denylist so it cannot return by habit. Traces-to: explicit request: remove impeccable from Groundwork Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AYLQAo8KDkwopGjTZiK2Af
The skills move from .agents/skills to plugins/vibe/skills, with a marketplace manifest at the root so one install per machine brings them into any repository. .agents/skills stays as a symlink into the plugin, so the framework's own sessions and the adoption drill keep one path. What changed on the way: start and handoff are new (handoff folds in checkpoint and handover); calibrate, critical-thinking, scope-guard, design-guard, ingest and skill-author are folded into the skills that used them or retired; begin, deliver, maintain and start carry disable-model-invocation so their bodies cost nothing until the owner runs them; code-review hands its axes to three review agents on Sonnet; hooks.json wires the guard and echoes the handoff block after a compaction; four eval cases cover the promises the plugin makes. The skills gate reads the plugin directory and no longer asks AGENTS.md for a registration. Decision 0024 records the route and the two deferrals. Traces-to: explicit request: Claude first, the library as a global plugin Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AYLQAo8KDkwopGjTZiK2Af
The rulebook goes from 141 lines to 50: the session protocol, four hard rules, the map of where everything lives and the conflict rule. The decision ladder moves to docs/standards/GLOBAL.md beside the floors it belongs with, the skills table is gone because the plugin manifest is the registry, and the efficiency section is gone because start and handoff carry it. The Gemini bridge and its gate leave with decision 0024: Claude Code is the tool, and the one-line CLAUDE.md bridge stays. Traces-to: explicit request: Claude first, the library as a global plugin Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AYLQAo8KDkwopGjTZiK2Af
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.
What this does
Four commits that turn the audit decisions of 2026-10-10 into code:
fdf52b2): its config, the CI detector job and therendersrow that named it;rendersis now a manual walkthrough with adefer:marker.805c84b): enforcement signal, stack gate, third-party declaration, ignore rules, docs. Decision 0023 supersedes 0020; the word is denylisted.vibeplugin (bd82b8a):plugins/vibe/with 14 skills (startandhandoffnew;checkpoint,handover,calibrate,critical-thinking,scope-guard,design-guard,ingest,skill-authorfolded in or retired), three review agents on Sonnet,hooks.json(guard plus the handoff echo on compaction), four eval cases, and a marketplace manifest at the root..agents/skillsis a symlink into the plugin. Decision 0024.6a9dcb5): session protocol, four hard rules, the map, the conflict rule. The decision ladder moves todocs/standards/GLOBAL.md; the Gemini bridge and its gate are gone.Proof
node checks/check.mjs: green, 22 gates.node checks/drill.mjs: a fresh copy reaches a governed first commit (162 files, symlink intact).claude plugin validate ./plugins/vibeandclaude plugin validate .: pass; the one warning is the deliberately omitted plugin version (no version means every commit onmainis an update).Not in this PR (recorded as DEBT-004 and DEBT-005, decision 0024)
checks/guard.mjsexists twice (project hooks and plugin hook) until the drill and the enforcement line read the plugin's copy.beginwill drop the.claude/skillssymlink when the plugin is present.After merge
Then from
plugins/vibe/:claude plugin eval . --scaffold --allow-tools Write Edit "Bash(git *)" "Bash(node *)" "Bash(npm test *)".🤖 Generated with Claude Code
https://claude.ai/code/session_01AYLQAo8KDkwopGjTZiK2Af
Generated by Claude Code