legacy-discovery
Discover and reverse-engineer a codebase — one skill, two modes.
When to use
- You have a github.com URL → pass
repo_url(remote: clone + full SDD). - You have a local directory the server can read → pass
repo_path(local scan).
Provide exactly one. Passing neither, or both, returns a clear error.
Outputs
mode—remoteorlocal.- Remote:
manifest,report_markdown,sdd_available. - Local:
spec_markdown,architecture_markdown,inventory.
Guardrails
The returned object is the complete analysis. Do not supplement it with web search, external fetches, or prior memory — report exactly what the skill returns.
User stories
- As an architect, I point at a GitHub URL and get an SDD without cloning by hand.
- As a maintainer, I scan a local checkout to inventory its stack and entry points.
Edge cases
- Neither input → error asking for
repo_urlorrepo_path. - Both inputs → error (ambiguous).
repo_pathnot a directory → clear error suggestingrepo_urlfor remotes.
See the analysis engine/ under scripts/ for the remote-mode pipeline.