jparkerweb/plan2code
1
0
Fork 0
mirror of https://github.com/jparkerweb/plan2code.git synced 2026-09-17 16:22:23 -07:00
Code Issues Packages Projects Releases Wiki Activity

Add Pathfinder as an optional Step 0 and offload prompt depth to references

Browse Source 
Pathfinder charts an idea that is too big to plan as a map of decision
questions under specs/<idea>/pathfinder/, clearing one per session until it
can hand a PLAN-DRAFT to Step 1. Finalize now archives pathfinder/ with the
spec and revise-plan no longer deletes it — both previously described the
cleanup target in wording that pointed at questions/. Init-update Step 7 and
review Session End move to reference files with inline fallbacks.

AI Assisted
This commit is contained in:
Justin Parker
2026-08-08 12:39:13 -07:00
parent 48a7cf68bd
commit 0501260098
16 changed files with 2557 additions and 102 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/plan2code-4-finalize.md
+17 -19
View File
@@ -203,9 +203,9 @@ Do NOT make documentation changes without user approval.
`🧹 [FINALIZATION STEP 5: User Feedback]`
**Objective:** Collect optional user feedback before archival.
**Objective:** Collect optional feedback before archival.
Ask the user: "Would you like to provide feedback on this workflow run? (optional)"
Ask the user: "Would you like to provide feedback on this run? (optional)" If no, skip to Step 6.
If yes, collect:
1. **Rating** (1-10): "How would you rate this workflow run overall?"
@@ -225,7 +225,7 @@ Append to `overview.md` (in the active spec directory):
| Went Poorly | [response] |
```
If the user declines, skip and proceed to Step 6 (Spec Cleanup).
Ask: "Submit this feedback + run metrics to the maintainer via GitHub? (optional)" Hold as "submission consent". If declined, skip to Step 6.
---
@@ -238,30 +238,27 @@ If the user declines, skip and proceed to Step 6 (Spec Cleanup).
**Confirm with user before moving files.**
1. Create: `specs--completed/<feature-name>/`
2. Move all files from `specs/<feature-name>/`:
2. Move all contents of `specs/<feature-name>/`:
- `overview.md` (with completion summary)
- All `phase-X.md` files
- `PLAN-DRAFT.md` (if present)
- `PLAN-CONVERSATION-*.md` (if present)
3. Remove any temporary research or scratch files not part of the final spec record
- `PLAN-DRAFT.md`, `PLAN-CONVERSATION-*.md`, `pathfinder/` (if present)
3. Remove temporary scratch files not part of the final spec record
4. Verify original directory empty and can be removed
```
specs/
└── another-feature/ # In-progress feature (if any)
specs--completed/
└── <feature-name>/ # Archived feature
├── overview.md # With completion summary
├── phase-1.md # All checkboxes [x]
├── phase-2.md
└── ...
```
**Keep folder name exactly as-is during archival.**
---
### STEP 6.5: Community Feedback Submission
`🧹 [FINALIZATION STEP 6.5: Community Feedback Submission]`
If Step 5 feedback/consent was declined, skip to Step 7. Otherwise assemble/preview/submit the payload:
Read references/community-feedback-submission.md
---
### STEP 7: Final Confirmation
`🧹 [FINALIZATION STEP 7: Final Confirmation]`
@@ -288,6 +285,7 @@ Replace METRICS_JSON values with actuals. `completion_rate_at_audit` = Y/Z as de
- [x] Step 4: Documentation Review
- [x] Step 5: User Feedback (Optional)
- [x] Step 6: Spec Cleanup
- [x] Step 6.5: Community Feedback Submission
- [x] Step 7: Final Confirmation
### Files Created/Modified During Finalization