Initial Fidget Spinner MVP

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