archy/loop/prompt.md

You are running a 2-year production roadmap for Archipelago (Archy) — taking it from developer preview to a flawless, mass-market Bitcoin Node OS (v1.0).

Read these files first:

1. `loop/plan.md` — Your task checklist (mark items `- [x]` as you complete them)
2. `CLAUDE.md` — Archy project conventions, architecture, coding standards

## Architecture Quick Reference

```
Server: 192.168.1.228 (ssh -i ~/.ssh/archipelago-deploy archipelago@192.168.1.228)
Frontend: neode-ui/ → builds to web/dist/neode-ui/ → deployed to /opt/archipelago/web-ui/
Backend: core/archipelago/ → Rust binary → deployed to /usr/local/bin/archipelago
Nginx: /etc/nginx/sites-available/archipelago (source: image-recipe/configs/nginx-archipelago.conf)
Systemd: /etc/systemd/system/archipelago.service (source: image-recipe/configs/archipelago.service)
Deploy: scripts/deploy-to-target.sh, scripts/first-boot-containers.sh
ISO: image-recipe/build-auto-installer-iso.sh
```

## Key Paths

- Views: `neode-ui/src/views/*.vue`
- Components: `neode-ui/src/components/*.vue`
- Stores: `neode-ui/src/stores/*.ts`
- API clients: `neode-ui/src/api/*.ts`
- Global styles: `neode-ui/src/style.css`
- Router: `neode-ui/src/router/index.ts`
- Context broker: `neode-ui/src/services/contextBroker.ts`
- Types: `neode-ui/src/types/*.ts`
- Backend entry: `core/archipelago/src/main.rs`
- RPC handlers: `core/archipelago/src/api/rpc/*.rs`
- Container mgmt: `core/container/src/*.rs`
- Security: `core/security/src/*.rs`
- Identity: `core/archipelago/src/identity/` (to be created)
- Network: `core/archipelago/src/network/` (to be created)
- Wallet: `core/archipelago/src/wallet/` (to be created)
- Nginx config: `image-recipe/configs/nginx-archipelago.conf`
- Systemd service: `image-recipe/configs/archipelago.service`
- Web5 docs: `docs/WEB5_NOSTR_IDENTITY.md`
- Three-mode UI spec: `docs/three-mode-ui-design.md`
- Port assignments: `apps/PORTS.md`

## For each task in loop/plan.md:

1. Find the first unchecked `- [ ]` item
2. Read the task description carefully — it tells you exactly what to do
3. Read ALL relevant source files before making changes
4. Make the change following CLAUDE.md conventions strictly:
   - Global CSS classes in style.css, NEVER inline Tailwind in components
   - `<script setup lang="ts">` only, no Options API
   - No `any` types — use proper TypeScript types
   - No `unwrap()`/`expect()` in Rust production code — use `?` operator
   - Use `tracing` for Rust logging — never `println!`
5. For frontend changes:
   - Run `cd neode-ui && npm run type-check` — fix ALL errors
   - Run `cd neode-ui && npm run build` — must succeed
   - Deploy: `./scripts/deploy-to-target.sh --live`
   - Verify at http://192.168.1.228
6. For backend changes:
   - Do NOT build Rust on macOS — the deploy script handles it
   - Deploy: `./scripts/deploy-to-target.sh --live`
   - Verify the service is running on the server
7. For nginx/systemd/infra changes:
   - Deploy the config file to the server (commands in the task description)
   - Validate config before applying (nginx -t)
   - Verify the service works after applying
8. For new feature development:
   - Create new files in the appropriate module directories
   - Follow existing patterns in the codebase
   - Wire new RPC endpoints through the existing RPC system
   - Add new views to the router
   - Add new stores as needed
9. Mark it done `- [x]` in `loop/plan.md`
10. Commit: `type: description`
11. Move to the next unchecked task immediately

## Critical Rules

- **Do NOT break existing functionality** — if your change breaks something, fix it before moving on
- **Read files before editing** — understand before changing
- **Never skip type-check or build** — if it fails, fix before moving on
- **Always deploy after completing a task** — changes must be live
- **Use SSH key, not password**: `ssh -i ~/.ssh/archipelago-deploy archipelago@192.168.1.228`
  - For sudo: pipe the password `echo "EwPDR8q45l0Upx@" | sudo -S <command>`
- **Follow the design system** — glass cards, glass buttons, existing color tokens, no gradient buttons
- **Replace dummy data with real backends** — no more hardcoded values in Web5.vue
- **New Rust modules** go in `core/archipelago/src/` with proper error types
- **New Vue views** go in `neode-ui/src/views/` with `<script setup lang="ts">`
- If a task is proving difficult after 15+ genuine attempts, add `(BLOCKED: reason)` to the task and move on
- Do not stop until all tasks are checked or you hit rate limits
- Commit after each completed task