Skip to content

docs(agents): sync agent skills and feature maps with 0.15.0 - #145

Merged
cabljac merged 1 commit into
mainfrom
docs/agent-skills-0-15
Oct 21, 2026
Merged

cabljac merged 1 commit into
mainfrom
docs/agent-skills-0-15

Conversation

@cabljac

@cabljac cabljac commented Oct 20, 2026

Copy link
Copy Markdown
Owner

The agent docs lagged the 0.14.0 DX stack and the 0.15.0 approval gate. The worst gap: approval.md's drive (stage approval on, then off without a TTY) leaves the clone memory at two-person, so every later non-TTY stage in the fixture exits 1 with gate-weakened. pull-request.md's jq .links.pulledPrs printed null. Other stale text: --yes on pull pr, the help strings, the preserve rename, the README "JSON output" pointer, branch-only flags, error codes, refusal reasons, result shapes, the CLAUDE.md command checklist, the verify and managed-commit lists, and the PR template.

This PR fixes all 32 audit gaps. It adds a reset step (rm .git/venfork/approval.json) and fixture drives for a raised level and --force. It adds an approval-gate seam to review-venfork, approval notes to the verify-venfork SKILL.md, and a gotcha. CLAUDE.md now says venfork-config stores only the level. No gap was dropped. I adjusted three: H1 points at help exit-codes, approval.md keeps json-output, and setup needed no new test file.

Possible follow-up, not fixed: the non-GitHub precondition hint venfork stage approval off leads a non-TTY user into gate-weakened.

bun run verify passes. I drove the approval, --force, doctor and pull pr --yes recipes on a fixture through a script file, because sourcing vf.env is blocked.

Not verified: e2e tiers; the How to drive it recipes were not all run end to end; vf_yes TTY paths were not run.

Fix the 32 gaps from the agent-docs audit: the approval.md drive that left the clone memory at two-person, the pull-request.md doctor jq path, the approval-gate review seam, fixture approval notes in verify-venfork, and stale flag, error-code, help and CLAUDE.md text.
@cabljac
cabljac merged commit 93a2d4d into main Oct 21, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant