trace-my-code is an agent skill: Markdown instructions, templates, and one shell
hook (skills/trace-my-code/hooks/doc-drift.sh). The realistic security surface is:
- the drift hook, which in
rewritemode invokes your local Claude CLI and makes commits, and - the skill prompts, which instruct an agent to read your code and write docs.
It ships no server, no network service, and no runtime dependency to exploit.
Do not open a public issue for security reports. Instead:
- Open a private security advisory, or
- Contact the maintainer at @kgohil.
Please include what you found, how to reproduce it, and the impact. We'll acknowledge within a few days and keep you posted on the fix.
- The drift hook defaults to
flagmode (warns only).rewritemode runs your Claude CLI and creates a commit — review it (git show HEAD) before pushing. - The hook only edits files under
docs/and the governing doc paths; it never touches source. Readreferences/auto-update-contract.mdfor the exact contract. - CI secret-scans every PR (gitleaks) so credentials don't land in history.