docs: local-llm code-mode + version single-source-of-truth refactor#272
Merged
Conversation
Resolved 3 conflicts in favor of docs/local-llm branch: - docs/archive/spec/ramblings.md: kept TanStack interview answers - docs/claude/INDEX.md: kept concepts-code-mode.md entry - docs/intent/local-llm/vivief-local-llm-intent.md: kept 2026-04-11 revisions Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ain) Add docs/agents/ with issue-tracker (GitHub via gh), triage-labels (default vocabulary), and domain (single-context, ADRs at docs/contract/adr/) consumer rules. Mirror the Agent skills index block into both CLAUDE.md and AGENTS.md. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
version.ts was generated from package.json on prebuild and gitignored, so bumping a version and running tests without a rebuild left it stale and the guardrail test red — a recurring push blocker across packages. Make src/version.ts a committed source file that reads package.json at runtime via createRequire. Drop the generator, the per-package prebuild hook, the gitignore entry, and the CI generation step. Drift is now structurally impossible; package.json stays the single source of truth. Supersedes ADR-0040 with ADR-0052. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
pietgk
changed the title
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
This branch began as local-llm documentation updates and now also carries a build-tooling refactor and the agent-skills setup. Three logical parts:
1. Docs — local-llm & MCP-apps
docs/intent/local-llm/vivief-code-mode-tanstack.md,vivief-code-mode-integration.md,vivief-self-improving-creation-loop.md,vivief-creation-loop-intro.pptxdocs/intent/mcp-apps/mcp-apps-landscape.mddocs/claude/concepts-code-mode.md(+docs/claude/INDEX.mdentry)docs/intent/local-llm/vivief-local-llm-intent.md2. Version single source of truth (ADR-0052, supersedes ADR-0040)
version.tswas generated frompackage.jsononprebuildand gitignored, so bumping a version and running tests without a rebuild left it stale and the guardrail test red — a recurring push blocker.src/version.tsis now a committed source file that readspackage.jsonat runtime viacreateRequire— drift is structurally impossible.scripts/generate-version.mjs), the per-packageprebuildhook, the.gitignoreentry, and the CI "Generate version files" step.3. Agent-skills setup
docs/agents/{issue-tracker,triage-labels,domain}.md+ an## Agent skillsindex block inCLAUDE.mdandAGENTS.md.Changelog
Changesets-based.
.changeset/version-from-package-json.mdrecords apatchacross all 9 publishable packages for the version refactor; the per-packageCHANGELOG.mdfiles are generated by the release flow on merge tomain. Docs-only commits need no changeset.Test plan
pnpm typecheck— 15/15 tasks passversion.test.tsand thedevac --versione2e test🤖 Generated with Claude Code