Skip to content

Normalize tool README top-of-file structure#41

Merged
AndrewAltimit merged 1 commit intomainfrom
normalize-tool-readme-structure
Apr 26, 2026
Merged

Normalize tool README top-of-file structure#41
AndrewAltimit merged 1 commit intomainfrom
normalize-tool-readme-structure

Conversation

@AndrewAltimit
Copy link
Copy Markdown
Owner

Summary

  • Replace disclaimer blockquotes with description paragraphs across ~41 tool READMEs
  • Add explicit **Containment** notice (env vars, lab target, ContainmentGuard reference) to every entry-point README that was missing one
  • Fix lowercase and path-prefixed H1 titles (# tools/persistence, # lateral-movement, # edr-killer-class, etc.)
  • Clean up non-standard openings (**Focus:**, **Complement to:**, **Type:**/**Status:** metadata blocks)
  • Collapse now-redundant ## Containment Summary / ## Lab Setup / ## Purpose wrapper sections into the intro paragraph

Convention applied: title -> one-paragraph description -> **Containment** line -> modules/usage.

Test plan

  • CI hygiene checks (check_detection_pairing, check_no_committed_drivers, check_no_real_tenants) -- docs-only change, all pass
  • Markdown link check -- no links added or removed
  • Python/Rust build and tests unaffected

Generated with Claude Code

Apply consistent convention across ~41 tool READMEs:
  title → one-paragraph description → **Containment** notice → modules/usage

Changes:
- Replace disclaimer blockquotes with description paragraphs
- Add explicit **Containment** line to every entry-point README
- Fix lowercase and path-prefixed H1 titles
- Remove redundant Containment/Lab Setup sections now covered upfront
- Remove decorative --- horizontal rules between sections
- Apply to all Rust library crates (consumed by beacon, gated by callers)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@AndrewAltimit AndrewAltimit merged commit cb6b208 into main Apr 26, 2026
2 checks passed
@AndrewAltimit AndrewAltimit deleted the normalize-tool-readme-structure branch April 26, 2026 10:57
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