PROJECT

overview

One sentence on what this project does, in the language of its users.

Project name What the whole thing is for, in one line. Reading a repository capability Turns a checkout into facts nobody guessed Python · ast · stdlib Installing into a project capability Writes the content in and remembers what it wrote Python · hashlib · json The coding agent integration Reads the installed skills and follows them Claude Code Checks on every change infrastructure 141 tests, run on each pull request pytest · GitHub Actions Driving it from a terminal control Four commands: init, sync, status, scan Import graph tests/test_scan.py · 19 cases legend capability — something the project does infrastructure — how it is run and checked integration — a system outside this repo control — how it is driven from outside contains uses

Ways in

  • specrun — console script, src/specrun/cli.py
  • /specrun:map — skill, called in chat

Outside systems

  • Claude Code — reads .claude/skills
  • PyPI — release channel

Running and checking

  • pytest — 141 tests
  • .github/workflows/ci.yml — on every pull request