swarm repositories / source
aboutsummaryrefslogtreecommitdiff
path: root/AGENTS.md
blob: 5af9dc0b306d1f0a7941ac71a1b50e2e811981c3 (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
35
36
# Fidget Spinner

Fidget Spinner is a local-first, agent-first frontier ledger for autonomous
optimization work.

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
- frontier is scope and grounding, not a graph vertex
- hypotheses and experiments are the true graph vertices
- every experiment has one mandatory owning hypothesis
- per-project state lives under `.fidget_spinner/`
- the frontier brief is the one sanctioned freeform overview
- artifacts are references only; Spinner never reads artifact bodies
- slow intentional traversal beats giant context dumps
- `frontier.open` is the only sanctioned overview surface

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
  frontier/hypothesis/experiment records plus artifact references
- make live metrics and influence lineage discoverable without giant dumps
- bundle the frontier-loop skill with the MCP surface instead of treating it as
  folklore