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
1.1 KiB
1.1 KiB
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 checkoutbranches in shared checkouts while other agents may be active. - Use one worktree per task and one branch per worktree.
- Keep a
.agent-lockfile 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
- Create isolated worktree and branch from integration base:
scripts/agent-worktree.sh create <topic> [base-branch]
- Work only in that worktree path:
.worktree/<topic>- Exception: create and edit OpenSpec documents in the main checkout at
openspec/changes/<topic>/.
- Commit and push branch:
agent/<topic>
- Open PR into integration branch.
- 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.