diff options
Diffstat (limited to 'AGENTS.md')
| -rw-r--r-- | AGENTS.md | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..a42e5c1 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,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 |