Close the completed initial planning checklist

This commit is contained in:
2026-10-07 18:26:22 +00:00
parent 6c04dceb85
commit b98845bae9
2 changed files with 21 additions and 24 deletions

View File

@@ -1,30 +1,25 @@
# Preparing the initial CommandKit feature roadmap
Status: roadmap review complete; ready to prepare the staged implementation plan.
Status: roadmap preparation and implementation-plan handoff complete.
Date: 2026-10-07.
Progress is recorded in [the initial roadmap](initial.md). Roadmap review selected
the delivery scope, typed API/outcome model, selectors/report behavior, and full
profile coverage including `ExtraParams`. Exact Go declarations will be specified
in the staged implementation plan using those selections. Checked entries record
completed planning work; the staged plan remains the next deliverable.
The [feature roadmap](initial.md) records the selected initial target and its
completion. The [implementation plan](implementation.md) was prepared from that
review and has been executed. Checked entries below record the completed
preparation process; they are not assignments to restart planning.
## Purpose and use
## Historical preparation process
Use this checklist to prepare `docs/roadmap/initial.md`, which will describe the
targeted end state of CommandKit's initial implementation: its packages, features,
integration contracts, and ownership boundaries. After reviewing that roadmap,
use it to prepare a separate, ordered implementation plan for a Luna agent.
Work through the sections below in order. Check an item when its result is
recorded in the draft or its supporting planning notes. Record unresolved choices
with a recommendation, alternatives, and the decision needed. Revisit earlier
sections when later evidence affects their conclusions.
The checklist below was used to select the initial feature target and prepare an
ordered Luna implementation plan. Its instructions and suggested outline are
retained as planning history. Current public contracts belong in Go declarations
and GoDoc, operator behavior in the [CLI reference](../cli.md), and usage guidance
in the [consumer guide](../consumers/guide.md).
The [architecture policy](../policy/architecture.md) and accepted ADRs control
architectural choices. This document owns the preparation process; `initial.md`
will own the initial feature targets. Exact implemented contracts will belong in
owns the initial feature targets. Exact implemented contracts belong in
Go declarations, GoDoc, and the CLI reference under the
[documentation policy](../policy/documentation.md).
@@ -188,13 +183,13 @@ resolved to the depth needed by the later implementation plan.
- [x] Review the complete draft against its requirements checklist and package map.
- [x] Make upstream work, deferrals, and unresolved decisions visible in the draft.
- [x] Review the targeted end state before translating it into implementation tasks.
- [ ] Prepare the subsequent staged plan with ordered tasks, prerequisites, precise
- [x] Prepare the subsequent staged plan with ordered tasks, prerequisites, precise
deliverables, and completion checks mapped to the roadmap's feature identifiers.
**Result:** a reviewed feature roadmap that can be translated into a strictly
ordered implementation plan suitable for Luna.
**Result:** a reviewed feature roadmap and the completed staged implementation
plan suitable for Luna.
## Recommended outline for `initial.md`
## Historical outline for `initial.md`
1. Authority and initial scope.
2. Target package layout and dependencies.

View File

@@ -121,13 +121,15 @@ Owner: [04-facade.md](04-facade.md).
Owner: [initial-plan.md](initial-plan.md).
- [ ] Mark roadmap preparation and implementation-plan handoff complete.
- [ ] Remove claims that exact declarations still await specification and that
- [x] Mark roadmap preparation and implementation-plan handoff complete.
- [x] Remove claims that exact declarations still await specification and that
the staged plan is the next deliverable. Link to the completed plan and current
API owners.
- [ ] Check the completed final handoff item and label the preparation process
- [x] Check the completed final handoff item and label the preparation process
and recommended outline as historical planning material.
**Completion:** Closed the planning handoff, checked its final item, and labeled the retained process and outline as historical.
## D-06: clarify completed feature and implementation records
Owners: [initial.md](initial.md) and [implementation.md](implementation.md).