docs(openspec): backfill base specs for shipping behavior#324
Merged
Conversation
`openspec/specs/` was empty after the OpenSpec policy adoption (#323), so change proposals had no baseline to diff against. This backfills base specs documenting the CURRENT, already-shipping behavior of the dots CLI. Capabilities: - cli-framework: Cobra entry/command tree, component registry + dispatch, process-exit error model, pkg/run, pkg/path, cli/link, pkg/cache, cli/is - component-install: `dots install` selection, install-all orchestration, and each per-component installer (shell, editor, fonts, packages, languages, macOS defaults, tools, pi.dev) - agent-config-install: `dots install agents` symlinks + idempotent hook and status-line registration in ~/.claude/settings.json - config-update: `dots update` orchestration, weekly auto-clean, `dots clean` - system-doctor: `dots doctor` read-only diagnostics + remediation hints - cli-utilities: the 25 standalone cmd/ binaries Documents current truth (warts included: destructive no-backup symlinks, os.Exit error model). Specs are local docs only — not wired into CI. All six pass `openspec validate --strict`. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
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.
Why
openspec/specs/was empty after the OpenSpec policy was adopted in #323, so future change proposals had no baseline to diff against. This backfills base specs documenting the current, already-shipping behavior of thedotsCLI, its install components, the agents/skills/hooks system, and the standalonecmd/utilities.This is a backfill of existing code, not a change proposal — so it writes directly to
openspec/specs/<capability>/spec.mdwith nochanges/folder.Capabilities
cli-frameworkpkg/run,pkg/path,cli/link,pkg/cache,cli/iscomponent-installdots installselection, install-all orchestration, each per-component installer (shell, editor, fonts, packages, languages, macOS defaults, tools, pi.dev)agent-config-installdots install agentssymlinks + idempotent hook & status-line registration in~/.claude/settings.jsonconfig-updatedots updateorchestration, weekly auto-clean,dots cleansystem-doctordots doctorread-only diagnostics + remediation hintscli-utilitiescmd/binariesNotes
os.Exiterror model, explicit-slice (not reflection) installer dispatch.improve-code-qualitychange proposes to modifycli-framework; this base spec describes what ships today, which that proposal diffs against.openspec validate --strict. Full Pre-Completion Checklist green (build, revive,go test, skill tests, skill linter, agnix 0 errors, qlty clean on changed files).🤖 Generated with Claude Code
Co-Authored-By: Claude noreply@anthropic.com