Finalize Promptkit migration documentation
This commit is contained in:
@@ -1,21 +1,19 @@
|
||||
# Promptkit Migration Implementation Plan
|
||||
|
||||
Status: Stages 1–11 completed; audit remediation in Stages 12–19 remains.
|
||||
Status: Completed; Stages 1–19 passed their exit gates.
|
||||
|
||||
## Purpose And Authority
|
||||
|
||||
This document records the completed implementation of the
|
||||
[Promptkit migration roadmap](promptkit.md) and defines the ordered follow-up
|
||||
work required by the post-implementation audit. The feature roadmap remains
|
||||
authoritative for scope, user intent, policy choices, and the desired end
|
||||
state. This plan is authoritative for implementation sequence, tests, and
|
||||
completion gates.
|
||||
[Promptkit migration roadmap](promptkit.md) and its post-implementation audit
|
||||
remediation. The feature roadmap records scope, user intent, policy choices,
|
||||
and the implemented end state. This plan records implementation sequence,
|
||||
tests, and completion gates.
|
||||
|
||||
Follow Stages 12–19 in order, using one implementation prompt per stage. A
|
||||
stage may fix additional defects exposed by its required tests when those
|
||||
defects are within the same stated contract. Do not expand a stage into new
|
||||
product behavior or reinterpret a roadmap decision to accommodate the current
|
||||
implementation.
|
||||
Stages 12–19 were completed in order. They fixed additional defects exposed by
|
||||
their required tests only when those defects were within the same stated
|
||||
contract; they did not add new product behavior or reinterpret roadmap
|
||||
decisions.
|
||||
|
||||
This plan follows the repository's
|
||||
[architecture](../policy/architecture.md),
|
||||
@@ -71,11 +69,24 @@ The post-implementation audit confirmed the principal dependency and package
|
||||
boundaries, but found incorrect reached-path bookkeeping, incomplete execution
|
||||
artifact updates, insufficient artifact validation, extensive loss of
|
||||
behavioral tests during the final cutover, and roadmap lifecycle text that was
|
||||
not finalized. The remaining stages address those findings without changing
|
||||
the intended feature scope.
|
||||
not finalized. The completed remediation addressed those findings without
|
||||
changing the intended feature scope.
|
||||
|
||||
| Stage | Completed outcome |
|
||||
| --- | --- |
|
||||
| 12 | Corrected reached-path bookkeeping across metadata, app results, batch items, and CLI summaries. |
|
||||
| 13 | Hardened Promptkit-era durable state validation and restored v1/v2 state coverage. |
|
||||
| 14 | Recorded every downstream path reached after completed prompt execution. |
|
||||
| 15 | Restored assembled single-report behavioral and failure coverage. |
|
||||
| 16 | Simplified prompt-generation orchestration while preserving behavior. |
|
||||
| 17 | Restored assembled batch, planning, artifact, and notification coverage. |
|
||||
| 18 | Restored supported CLI, summary, safety, and historical inspection coverage. |
|
||||
| 19 | Reconciled canonical documentation and passed the complete repository verification gate. |
|
||||
|
||||
## Stage 12: Correct Reached-Artifact Bookkeeping
|
||||
|
||||
Status: Completed.
|
||||
|
||||
### Goal
|
||||
|
||||
Make metadata, app results, batch items, and CLI summaries truthful at every
|
||||
@@ -138,6 +149,8 @@ result.
|
||||
|
||||
## Stage 13: Harden Durable State Contracts And Restore State Coverage
|
||||
|
||||
Status: Completed.
|
||||
|
||||
### Goal
|
||||
|
||||
Make the v1/v2 wire boundary and Promptkit-era artifact validation explicit,
|
||||
@@ -206,6 +219,8 @@ offline coverage for its durable compatibility and filesystem contracts.
|
||||
|
||||
## Stage 14: Complete Execution-Artifact Path Tracking
|
||||
|
||||
Status: Completed.
|
||||
|
||||
### Goal
|
||||
|
||||
Make `PromptExecutionArtifact.Paths` accurately record every downstream
|
||||
@@ -267,6 +282,8 @@ when a later application stage fails.
|
||||
|
||||
## Stage 15: Restore Single-Report Behavioral Coverage
|
||||
|
||||
Status: Completed.
|
||||
|
||||
### Goal
|
||||
|
||||
Restore the risk-based application coverage removed during final cutover and
|
||||
@@ -325,6 +342,8 @@ debug isolation, output copying, and notification behavior.
|
||||
|
||||
## Stage 16: Refactor Prompt Generation Orchestration
|
||||
|
||||
Status: Completed.
|
||||
|
||||
### Goal
|
||||
|
||||
Reduce the complexity and duplicated persistence logic in
|
||||
@@ -374,6 +393,8 @@ and every Stage 12–15 behavioral test passes unchanged.
|
||||
|
||||
## Stage 17: Restore Batch Behavioral Coverage
|
||||
|
||||
Status: Completed.
|
||||
|
||||
### Goal
|
||||
|
||||
Re-establish confidence that morning and evening batches preserve their
|
||||
@@ -421,6 +442,8 @@ artifact, and notification contracts with one Promptkit executor.
|
||||
|
||||
## Stage 18: Restore CLI And Inspection Coverage
|
||||
|
||||
Status: Completed.
|
||||
|
||||
### Goal
|
||||
|
||||
Restore the user-facing command, summary, and historical inspection contracts
|
||||
@@ -464,6 +487,8 @@ composition, and v1/v2 inspection behavior have deterministic offline coverage.
|
||||
|
||||
## Stage 19: Finalize Documentation And Repository Verification
|
||||
|
||||
Status: Completed.
|
||||
|
||||
### Goal
|
||||
|
||||
Close the audit remediation, make roadmap lifecycle state truthful, and verify
|
||||
@@ -526,5 +551,5 @@ documents are marked complete.
|
||||
|
||||
## Open Questions
|
||||
|
||||
None. The roadmap and this follow-up plan contain the decisions required to
|
||||
complete the audit remediation.
|
||||
None. The roadmap and this completed plan record the decisions used for the
|
||||
audit remediation.
|
||||
|
||||
Reference in New Issue
Block a user