@@ -4,22 +4,70 @@ This file provides guidance to AI coding agents when working with code in this r
44
55---
66
7+ ## Product Owner Wishes System
8+
9+ Tom (Product Owner) can asynchronously express wishes by dropping markdown files into ` .wishes/ ` .
10+
11+ ### How It Works
12+
13+ ```
14+ .wishes/
15+ ├── README.md # Instructions for Tom
16+ ├── done/ # Completed wishes (moved here with completion notes)
17+ ├── blocked/ # Blocked wishes (moved here with reason)
18+ └── *.md # Active wishes (inbox) - PROCESS THESE
19+ ```
20+
21+ ### Agent Workflow for Wishes
22+
23+ At the start of each OODA loop iteration:
24+
25+ 1 . ** Check ` .wishes/ ` for new files** (not in subdirs)
26+ 2 . ** Parse priority** from filename or content (` high- ` , ` medium- ` , ` low- ` prefix or ` ## Priority ` section)
27+ 3 . ** Incorporate high-priority wishes** into current round planning
28+ 4 . ** After completing a wish** :
29+ - Move file to ` .wishes/done/ `
30+ - Append completion notes (date, what was done, commit hash)
31+ 5 . ** If wish is blocked** :
32+ - Move file to ` .wishes/blocked/ `
33+ - Append reason why it's blocked
34+ 6 . ** Update ` research/zig-cr/92-gap-backlog.md ` ** with relevant items from wishes
35+
36+ ### Wish File Format
37+
38+ ``` markdown
39+ # [ Title]
40+
41+ ## Priority
42+ high | medium | low
43+
44+ ## Description
45+ What to do.
46+
47+ ## Acceptance Criteria
48+ - [ ] Criterion 1
49+ - [ ] Criterion 2
50+ ```
51+
52+ ---
53+
754## Zig CR-SQLite Rewrite: Orchestration Workflow
855
956This project is undergoing a major rewrite from C/Rust to Zig. The following workflow governs how work proceeds.
1057
1158### Continuous Integration Loop
1259
1360```
14- 1. Review the evergreen end state spec
15- 2. Compare it to the current WIP implementation
16- 3. Identify gaps
17- 4. Ensure each gap is captured and all status documents are updated in git
18- 5. Brainstorm the optimal divide-and-conquer strategy to keep many subagents busy without stepping on each other's toes
19- 6. Ensure the current subagent tasklist properly reflects that strategy
20- 7. Assign tasks to subagents and direct them to update their task card once done
21- 8. Ensure everything is in git
22- 9. While not yet done, goto step 1
61+ 1. Check .wishes/ for new product owner requests
62+ 2. Review the evergreen end state spec
63+ 3. Compare it to the current WIP implementation
64+ 4. Identify gaps
65+ 5. Ensure each gap is captured and all status documents are updated in git
66+ 6. Brainstorm the optimal divide-and-conquer strategy to keep many subagents busy without stepping on each other's toes
67+ 7. Ensure the current subagent tasklist properly reflects that strategy
68+ 8. Assign tasks to subagents and direct them to update their task card once done
69+ 9. Ensure everything is in git
70+ 10. While not yet done, goto step 1
2371```
2472
2573### Document Organization
0 commit comments