AngryRatLabs.github.io

Source for https://angryratlabs.github.io. MkDocs Material site.

Run it locally

make venv     # create .venv and install requirements
make start    # serve on http://localhost:8885

Content

Most pages are copied from the ai-skills repository, which is the source of truth for them. To pull in changes:

make sync-skills                                  # expects ../ai-skills
AI_SKILLS_DIR=/path/to/ai-skills make sync-skills # or point it somewhere else

Synced pages are overwritten. The five hand-written pages — docs/index.md and the four section overviews — are never touched.

Clean-room check

Nothing derived from a re-workbook/ may reach this site. make check-clean greps docs/ for Ghidra default symbols and image-base addresses and fails if it finds any outside the small allowlist of pages that teach the boundary. It runs in CI before the build, so a leak fails the deploy rather than publishing.

make check-clean
make build        # runs check-clean, then mkdocs build --strict

Deploy

Pushing to main builds and deploys via GitHub Actions (.github/workflows/deploy.yml). No manual step.