mirror of
https://github.com/morluto/rea.git
synced 2026-11-20 05:32:44 +00:00
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:
3 files changed
+14
-3
No files matched your search
@@ -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
|
||||
|
||||
@@ -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))
|
||||
@@ -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.
|
||||
Reference in new issue
Block a user