Skip to content

Fix high-priority factual errors across docs#866

Merged
potiuk merged 1 commit into
mainfrom
rbowen-docs-refresh-20260715-02
Jul 15, 2026
Merged

Fix high-priority factual errors across docs#866
potiuk merged 1 commit into
mainfrom
rbowen-docs-refresh-20260715-02

Conversation

@rbowen

@rbowen rbowen commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Six factual errors fixed: stale skill counts in threat model, "proposed" banners on shipped skills, fabricated directory tree in harness guide, wrong CLI syntax in pattern catalogue, and wrong tool path in privacy-llm setup.

Type of change

  • Documentation (docs/, README.md, CONTRIBUTING.md)

Test plan

  • prek run --all-files passes
  • Other: Verified each fix against the actual repo state — tools/agent-guard/ tree via fd, tools/privacy-llm/checker/pyproject.toml entry point, tools/privacy-llm/redactor/pyproject.toml entry points, and skills/*/SKILL.md frontmatter family: fields. Prose-only; no skill behaviour changes.

RFC-AI-0004 compliance

N/A — documentation-only change; no mutations, no tool behaviour, no private content handling.

Linked issues

Notes for reviewers (optional)

The threat-model.md fix adds the three missing skills to their
respective STRIDE family skill lists but does NOT add new STRIDE rows
for them — that's a substantive security analysis task, not a docs
copyedit. A follow-up will add the missing STRIDE coverage.

The process.md change removes 13 *(proposed)* markers from
per-step skill references. All ten release-management skills have
complete SKILL.md files on main.

- security/threat-model.md: "eight skills" → "twelve skills"; add
  security-issue-import-from-scan, security-issue-import-via-forwarder,
  security-issue-triage to STRIDE skill family listings
- release-management/process.md: remove "proposed / no code yet"
  banner and 13 *(proposed)* markers — all 10 skills are shipped
- release-management/spec.md: status "Proposed" → "Experimental"
- adapters/add-a-harness.md: replace fabricated agent_guard/adapters/
  directory tree with the actual src/agent_guard/ layout
- education/pattern-catalogue.md Pattern 5: fix privacy-routing CLI
  (python -m → uv run; --input/--output/--map → piped stdin)
- setup/privacy-llm.md: gate-check path tools/privacy-llm/redactor →
  tools/privacy-llm/checker

@potiuk potiuk left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

NICE!

@potiuk

potiuk commented Jul 15, 2026

Copy link
Copy Markdown
Member

The threat-model.md fix adds the three missing skills to their
respective STRIDE family skill lists but does NOT add new STRIDE rows
for them — that's a substantive security analysis task, not a docs
copyedit. A follow-up will add the missing STRIDE coverage.

The threat-model indeed needs more review.

@potiuk potiuk merged commit 2b1bc43 into main Jul 15, 2026
9 checks passed
@potiuk potiuk deleted the rbowen-docs-refresh-20260715-02 branch July 15, 2026 14:22
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.

3 participants