up-recovering-specs-from-code
Recovers the specifications of an existing system from its code and running behavior: actors from authorization, a use case map from server, front-end and hosted-service entry points grouped by user goal, an entity model from the schema in the project's own words, and use case specifications at the depth the owner chooses (a short baseline for every use case, or full ones where change is coming), written at business level with implementation detail kept out by check. Keeps an evidence ledger and a list of suspect behavior instead of correcting anything, prepares the two-role baseline review (what the system does versus what it was meant to do) and the first change log, and pins current behavior with tests before the first change. Use when the user wants to reverse-engineer, document, baseline or onboard a legacy or brownfield codebase into use cases, bring an existing project under spec-driven development, or extract the business rules from existing code, even from a single class or service.
Pinned to revision aecf4e91025c, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/up-recovering-specs-from-code/SKILL.md
- skills/up-recovering-specs-from-code/references/baseline-review.md
- skills/up-recovering-specs-from-code/references/conventions.md
- skills/up-recovering-specs-from-code/references/evidence.md
- skills/up-recovering-specs-from-code/scripts/check_recovery_ledger.py
- skills/up-recovering-specs-from-code/scripts/relink.py
- skills/up-recovering-specs-from-code/scripts/sample_claims.py
- skills/up-recovering-specs-from-code/scripts/spec_model.py
- skills/up-recovering-specs-from-code/scripts/validate_use_case.py
- skills/up-recovering-specs-from-code/templates/change-log.md
- skills/up-recovering-specs-from-code/templates/recovery-ledger.md
- skills/up-recovering-specs-from-code/templates/suspects.md
- skills/up-recovering-specs-from-code/templates/use-case.md
Every link opens the file at its source, pinned to the revision this page describes.