docs: expose ADRs and consumer guidance as enchiridion snippets - #7023
Draft
ckychris wants to merge 1 commit into
Draft
docs: expose ADRs and consumer guidance as enchiridion snippets#7023ckychris wants to merge 1 commit into
ckychris wants to merge 1 commit into
Conversation
- Kept the whole adr/ directory rather than listing files, so template.md ships as a snippet too; per-file excludes aren't supported inside a directory - ADR 0006 marked Proposed, not Accepted, since the wording isn't agreed with the team yet Co-Authored-By: Claude <noreply@anthropic.com>
Contributor
🛎️ Concierge
|
|
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.
Objective
Our ADRs and agent guidance aren't discoverable through the cultureamp-docs MCP, so agents working in consumer repos can't find kaizen's UI/design decisions. Confirmed in Slack that this needs no enchiridion change, only a
folder_pathsaddition here. Adds ADR 0006 (no animation or interaction before dependent data is ready) so the first regeneration proves the pipeline on a real decision.Scope is deliberately the decisions plus the two docs a consumer needs when writing kaizen code. Proposals, reports and
lsp-vs-grepstay out — they're internal to our team.Decisions
adr/directory infolder_pathsrather than listing files. Cost:template.mdbecomes a snippet, so an agent can retrieve an empty ADR template. Enchiridion has no per-file exclude within a directory, and listing files means a config line per new ADR. (Decision: Chris.)@kaizen/componentsonly, though ADR 0001 also covers tokens. Deferred splitting them across packages until we see how the snippets read.Verifications
file_treesource:.mdis a supported type,folder_pathsaccepts individual files as well as directories, and none of these paths hitSKIP_FILES/SKIP_DIRS.workflow_dispatch). Not verified end to end.🤖 Generated with Claude Code