docs(ecosystem): add delegation task pack

This commit is contained in:
Saravana Achu Mac 2026-04-03 18:05:13 -07:00
parent 765568fd44
commit f3b3ae30fb
6 changed files with 236 additions and 0 deletions

View File

@ -26,6 +26,7 @@ Recommended structure:
- [`ECOSYSTEM_MARKETPLACE_UNIFICATION.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/ECOSYSTEM_MARKETPLACE_UNIFICATION.md) — shared marketplace model
- [`ECOSYSTEM_PERSONAL_TIMELINE_PRD.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/ECOSYSTEM_PERSONAL_TIMELINE_PRD.md) — unified user activity stream
- [`PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md) — execution-ready plan for the first golden flow
- [`delegation/`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation) — ready-to-send task packs and launcher lines for Saravana, Codex, Windsurf, and Cursor
- [`adoption/`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/adoption) — per-product adoption notes
Ownership model:

View File

@ -0,0 +1,48 @@
# Codex Phase 1 Integration Review
> **Role:** Codex
> **Repo Lead:** cross-repo
> **Goal:** finish Phase 1 by reviewing delegated outputs, closing any contract drift, and recording final status
## Scope
- review NoteLett Phase 1 verification output
- review MindLyst Phase 1 verification output
- validate against:
- [`ECOSYSTEM_AGENT_OPERATING_MODEL.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/ECOSYSTEM_AGENT_OPERATING_MODEL.md)
- [`ECOSYSTEM_IMPLEMENTATION_TRACKER.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/ECOSYSTEM_IMPLEMENTATION_TRACKER.md)
- [`PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md)
- [`packages/events/src/ecosystem.ts`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/packages/events/src/ecosystem.ts)
## Owned Work
- final cross-repo review
- final event-lineage review
- final tracker/doc updates
- final end-to-end walkthrough assessment
## Do Not Touch
- unrelated product features
- Phase 2 implementation
- broad refactors outside the Phase 1 flow unless required to close a concrete bug
## Review Checklist
- artifact shapes still match shared contracts
- event causation and parent lineage are preserved
- no repo introduced contract drift
- verification evidence is real and recorded
- tracker reflects actual completion state
## Expected Output
- approve or reject delegated work
- apply any required integration fixes
- update tracker/docs with final evidence
## Launch One-Liner
```bash
git pull origin main && read /Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/CODEX_PHASE1_INTEGRATION_REVIEW.md and execute it exactly within its ownership boundaries
```

View File

@ -0,0 +1,56 @@
# Cursor Task: MindLyst Phase 1 Verification
> **Role:** Cursor
> **Repo:** `learning_multimodal_memory_agents`
> **Priority:** current Phase 1 blocker
## Goal
Finish the narrow MindLyst verification path for the note -> memory step so the Phase 1 flow is locally testable.
## Owned Files And Modules
- `mindlyst-native/web/src/lib/ecosystem-phase1.*`
- `mindlyst-native/web/src/app/api/memory/route.ts`
- `mindlyst-native/web/src/__tests__/api-memory.test.ts`
- minimal web test/tooling config only if required for this exact path
## Do Not Touch
- mobile/native app code
- unrelated product features
- shared ecosystem contracts in `learning_ai_common_plat`
- broad web toolchain churn unrelated to the Phase 1 path
## Required Outcome
- focused tests run for the Phase 1 memory import path
- `memory.entry.created` keeps upstream note-linked event causation when available
- latest memory event index persistence is covered
- any tooling fix stays minimal and local to this path
## Verification
Run the narrowest focused test command that proves the path works. Target files:
- `mindlyst-native/web/src/lib/ecosystem-phase1.test.ts`
- `mindlyst-native/web/src/__tests__/api-memory.test.ts`
Record the exact command and result.
## Tracker Update
If verification changes from blocked to verified, update:
- [`ECOSYSTEM_IMPLEMENTATION_TRACKER.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/ECOSYSTEM_IMPLEMENTATION_TRACKER.md)
- [`PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md)
## Review Gate
Return the result to Codex for review before claiming completion.
## Launch One-Liner
```bash
git pull origin main && read /Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/CURSOR_MINDLYST_PHASE1_VERIFICATION.md and execute it exactly within its ownership boundaries
```

View File

@ -0,0 +1,39 @@
# Delegation Pack
> Ready-to-send task files for Saravana, Codex, Windsurf, and Cursor.
> Use these files when assigning bounded ecosystem work to another coding agent.
---
## Current Delegation Set
- [`SARAVANA_COORDINATION.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/SARAVANA_COORDINATION.md)
- [`CODEX_PHASE1_INTEGRATION_REVIEW.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/CODEX_PHASE1_INTEGRATION_REVIEW.md)
- [`WINDSURF_NOTELETT_PHASE1_VERIFICATION.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/WINDSURF_NOTELETT_PHASE1_VERIFICATION.md)
- [`CURSOR_MINDLYST_PHASE1_VERIFICATION.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/CURSOR_MINDLYST_PHASE1_VERIFICATION.md)
---
## Standard Launcher Pattern
Give an agent a one-liner in this form:
```bash
git pull origin main && read the task file at <absolute-path> and execute it exactly within its ownership boundaries
```
Example:
```bash
git pull origin main && read /Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/WINDSURF_NOTELETT_PHASE1_VERIFICATION.md and execute it exactly within its ownership boundaries
```
---
## Rules
- task files must stay bounded
- task files must name owned files or modules
- task files must name do-not-touch boundaries
- task files must include verification expectations
- Codex reviews delegated outputs before ecosystem completion is claimed

View File

@ -0,0 +1,32 @@
# Saravana Coordination Task
> **Role:** Saravana
> **Purpose:** sequencing, approval, and merge authority for the current Phase 1 completion work
## Goal
Coordinate the final Phase 1 verification push without changing the technical contract.
## Scope
- confirm that Windsurf owns NoteLett verification
- confirm that Cursor owns MindLyst verification
- keep Codex as final reviewer for cross-repo completion
- decide when to stop Phase 1 and when to begin Phase 2
## Do Not Touch
- shared artifact schema unless Codex recommends a contract change
- broad Phase 2 rollout before Phase 1 walkthrough is closed
## Expected Output
- clear approval on task ownership
- clear approval on merge order
- final signoff when Codex reports Phase 1 ready
## Launch One-Liner
```bash
git pull origin main && read /Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/SARAVANA_COORDINATION.md and use it as the current coordination brief
```

View File

@ -0,0 +1,60 @@
# Windsurf Task: NoteLett Phase 1 Verification
> **Role:** Windsurf
> **Repo:** `learning_ai_notes`
> **Priority:** current Phase 1 blocker
## Goal
Finish the NoteLett verification path for the transcript -> note step so the Phase 1 flow is execution-verified, not just code-complete.
## Owned Files And Modules
- `backend/src/lib/ecosystem-phase1.*`
- `backend/src/modules/ecosystem-phase1/*`
- backend test/config files only if needed for this exact verification path
## Do Not Touch
- `web/`
- `mobile/`
- shared ecosystem contracts in `learning_ai_common_plat`
- unrelated NoteLett features
## Required Outcome
- backend Phase 1 import path runs locally
- focused tests cover:
- transcript artifact import
- note artifact creation
- `artifact.created`
- `artifact.linked`
- upstream event causation propagation
- no contract drift from `@bytelyst/events`
## Verification
Run the narrowest real command that proves the path works. Preferred:
```bash
pnpm --filter @notelett/backend run test
```
If repo setup requires a narrower command, use it and record the exact command plus result.
## Tracker Update
If verification changes from blocked to verified, update:
- [`ECOSYSTEM_IMPLEMENTATION_TRACKER.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/ECOSYSTEM_IMPLEMENTATION_TRACKER.md)
- [`PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md`](/Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/PHASE1_TRANSCRIPT_NOTE_MEMORY_EXECUTION_PLAN.md)
## Review Gate
Return the result to Codex for review before claiming completion.
## Launch One-Liner
```bash
git pull origin main && read /Users/saravana/BytelystAI/learning_ai/learning_ai_common_plat/docs/ecosystem/delegation/WINDSURF_NOTELETT_PHASE1_VERIFICATION.md and execute it exactly within its ownership boundaries
```