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

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 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.