Skip to content

Commit 2249f3b

Browse files
Add .tasks/ folder for subagent task management with Round 26 backlog
1 parent c9bfa19 commit 2249f3b

File tree

3 files changed

+146
-0
lines changed

3 files changed

+146
-0
lines changed

.tasks/README.md

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
# Subagent Task Cards
2+
3+
This folder contains task assignments for AI subagents. Each task is a markdown file that the assigned subagent updates as work progresses.
4+
5+
## Folder Structure
6+
7+
```
8+
.tasks/
9+
├── README.md # This file
10+
├── active/ # Currently assigned tasks
11+
│ └── TASK-001-description.md # Task being worked on
12+
├── done/ # Completed tasks
13+
│ └── TASK-001-description.md # Completed with notes
14+
└── backlog/ # Planned but not yet assigned
15+
└── TASK-002-description.md # Ready for next round
16+
```
17+
18+
## Task File Format
19+
20+
```markdown
21+
# TASK-XXX: [Short Description]
22+
23+
## Status
24+
- [ ] Assigned
25+
- [ ] In Progress
26+
- [ ] Blocked (reason: ...)
27+
- [ ] Complete
28+
29+
## Priority
30+
high | medium | low
31+
32+
## Assigned To
33+
[subagent type: general | explore | ...]
34+
35+
## Description
36+
What needs to be done.
37+
38+
## Files to Modify
39+
- `path/to/file1.zig`
40+
- `path/to/file2.ts`
41+
42+
## Acceptance Criteria
43+
- [ ] Criterion 1
44+
- [ ] Criterion 2
45+
46+
## Progress Log
47+
### YYYY-MM-DD HH:MM
48+
- [What was done]
49+
- [What's next]
50+
51+
## Completion Notes
52+
[Filled in when done: what was accomplished, commit hash, any follow-up needed]
53+
```
54+
55+
## Workflow
56+
57+
### Orchestrator (Main Agent)
58+
1. Creates task cards in `.tasks/backlog/`
59+
2. Moves to `.tasks/active/` when assigning to subagent
60+
3. Reviews completed tasks
61+
4. Moves to `.tasks/done/` and updates gap-backlog
62+
63+
### Subagent
64+
1. Reads assigned task from `.tasks/active/`
65+
2. Updates status to "In Progress"
66+
3. Adds progress log entries as work proceeds
67+
4. Updates status to "Complete" with completion notes
68+
5. Does NOT move the file (orchestrator does that)
69+
70+
## Rules
71+
1. **One task per file** - keeps diffs clean
72+
2. **Update frequently** - progress log should reflect current state
73+
3. **Be specific** - acceptance criteria must be testable
74+
4. **No stale tasks** - if blocked >1 round, document why
75+
5. **Commit task updates** - task card changes are part of the commit
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# TASK-026-A: Build macOS Universal Binary
2+
3+
## Status
4+
- [x] Planned
5+
- [ ] Assigned
6+
- [ ] In Progress
7+
- [ ] Complete
8+
9+
## Priority
10+
medium
11+
12+
## Assigned To
13+
general
14+
15+
## Description
16+
Create a macOS universal binary (aarch64 + x86_64) for the Zig CR-SQLite extension using the lipo-based approach documented in Round 23 research.
17+
18+
## Files to Modify
19+
- `zig/Makefile` - Add universal binary target
20+
21+
## Acceptance Criteria
22+
- [ ] `make universal` target exists in `zig/Makefile`
23+
- [ ] Builds both aarch64-macos and x86_64-macos
24+
- [ ] Uses `lipo -create` to combine into single binary
25+
- [ ] Output at `zig-out-universal/lib/libcrsqlite.dylib`
26+
- [ ] `lipo -info` shows both architectures
27+
- [ ] All tests pass with universal binary
28+
29+
## Implementation Notes
30+
From Round 23 research:
31+
```makefile
32+
build-macos-universal: build-macos-arm64 build-macos-x64
33+
lipo -create \
34+
zig-out-arm64/lib/libcrsqlite.dylib \
35+
zig-out-x64/lib/libcrsqlite.dylib \
36+
-output zig-out-universal/lib/libcrsqlite.dylib
37+
```
38+
39+
## Progress Log
40+
### 2025-12-14
41+
- Task created from Round 23 research findings
42+
43+
## Completion Notes
44+
[To be filled when complete]

AGENTS.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,33 @@ This project is undergoing a major rewrite from C/Rust to Zig. The following wor
7070
10. While not yet done, goto step 1
7171
```
7272

73+
### Subagent Task Management
74+
75+
Task cards live in `.tasks/` folder:
76+
77+
```
78+
.tasks/
79+
├── README.md # Instructions for task management
80+
├── backlog/ # Planned tasks ready for next round
81+
│ └── TASK-XXX-*.md # Task cards waiting to be assigned
82+
├── active/ # Currently assigned tasks (move here when assigning)
83+
│ └── TASK-XXX-*.md # Tasks being worked on
84+
└── done/ # Completed tasks archive
85+
└── TASK-XXX-*.md # With completion notes
86+
```
87+
88+
**Orchestrator workflow**:
89+
1. Create task cards in `.tasks/backlog/`
90+
2. Move to `.tasks/active/` when assigning to subagent
91+
3. Subagent updates progress in the task card
92+
4. Move to `.tasks/done/` when complete
93+
94+
**Subagent workflow**:
95+
1. Read assigned task from `.tasks/active/`
96+
2. Update status checkboxes and progress log
97+
3. Commit task card updates with code changes
98+
4. Mark complete when done (orchestrator moves file)
99+
73100
### Document Organization
74101

75102
```

0 commit comments

Comments
 (0)