docs(specs): index unlisted feature records and define when a record is required (#12650)

List the six feature records missing from the spec index, drop the open
ReFS owner-review task now that admission is on main, and state when a
record is required.

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
Co-authored-by: morluto <morluto@users.noreply.github.com>
This commit is contained in:
authored and GitHub committed 2026-11-19 20:46:03 -05:00
1 parent e532d746f0
commit d53f87d6d8
3 files changed
+14 -3

No files matched your search

+8 -1
View File
@@ -34,11 +34,18 @@ moving it into `specs/`.
## Feature lifecycle
Create a feature record before implementation when the change adds a new MCP
tool or CLI command, a new provider lane or format reader, or a new public
contract. A bug fix inside an existing contract does not require a record.
Records nest under `docs/specs/<domain>/<slug>/`. Every new record gets a
`docs/specs/README.md` entry in the same pull request.
Create the specification before implementation. Each feature directory contains:
- `spec.md`: problem, desired behavior, requirements, acceptance and non-goals.
- `plan.md`: the single implementation plan, contracts and architectural choices.
- `tasks.md`: incremental, testable steps linked to requirements and verification.
- `tasks.md`: incremental, testable implementation and verification steps linked
to requirements. Do not record pull-request process or review steps.
Split independent domains or separately reviewable features before writing their
specs. A broad `ROADMAP.md`, when useful, only lists child specifications, order
+6
View File
@@ -46,3 +46,9 @@ for new work, roadmap granularity and producer-owned contracts.
- [CycloneDX dependency view](analysis-views/cyclonedx-dependencies/spec.md) ([plan](analysis-views/cyclonedx-dependencies/plan.md), [tasks](analysis-views/cyclonedx-dependencies/tasks.md))
- [NuGet package inspection](artifacts/nuget-nupkg/spec.md) ([plan](artifacts/nuget-nupkg/plan.md), [tasks](artifacts/nuget-nupkg/tasks.md))
- [Recoverable analysis budgets](analysis/recoverable-budgets/spec.md) ([plan](analysis/recoverable-budgets/plan.md), [tasks](analysis/recoverable-budgets/tasks.md))
- [Per-call EVM producer budgets](evm/producer-limits/spec.md) ([plan](evm/producer-limits/plan.md), [tasks](evm/producer-limits/tasks.md))
- [Android OTA payload inspection](firmware/android-ota-payload/spec.md) ([plan](firmware/android-ota-payload/plan.md), [tasks](firmware/android-ota-payload/tasks.md))
- [Windows ReFS filesystem authority](native/windows-refs/spec.md) ([plan](native/windows-refs/plan.md), [tasks](native/windows-refs/tasks.md))
- [Historical capture admission budgets](web/historical-capture-budgets/spec.md) ([plan](web/historical-capture-budgets/plan.md), [tasks](web/historical-capture-budgets/tasks.md))
- [Per-call source-map budget recovery](web/source-map-budget-recovery/spec.md) ([plan](web/source-map-budget-recovery/plan.md), [tasks](web/source-map-budget-recovery/tasks.md))
-2
View File
@@ -9,5 +9,3 @@
- [x] Complete final source, documentation, artifact, package, native, Ghidra and
original ReFS CLI verification on the same revision.
- [x] Review and synchronize the branch, then create a Draft PR linked to #289.
- [ ] Obtain human-owner review and readiness declarations before requesting
maintainer review; do not merge on the owner's behalf.