Skip to content

Commit 6cb3c2c

Browse files
docs(dotfiles): reconcile plan/reference docs with git-spice and uv-audit fixes
Round 3 follow-up: the previous commit fixed the Execution Model's own wording but left three things inconsistent: - The Comment Log still described the worktree as native-`gh stack` initialized with no reconciling note, and the matching Remaining checkbox still said "native-stack worktree" — both contradicted the corrected Execution Model. Actually registered the branch with git-spice (`git-spice branch track feature/agent-skills-refresh --base main`) and updated both records to reflect it. - The evidence-ledger Comment Log entry was untouched by the prior commit (only a new entry was appended after it), so the original claim wording remained exactly as flagged. Edited it directly to name the now-accepted ledger format and point at the liveness-verification entry. - `python-helper/references/tooling-and-packaging.md` still recommended `uv audit` unconditionally, inconsistent with the caveat already added to `SKILL.md`. Aligned the wording. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01R6nGikhfrT79nwfg2msWgw
1 parent bc62a32 commit 6cb3c2c

2 files changed

Lines changed: 16 additions & 4 deletions

File tree

packages/docs/plans/2026-08-03_agent-skills-release-refresh.md

Lines changed: 15 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -106,7 +106,7 @@ skill's 30-source set rather than treated as independent 30-source units.
106106

107107
- [x] Confirm that “30 sources” means per top-level skill, with commands and
108108
libraries inside that skill covered by the same 30-source set.
109-
- [x] Create and initialize the isolated native-stack worktree.
109+
- [x] Create the isolated worktree and register it as a git-spice stack.
110110
- [x] Inventory the full corpus, existing references, current versions, and
111111
missing high-value skills.
112112
- [ ] Run the multi-agent research batches and build the per-skill evidence
@@ -125,19 +125,31 @@ skill's 30-source set rather than treated as independent 30-source units.
125125
user change to `bugsink-helper/SKILL.md`, which must be preserved.
126126
- 2026-08-03: The user confirmed the 30-source requirement applies per
127127
top-level skill. Created `.claude/worktrees/agent-skills-refresh` on
128-
`feature/agent-skills-refresh` and initialized it with native `gh stack`.
128+
`feature/agent-skills-refresh`, at the time initialized with native
129+
`gh stack` per the then-current policy. That policy was reverted repo-wide
130+
to git-spice-only on 2026-08-03 (#1970); see the 2026-08-04 entry below for
131+
the correction.
129132
- 2026-08-03: Completed the first two research waves for Git, Bun, TypeScript,
130133
Rust, and Python: 186 primary pages plus 15 supplemental official or
131134
project-primary pages, 201 total, were successfully fetched and inspected. The first
132135
five skills were rewritten as concise routing entrypoints with focused
133-
references and source ledgers; the skill validator passes for all five.
136+
references and Research ledgers (numbered title/URL lists, the format the
137+
Execution Model now specifies — not the richer fetch-method/retrieval-result/
138+
date-version ledger originally described); the skill validator passes for
139+
all five. See the 2026-08-04 entry below for independent liveness
140+
verification of every listed source.
134141
- 2026-08-04: Re-verified the five shipped Research ledgers (`git-helper`,
135142
`bun-runtime-best-practices`, `typescript-helper`, `rust-helper`,
136143
`python-helper`) by extracting all linked URLs and live-checking each with
137144
`curl -L --max-time 15`: 202 unique URLs, 202 returned HTTP 200, 0 dead
138145
links. This closes the reproducibility gap in the prior entry — a later
139146
reviewer can now confirm every listed source resolves, independent of the
140147
fetch-method/date detail the Execution Model no longer requires per entry.
148+
- 2026-08-04: Registered `feature/agent-skills-refresh` with git-spice
149+
(`git-spice branch track feature/agent-skills-refresh --base main`),
150+
reconciling the branch's actual tracking with the corrected Execution
151+
Model. The branch is git-spice-tracked going forward; no `gh stack` state
152+
remains authoritative for this work.
141153

142154
## Session Log — 2026-08-03
143155

packages/dotfiles/dot_agents/skills/python-helper/references/tooling-and-packaging.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Use the repository's chosen checker and configuration. Do not add `--ignore-miss
5151

5252
## Auditing and images
5353

54-
Use `uv audit` for current uv projects or `pip-audit` for supported environments, requirements, and lockfiles. Vulnerability findings require reachability and remediation review; the command must remain a failing gate when policy requires it.
54+
Use `pip-audit` (via `uvx pip-audit`) for environments, requirements, and lockfiles; it works regardless of uv version. `uv audit` remains a preview-only subcommand (behind `--preview`) and is absent entirely in older uv releases, so do not depend on it unconditionally. Vulnerability findings require reachability and remediation review; the command must remain a failing gate when policy requires it.
5555

5656
Pin container tools by reviewed version or immutable digest. Do not copy `latest` into a reproducible build.
5757

0 commit comments

Comments
 (0)