Files
rick 212f19ac19 Add v6-rewrite OpenSpec: proposal, design, specs, and tasks
Complete specification for rewriting Swarmops v5 as using.cash v6:
- Proposal: scope buckets (Working Rewrite / First Beyond Working / Maybe),
  non-goals (governance, geography, memberships permanently cut)
- Design: 18 architectural decisions including preserved patterns
  (Basic/Logic, stored procs, credential split), new patterns (repository
  classes, chain abstraction, rate providers), and operational concerns
  (Galera awareness, continuation transactions, VAT booking, OOD
  denormalization)
- Specs: 17 capability specifications with SHALL/MUST requirements and
  WHEN/THEN scenarios, covering accounting core, AP/AR, crypto treasury,
  exchange rates, organizations, users/auth, documents, comms, dashboard,
  end-of-month, backend worker, event bus, data migration, API layer,
  frontend app, and CI/packaging
- Tasks: 145 implementation tasks grouped by subsystem, ordered by
  dependency (migration gates API/frontend work)

Two rounds of adversarial review incorporated.

Made-with: Cursor
2026-04-08 16:02:58 +02:00

29 lines
1.1 KiB
Markdown

# Agent Isolation Workflow
This repository uses per-agent worktree isolation. Every agent task must run in its own branch and worktree.
## Rules
- Do not edit from the shared integration checkout.
- Do not `git checkout` branches in shared checkouts while other agents may be active.
- Use one worktree per task and one branch per worktree.
- Keep a `.agent-lock` file in each active worktree.
- Keep OpenSpec change artifacts in the main checkout under `openspec/changes/`, even when implementation work happens in an agent worktree.
## Standard Flow
1. Create isolated worktree and branch from integration base:
- `scripts/agent-worktree.sh create <topic> [base-branch]`
2. Work only in that worktree path:
- `.worktree/<topic>`
- Exception: create and edit OpenSpec documents in the main checkout at `openspec/changes/<topic>/`.
3. Commit and push branch:
- `agent/<topic>`
4. Open PR into integration branch.
5. After merge, remove worktree:
- `scripts/agent-worktree.sh remove <topic>`
## Lock File Contract
Each active worktree contains `.agent-lock` with owner/task/timestamp. If lock ownership is unclear, stop and ask before making edits.