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
29 lines
1.1 KiB
Markdown
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.
|