PROJECT

overview

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

Your project checkout Developer Runs commands, reads the map Driving it from a shell Four commands, one lock file init · sync · status · scan Reading a repository Turns a checkout into facts Python · ast · stdlib Import graph Entry points Infrastructure found Installing in a project Writes it in and remembers Python · hashlib · json Lock file Three-way sync Checks on every change 141 tests on each change pytest · GitHub Actions The coding agent Reads the skills and follows Claude Code legend capability — what it does infrastructure — how it runs integration — outside control — how it is driven feature — inside a block 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