chore(release): prep 0.7.0 + agent docs-discovery workflow - #119
Merged
Conversation
…rop beta banner Release prep only; no code changes and no tag pushed here. - CHANGELOG: rename [Unreleased] -> [0.7.0] - 2026-09-03 with a fresh empty [Unreleased] above it, and add an "Upgrading from 0.6.x" section (modeled on 0.6.0's) that surfaces the two breaking changes up front: repeatable flags no longer comma-split and reject an empty occurrence (exit 2), and a negative --limit/--page-size is now a usage error (exit 2). All 14 entries under the release are unchanged. Link references updated (Unreleased -> compare v0.7.0...HEAD; [0.7.0] tag link added). - README: remove the "Beta — stabilizing toward 1.0" banner (moving out of beta). 0.7.0 (minor), not 0.6.1: the release adds new commands (entitlements create, access-profiles, the tasks action family) AND carries two breaking changes. The version itself is build-info-derived from the tag (cmd/version.go -> transport.Version), so nothing in source needs bumping; go.mod stays at major-version 0. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
`docs agents` and the c1i skill described the individual `docs` commands but never gave an agent a single decision tree for WHERE to look. Added one: - a product concept / how-to -> `docs search "<terms>"`, then `docs page <path>` on the best hit for the full page (search returns only a truncated snippet plus a `url` to the public docs); - whether an API endpoint exists or its shape -> `docs endpoints --filter` (a real no-match), then `docs endpoint <path>`; - a task runbook -> `docs guide [<name>]`; - the raw spec -> `docs openapi`. In cmd/agents.md it lands as a new "Finding things in the docs" section and the overlapping mini-list in "Choosing a command" is trimmed to a cross-reference (the docs commands are no longer listed in two places). The c1i skill file carries a compact version, and CHANGELOG [0.7.0] notes it. Integrates with the existing no-relevance-threshold and transport caveats by reference rather than repeating them. Doc-only; no code change. Co-Authored-By: Claude Opus 4.8 <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.
Prep for the 0.7.0 release, plus an agent-facing docs-discovery workflow rolled in. Docs-only; no code changes, and no tag is created here.
Why 0.7.0 (minor), not 0.6.1
[Unreleased]since v0.6.0 both adds new commands (entitlements create,access-profiles, thetasksaction family) and carries two breaking changes — so a patch would be wrong.Release prep
[Unreleased]→[0.7.0] - 2026-09-03(fresh empty[Unreleased]above), an "Upgrading from 0.6.x" section modeled on 0.6.0's that surfaces the two breaking changes first (repeatable flags no longer comma-split + reject an empty occurrence; negative--limit/--page-sizeis a usage error), all 14 entries preserved, link refs updated.cmd/version.go→transport.Version); nothing in source to bump, go.mod stays major-version 0.Agent docs-discovery workflow
docs agentsand the c1i skill described the individualdocscommands but never gave an agent a single decision tree for where to look:docs searchthendocs pagefor the full page (search returns acontentpreview — small for doc pages, large for API-reference hits — plus aurlto the public docs);docs endpoints --filter(real no-match) thendocs endpoint;docs guide; raw spec →docs openapi.Lands as a new "Finding things in the docs" section in
cmd/agents.md(the overlapping mini-list in "Choosing a command" is trimmed to a cross-reference, so the docs commands are listed once), a compact mirror in the skill file, and a[0.7.0]CHANGELOG note.Validation
Three independent Sonnet reviews — release-prep, a whole-file pass over
cmd/agents.md+ the skill (per request, not just the diff), and a wording delta — all clean.docs agentsre-rendered with the new section; everydocscommand verified live. Build, vet, test,-shuffle=on, golangci-lint (0), gosec (0), gitleaks (clean);TestReadmeCommandsResolveAgainstCobraTreeand the agents.md command-resolution guards pass.Cutting the release (separate step — not in this PR)
After this merges, cutting 0.7.0 is a tag on
main: create thev0.7.0tag and publish it, which triggers.github/workflows/release.yaml.🤖 Generated with Claude Code