build: add make regen-all (Phase 1, living-docs regen automation)#61
Merged
Conversation
Single command to flush every generated artifact a PR can drift: - regen-templates: attune-author regenerate against root .help/ corpus - build-editor: existing Vite bundle build regen-all = regen-templates + build-editor. Scope per docs/specs/living-docs-regen-automation/ Phase 1: - Root corpus only (sidecar/.help/ has been unmaintained; deferred). - Default polish path (matches current practice; Anthropic cost is real). - No CI hook yet — that's Phase 2. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2 tasks
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
Phase 1 of the living-docs regen automation spec, merged in #60.
Adds two Makefile targets:
regen-templates— wrapsuv run attune-author regenerate --help-dir .helpagainst the root.help/corpus.regen-all— composesregen-templates+build-editorso a single command flushes every artifact a PR can drift.Phase 1 inventory findings
Documented in commit message and Makefile comments; key facts:
/.help/) is actively maintained. Every recent "regenerate sidecar templates" commit touched.help/templates/sidecar/{concept,reference,task}.md. Thesidecar/.help/corpus is unmaintained (4 features stale, longstanding) and is out of scope for this target. Whether to revive or delete it is a separate question.--batch(~50% cost) and a metadata-only mode as escape hatches to investigate.Why not run it now
Running
make regen-allhere would land regenerated template content (currently 1 stale feature) in this PR, mixed with the build-system change. Keeping Phase 1 scope tight: target only, no content drift bundled. The first PR that uses the target proves it works in practice.Test plan
make -n regen-allexpands to the expected commandsuv run attune-author regenerate --dry-run --help-dir .help(the wrapped command) runs cleanly and reports 1 stale featuresidecar/**exercisesregen-templatesend-to-end🤖 Generated with Claude Code