Skip to content

Commit 2fda221

Browse files
Add Effect submodules and TypeScript work rule
TASK-038: Unblock TypeScript research work - Add .refs/effect (Effect-TS core library reference) - Add .refs/effect-smol (Effect-TS smol variant reference) - Add effect-native/ work submodule at repo root - Update AGENTS.md with TypeScript Work Rule section - All TS work happens in effect-native/ submodule - Follow spec-first workflow in effect-native/.specs/AGENTS.md This unblocks TASK-031, TASK-032 and future TS research work.
1 parent b91e3ad commit 2fda221

File tree

6 files changed

+90
-0
lines changed

6 files changed

+90
-0
lines changed

.gitmodules

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,3 +27,12 @@
2727
[submodule ".refs/solid_cable"]
2828
path = .refs/solid_cable
2929
url = [email protected]:rails/solid_cable.git
30+
[submodule ".refs/effect"]
31+
path = .refs/effect
32+
url = [email protected]:Effect-TS/effect.git
33+
[submodule ".refs/effect-smol"]
34+
path = .refs/effect-smol
35+
url = [email protected]:Effect-TS/effect-smol.git
36+
[submodule "effect-native"]
37+
path = effect-native
38+
url = [email protected]:effect-native/effect-native.git

.refs/effect

Submodule effect added at fb78c40

.refs/effect-smol

Submodule effect-smol added at e0e47d3
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
# TASK-038: Add Effect submodules + TS-work rule (unblock TypeScript)
2+
3+
## Status
4+
- [ ] Planned
5+
- [ ] Assigned
6+
- [ ] In Progress
7+
- [ ] Blocked (reason: ...)
8+
- [x] Complete
9+
10+
## Priority
11+
high
12+
13+
## Assigned To
14+
subagent (general)
15+
16+
## Parent Docs / Cross-links
17+
- Wish: `.wishes/effect-native.md`
18+
- Repo submodules file: `.gitmodules`
19+
- Agent rules: `AGENTS.md`
20+
21+
## Description
22+
Add the submodules required for TypeScript work and codify the rule that **all TS work lives in the `effect-native/` submodule**, following the spec-first workflow defined by `effect-native/.specs/AGENTS.md`.
23+
24+
Submodules to add:
25+
- References:
26+
- `[email protected]:Effect-TS/effect.git`
27+
- `[email protected]:Effect-TS/effect-smol.git`
28+
- Work:
29+
- `[email protected]:effect-native/effect-native.git`
30+
31+
Then update `AGENTS.md` with a clear rule:
32+
- TypeScript work happens only in `effect-native/`
33+
- For TS changes, agents must read and follow `effect-native/.specs/AGENTS.md`
34+
35+
## Files to Modify
36+
- `.gitmodules`
37+
- `AGENTS.md`
38+
- (new directories created by git submodule add)
39+
40+
## Acceptance Criteria
41+
- [x] `git submodule status` shows all three submodules present.
42+
- [x] `AGENTS.md` documents the TS-work rule and points at `effect-native/.specs/AGENTS.md`.
43+
- [x] Existing non-TS tasks remain valid (no churn).
44+
45+
## Progress Log
46+
### 2025-12-14
47+
- Task created from `.wishes/effect-native.md`
48+
- Subagent began work: marked In Progress
49+
- Added `.refs/effect` submodule
50+
- Added `.refs/effect-smol` submodule
51+
- Added `effect-native` submodule
52+
- Updated `AGENTS.md` with TypeScript Work Rule section
53+
- Verified all acceptance criteria met
54+
- Task complete
55+
56+
## Completion Notes
57+
### 2025-12-14
58+
- Added three git submodules:
59+
- `.refs/effect` (Effect-TS/effect @ fb78c4061cec89718c49f842a91263a9bb8cf3cf)
60+
- `.refs/effect-smol` (Effect-TS/effect-smol @ e0e47d38139e9f182908dc6f26125d59ad0f1219)
61+
- `effect-native` (effect-native/effect-native @ 9f6ce02ea21e81110df4ebd2c80f863fdc0173fb)
62+
- Updated `AGENTS.md` with new "TypeScript Work Rule" section directing all TS work to `effect-native/` submodule
63+
- Verified `effect-native/.specs/AGENTS.md` exists for spec-first workflow reference

AGENTS.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,21 @@ What to do.
5151

5252
---
5353

54+
## TypeScript Work Rule
55+
56+
**All TypeScript work happens in the `effect-native/` submodule.**
57+
58+
When working on TypeScript code:
59+
1. Navigate to `effect-native/` directory
60+
2. Follow the spec-first workflow defined in `effect-native/.specs/AGENTS.md`
61+
3. Use the patterns and conventions documented in `effect-native/AGENTS.md`
62+
63+
Reference submodules for Effect ecosystem:
64+
- `.refs/effect` — Effect-TS core library
65+
- `.refs/effect-smol` — Effect-TS smol variant
66+
67+
---
68+
5469
## Zig CR-SQLite Rewrite: Orchestration Workflow
5570

5671
This project is undergoing a major rewrite from C/Rust to Zig. The following workflow governs how work proceeds.

effect-native

Submodule effect-native added at 9f6ce02

0 commit comments

Comments
 (0)