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, 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 it does versus what it was meant to do) and its 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, inherited or brownfield codebase into use cases, bring an existing project under spec-driven development, extract the business rules from existing code, even from a single class or service, or carry the items a baseline review left for later forward.
Pinned to revision a5e959f4838b, 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/use_case_map.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.