From d53f87d6d8665ca5ead0184434bead25deceb90b Mon Sep 17 00:00:00 2001 From: morluto <76467478+morluto@users.noreply.github.com> Date: Thu, 19 Nov 2026 20:46:03 -0500 Subject: [PATCH] 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 Co-authored-by: morluto --- docs/development/documentation.md | 9 ++++++++- docs/specs/README.md | 6 ++++++ docs/specs/native/windows-refs/tasks.md | 2 -- 3 files changed, 14 insertions(+), 3 deletions(-) diff --git a/docs/development/documentation.md b/docs/development/documentation.md index bb8817f979..b7dc3efa47 100644 --- a/docs/development/documentation.md +++ b/docs/development/documentation.md @@ -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///`. 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 diff --git a/docs/specs/README.md b/docs/specs/README.md index 351698ef0d..f5092859b9 100644 --- a/docs/specs/README.md +++ b/docs/specs/README.md @@ -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)) diff --git a/docs/specs/native/windows-refs/tasks.md b/docs/specs/native/windows-refs/tasks.md index c993456673..8f287d9bd1 100644 --- a/docs/specs/native/windows-refs/tasks.md +++ b/docs/specs/native/windows-refs/tasks.md @@ -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.