Skip to content

docs(roadmap): Synchronize task boards and agent guide #15

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
EKF0 merged 1 commit into from
May 25, 2026
Merged

docs(roadmap): Synchronize task boards and agent guide #15

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 10 additions & 22 deletions .AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,14 +19,14 @@ The goal is to give you complete context in <60 seconds so you can pick up where
| **Project** | BagFi — Unified Web3 asset platform with automated "Smart Bags" |
| **Target Stack** | Next.js, Solana Wallet Standard, Bags.fm API, Solana RPC, Supabase |
| **Legacy Stack** | RainbowKit/Wagmi/viem, Li.Fi, Solidity/Hardhat remain only as migration context unless a task explicitly targets them |
| **Current Phase** | Bags.fm + Solana roadmap execution (`SOL0` → `SOL7`) |
| **Current Phase** | P1 User Experience & Safety Enhancements (`P1-01` → `P1-03`) |
| **Plan CSV** | `docs/production-readiness-plan.csv` |
| **Progress Log** | `docs/progress.md` |
| **Roadmap Research** | `docs/reports/bags-solana-transition-research.md` |
| **Skill Stack Research** | `docs/reports/agent-skill-stack-research.md` |
| **Task Files** | `tasks/*.md` |
| **Task Reports** | `docs/reports/*.md` |
| **Last Updated** | 2026-05-14 |
| **Last Updated** | 2026-05-25 |

---

Expand Down Expand Up @@ -88,26 +88,14 @@ pending → in_progress → completed

Default to the Bags/Solana roadmap. Legacy `WS*` rows are historical production-readiness context and should not outrank a pending `SOL*` task unless the user explicitly asks.

| Priority | Task | Depends On |
|----------|------|------------|
| P0 | SOL0-01 Smart Bag guardrails for Bags.fm integration | — |
| P0 | SOL0-02 EVM assumptions and Solana replacement map | SOL0-01 |
| P0 | SOL1-01 Solana and Bags environment validation | SOL0-02 |
| P0 | SOL1-02 Typed server-side Bags API client | SOL1-01 |
| P0 | SOL1-03 Solana Wallet Standard provider | SOL1-01 |
| P0 | SOL1-04 Solana wallet identity normalization | SOL1-03 |
| P0 | SOL2-01 Bags quote API route | SOL1-02 |
| P0 | SOL2-02 Bags swap transaction route | SOL2-01 |
| P0 | SOL2-03 Solana transaction review and simulation UX | SOL2-02 |
| P0 | SOL2-04 Smart Bag deposit/rebalance session engine | SOL2-03 |
| P0 | SOL3-01 Bags launch feed and pool ingestion | SOL1-02 |
| P0 | SOL3-02 Bags token risk and eligibility scoring | SOL3-01 |
| P0 | SOL6-01 Supabase schema for Solana Smart Bags and Bags caches | SOL1-04 |
| P0 | SOL6-02 Cache/background refresh policy for Bags data | SOL3-01 |
| P0 | SOL7-01 Mocked Bags API and Solana transaction tests | SOL2-04 |
| P0 | SOL7-02 Smart Bag safety and compliance checklist | SOL3-03 |
| P0 | SOL7-03 Solana/Bags launch readiness gate | SOL7-01 |
| P1/P2 | Remaining `SOL*` rows | See `docs/production-readiness-plan.csv` |
| Priority | Task | Depends On | Status |
|----------|------|------------|--------|
| P0 | SOL0-01 to SOL7-03 Solana Core Foundations | — | Completed |
| P0 | P0-10 Legacy EVM contract decoupling & Vitest migration | SOL7-03 | Completed |
| P0 | P0-08 Add Sentry production monitoring & webhook alerts | SOL6-03 | Completed |
| P1 | P1-01 Add Mobile responsive navigation menu | SOL7-03 | Pending |
| P1 | P1-03 Add Feature Flags for Creator Lab & Partner Center | SOL7-03 | Pending |
| P1/P2 | Remaining `SOL*` / UX rows | See `docs/production-readiness-plan.csv` | Pending |

---

Expand Down
3 changes: 3 additions & 0 deletions docs/production-readiness-plan.csv
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,3 +38,6 @@ SOL6-03,Solana Data Layer,Add Solana and Bags observability,AI,completed,P1,SOL2
SOL7-01,Solana QA & Security,Add mocked Bags API and Solana transaction tests,AI,completed,P0,SOL2-04,"Unit and integration tests cover quote, swap transaction, simulation failure, and rebalance session edge cases"
SOL7-02,Solana QA & Security,Create Smart Bag safety and compliance review checklist,AI,completed,P0,SOL3-03,"Checklist covers no custody, no private keys, risk copy, volatile token warnings, and wallet approval requirements"
SOL7-03,Solana QA & Security,Run Solana/Bags launch readiness gate,AI,completed,P0,SOL7-01,"Build, lint, tests, mocked API smoke tests, env docs, and manual wallet QA all pass before public release"
P0-10,Legacy Migration,Decide and document EVM contract status; remove from launch gates or fix failing tests,AI,completed,P0,SOL7-03,Solidity files migrated to legacy/evm/ contracts configured under standalone test suite and package scripts updated
P0-08,QA CI/CD Observability,Add production monitoring/alerts,AI,completed,P0,SOL6-03,Sentry NextJS SDK integrated webhook alerts routed securely via /api/telemetry/alert for simulation failures rate-limit spikes and RPC latency

Loading