Repository navigation
feat(config): layered repo and user config - #9
Merged
Merged
Conversation
Settings lived in one per-repo devline.local.md (plus a user copy that
only the design skill read), so personal preferences had to be repeated
in every repo and project rules sat next to them in an ignored file.
Each key now resolves from the first layer that sets it: the request,
the committed repo file .claude/devline.md, the user file
${CLAUDE_CONFIG_DIR:-~/.claude}/devline/config.md, then the owner
skill's Defaults section. Both files use flat YAML frontmatter plus
optional prose for rules no key can say, such as squash merges.
One shared reference holds the lookup rules, the legacy fallback and
the key table; skills and agents point to it instead of naming a file.
A missing new file falls back to the old devline.local.md, with a
one-time hint to move it.
Keys that nothing read are dropped from the documented set:
frontend_framework, the cve_ branch, commit and push keys, and the
migrate_ keys.
Setup wrote only the per-repo devline.local.md, walking four fixed batches. It now asks which config file to write, lists the keys that usually belong in that layer with their defaults, asks for prose rules, and writes only what differs from the defaults. When a legacy devline.local.md exists without its replacement, setup offers to move it and flags personal settings before they land in the committed repo file. The output-token check moves into the prerequisites step.
The full key tables duplicated the skills and drifted from them. The README now explains the two files and the precedence, shows one example, and links the shared key table.
Fails when a key in the shared table is missing from its owner's Defaults section, when an owner stops pointing to the shared reference, or when any file other than the migration note names the legacy config file. Runs in the validate workflow.
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
Replaces the single
devline.local.mdsettings file with layered config. Each key is resolved separately, in this order:.claude/devline.md(committed)${CLAUDE_CONFIG_DIR:-~/.claude}/devline/config.md## Defaultssectionskills/setup/references/config.md, covers precedence, format and the key table. Every skill and agent that reads config points to it.key: valuefrontmatter plus optional prose. Prose policy, such as "always squash", beats the git skill's defaults.devline.local.mdis read as that layer, and the user is told once to move it. Setup offers the move.frontend_framework,cve_branch_strategyandcve_auto_*, and allmigrate_*keys.Tests
skills/setup/tests/test_config.py, added to CI. It checks that:Try it
Use a throwaway repo with
CLAUDE_CONFIG_DIR=/tmp/devline-cfg/home claude --plugin-dir <this branch>:branch_formatin both files./devline:git commiton main should offer the repo file's branch name.devline.local.md. It should be read, with a one-time hint to move it.