swarm repositories / source
aboutsummaryrefslogtreecommitdiff
path: root/AGENTS.md
blob: a42e5c189ccd42613c1d3a0895dadceca9c401e5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
# Fidget Spinner

Fidget Spinner is a local-first, agent-first experimental DAG for autonomous
program optimization and research.

Constraints that are part of the product:

- no OAuth
- no hosted control plane
- no mandatory cloud resources
- no managed-compute marketplace in the core design
- DAG is canonical truth
- frontier state is a derived projection
- per-project state lives under `.fidget_spinner/`
- project payload schemas are local and warning-heavy, not globally rigid
- off-path nodes should remain cheap
- core-path experiment closure should remain atomic

Engineering posture:

- root `Cargo.toml` owns lint policy and canonical check commands
- every crate opts into `[lints] workspace = true`
- pin an exact stable toolchain in `rust-toolchain.toml`
- keep runners thin and orchestration-only
- prefer precise domain types over loose bags of strings

MVP target:

- dogfood against `libgrid` worktrees
- replace sprawling freeform experiment markdown with structured
  contract/change/run/analysis/decision nodes plus cheap research/note side paths
- make runs, comparisons, artifacts, and code snapshots first-class
- bundle the frontier-loop skill with the MCP surface instead of treating it as
  folklore