diff --git a/.beads/.gitignore b/.beads/.gitignore
new file mode 100644
index 0000000..01381ed
--- /dev/null
+++ b/.beads/.gitignore
@@ -0,0 +1,3 @@
+beads.db
+beads.db-shm
+beads.db-wal
diff --git a/.beads/config.yaml b/.beads/config.yaml
new file mode 100644
index 0000000..4a4be14
--- /dev/null
+++ b/.beads/config.yaml
@@ -0,0 +1,4 @@
+issue_prefixes: [bf]
+default_priority: 2
+default_type: task
+claim_ttl_minutes: 30
diff --git a/.beads/metadata.json b/.beads/metadata.json
new file mode 100644
index 0000000..f2388db
--- /dev/null
+++ b/.beads/metadata.json
@@ -0,0 +1 @@
+{"database": "beads.db", "jsonl_export": "issues.jsonl"}
\ No newline at end of file