planning-with-files 3.18.3 → 3.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,89 +1,89 @@
1
- # Task Plan: [Brief Description]
2
-
3
- Use this file as the durable roadmap for the task. Create it before complex work and keep it current as phases change.
4
-
5
- ## Goal
6
-
7
- State the intended end result in one clear sentence.
8
-
9
- [One sentence describing the end state]
10
-
11
- ## Next Step
12
-
13
- Record the single action that should happen next. Update it whenever the active phase or immediate action changes.
14
-
15
- [The single next action. Update whenever phase status changes.]
16
-
17
- ## Current Phase
18
-
19
- Name the phase currently being worked on.
20
-
21
- Phase 1
22
-
23
- ## Phases
24
-
25
- Break the task into three to seven verifiable phases. Use only `pending`, `in_progress`, or `complete` for each status and update the value when work advances.
26
-
27
- ### Phase 1: Requirements & Discovery
28
-
29
- - [ ] Understand user intent
30
- - [ ] Identify constraints and requirements
31
- - [ ] Document findings in findings.md
32
- - **Status:** in_progress
33
-
34
- ### Phase 2: Planning & Structure
35
-
36
- - [ ] Define technical approach
37
- - [ ] Create project structure if needed
38
- - [ ] Document decisions with rationale
39
- - **Status:** pending
40
-
41
- ### Phase 3: Implementation
42
-
43
- - [ ] Execute the plan step by step
44
- - [ ] Write code to files before executing
45
- - [ ] Test incrementally
46
- - **Status:** pending
47
-
48
- ### Phase 4: Testing & Verification
49
-
50
- - [ ] Verify all requirements met
51
- - [ ] Document test results in progress.md
52
- - [ ] Fix any issues found
53
- - **Status:** pending
54
-
55
- ### Phase 5: Delivery
56
-
57
- - [ ] Review all output files
58
- - [ ] Ensure deliverables are complete
59
- - [ ] Deliver to user
60
- - **Status:** pending
61
-
62
- ## Key Questions
63
-
64
- Record important questions and replace them with answers as they are resolved.
65
-
66
- 1. [Question to answer]
67
- 2. [Question to answer]
68
-
69
- ## Decisions Made
70
-
71
- Record significant choices and the reason for each one.
72
-
73
- | Decision | Rationale |
74
- |----------|-----------|
75
- | | |
76
-
77
- ## Errors Encountered
78
-
79
- Record each distinct error, the attempt number, and the resolution. Change the approach before retrying a failed action.
80
-
81
- | Error | Attempt | Resolution |
82
- |-------|---------|------------|
83
- | | 1 | |
84
-
85
- ## Notes
86
-
87
- - Update phase status as work progresses: `pending` to `in_progress` to `complete`.
88
- - Re-read the goal and next step before major decisions.
89
- - Log errors promptly so failed approaches are not repeated.
1
+ # Task Plan: [Brief Description]
2
+
3
+ Use this file as the durable roadmap for the task. Create it before complex work and keep it current as phases change.
4
+
5
+ ## Goal
6
+
7
+ State the intended end result in one clear sentence.
8
+
9
+ [One sentence describing the end state]
10
+
11
+ ## Next Step
12
+
13
+ Record the single action that should happen next. Update it whenever the active phase or immediate action changes.
14
+
15
+ [The single next action. Update whenever phase status changes.]
16
+
17
+ ## Current Phase
18
+
19
+ Name the phase currently being worked on.
20
+
21
+ Phase 1
22
+
23
+ ## Phases
24
+
25
+ Break the task into three to seven verifiable phases. Use only `pending`, `in_progress`, or `complete` for each status and update the value when work advances.
26
+
27
+ ### Phase 1: Requirements & Discovery
28
+
29
+ - [ ] Understand user intent
30
+ - [ ] Identify constraints and requirements
31
+ - [ ] Document findings in findings.md
32
+ - **Status:** in_progress
33
+
34
+ ### Phase 2: Planning & Structure
35
+
36
+ - [ ] Define technical approach
37
+ - [ ] Create project structure if needed
38
+ - [ ] Document decisions with rationale
39
+ - **Status:** pending
40
+
41
+ ### Phase 3: Implementation
42
+
43
+ - [ ] Execute the plan step by step
44
+ - [ ] Write code to files before executing
45
+ - [ ] Test incrementally
46
+ - **Status:** pending
47
+
48
+ ### Phase 4: Testing & Verification
49
+
50
+ - [ ] Verify all requirements met
51
+ - [ ] Document test results in progress.md
52
+ - [ ] Fix any issues found
53
+ - **Status:** pending
54
+
55
+ ### Phase 5: Delivery
56
+
57
+ - [ ] Review all output files
58
+ - [ ] Ensure deliverables are complete
59
+ - [ ] Deliver to user
60
+ - **Status:** pending
61
+
62
+ ## Key Questions
63
+
64
+ Record important questions and replace them with answers as they are resolved.
65
+
66
+ 1. [Question to answer]
67
+ 2. [Question to answer]
68
+
69
+ ## Decisions Made
70
+
71
+ Record significant choices and the reason for each one.
72
+
73
+ | Decision | Rationale |
74
+ |----------|-----------|
75
+ | | |
76
+
77
+ ## Errors Encountered
78
+
79
+ Record each distinct error, the attempt number, and the resolution. Change the approach before retrying a failed action.
80
+
81
+ | Error | Attempt | Resolution |
82
+ |-------|---------|------------|
83
+ | | 1 | |
84
+
85
+ ## Notes
86
+
87
+ - Update phase status as work progresses: `pending` to `in_progress` to `complete`.
88
+ - Re-read the goal and next step before major decisions.
89
+ - Log errors promptly so failed approaches are not repeated.