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.
- package/README.md +83 -83
- package/package.json +1 -1
- package/scripts/init-session.ps1 +185 -24
- package/scripts/init-session.sh +23 -2
- package/scripts/session-catchup.py +36 -20
- package/scripts/set-active-plan.ps1 +25 -1
- package/scripts/set-active-plan.sh +36 -8
- package/templates/analytics_findings.md +67 -67
- package/templates/analytics_task_plan.md +81 -81
- package/templates/findings.md +47 -47
- package/templates/progress.md +58 -58
- package/templates/task_plan.md +89 -89
package/templates/task_plan.md
CHANGED
|
@@ -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.
|