froid-loop 0.11.1__py3-none-any.whl

froid_loop/data/settings/core.toml

@@ -0,0 +1,458 @@
+# Core settings schema — presentation + widget hints for .froid-loop/policy.toml.
+#
+# This file describes HOW each policy key is rendered in the settings UI (widget
+# kind, label, help text, select options, numeric bounds). It is NOT the source
+# of truth for defaults or validation: policy.py's frozen dataclasses are. So
+# defaults and select options are *referenced* from policy, never literal-ed:
+#
+#   default_ref = "ScmPolicy.merge_strategy"   ->  getattr(policy.ScmPolicy, "merge_strategy")
+#   options_ref = "MERGE_STRATEGIES"           ->  tuple(sorted(policy.MERGE_STRATEGIES))
+#
+# A sync test asserts every resolved default/option matches the dataclass, so
+# this file can never silently drift from the runtime model. Section and field
+# order here IS the render order in the settings screen.
+#
+# field.kind is the widget hint: select | int | float | str | switch | lines | args
+# (lines = newline-separated list; args = shlex token list with an override toggle).
+
+[[section]]
+name = "gates"
+description = "approval gates, escalation & retrospective behavior"
+[[section.field]]
+key = "mode"
+kind = "select"
+options_ref = "GATE_MODES"
+default_ref = "GatesPolicy.mode"
+[[section.field]]
+key = "retrospective"
+kind = "select"
+options_ref = "RETRO_MODES"
+default_ref = "GatesPolicy.retrospective"
+
+[[section]]
+name = "review"
+description = "separate adversarial review session toggle"
+[[section.field]]
+key = "enabled"
+kind = "switch"
+default_ref = "ReviewPolicy.enabled"
+label = "separate review session"
+description = "ON: adversarial review runs in a dedicated 2nd session · OFF: the dev pass runs its own review layers inline, story straight to done"
+[[section.field]]
+key = "trigger"
+kind = "select"
+options_ref = "REVIEW_TRIGGER_MODES"
+default_ref = "ReviewPolicy.trigger"
+label = "review trigger"
+description = "recommended: run the 2nd-opinion review only when the dev pass flags it · always: run it every story (both bounded by limits.max_review_cycles)"
+[[section.field]]
+key = "on_timeout"
+kind = "select"
+options_ref = "REVIEW_ON_TIMEOUT_MODES"
+default_ref = "ReviewPolicy.on_timeout"
+label = "review timeout policy"
+description = "retry: burn a review cycle per timeout (default) · salvage-if-done: commit the verified dev product and refile the follow-up · defer: give up on the first timeout"
+[[section.field]]
+key = "on_status_contradiction"
+kind = "select"
+options_ref = "REVIEW_ON_STATUS_CONTRADICTION_MODES"
+default_ref = "ReviewPolicy.on_status_contradiction"
+label = "review revokes sprint sign-off"
+description = "escalate: pause naming both sides when a review writes sprint-status back off done (default) · retry: legacy — burn review cycles, then defer + roll back"
+
+[[section]]
+name = "stories"
+description = "story-queue source: classic sprint board vs. folder+id dispatch"
+[[section.field]]
+key = "source"
+kind = "select"
+options_ref = "STORIES_SOURCES"
+default_ref = "StoriesPolicy.source"
+label = "story source"
+description = "sprint-status: walk sprint-status.yaml · stories: folder+id dispatch off a typed stories.yaml (needs spec_folder)"
+[[section.field]]
+key = "spec_folder"
+kind = "str"
+default_ref = "StoriesPolicy.spec_folder"
+label = "spec folder"
+description = "stories mode only: project-relative path to the epic spec folder (holds stories.yaml + SPEC.md)"
+
+[[section]]
+name = "limits"
+description = "cycle/attempt caps, timeout & token budget"
+[[section.field]]
+key = "max_review_cycles"
+kind = "int"
+minimum = 1
+default_ref = "LimitsPolicy.max_review_cycles"
+[[section.field]]
+key = "max_dev_attempts"
+kind = "int"
+minimum = 1
+default_ref = "LimitsPolicy.max_dev_attempts"
+[[section.field]]
+key = "max_followup_reviews"
+kind = "int"
+minimum = 0
+default_ref = "LimitsPolicy.max_followup_reviews"
+description = "additional review rounds granted solely because a finalized (status: done) round still recommended a follow-up; once spent, such a round converges + refiles the recommendation instead of burning another cycle · 0 = never honor a pass's own recommendation"
+[[section.field]]
+key = "session_timeout_min"
+kind = "int"
+minimum = 1
+default_ref = "LimitsPolicy.session_timeout_min"
+[[section.field]]
+key = "git_timeout_s"
+kind = "int"
+minimum = 1
+default_ref = "LimitsPolicy.git_timeout_s"
+description = "bound on any single git subprocess the orchestrator spawns; exceeding it degrades/pauses (never crashes the run) — raise on a loaded host or a very large worktree"
+[[section.field]]
+key = "teardown_grace_s"
+kind = "int"
+minimum = 0
+default_ref = "LimitsPolicy.teardown_grace_s"
+description = "verified session teardown: poll the killed window up to this long, then force-kill its pane pids and re-kill the window · 0 = single unverified best-effort kill"
+[[section.field]]
+key = "stop_without_result_nudges"
+kind = "int"
+minimum = 0
+default_ref = "LimitsPolicy.stop_without_result_nudges"
+[[section.field]]
+key = "dev_stall_grace_s"
+kind = "int"
+minimum = 0
+default_ref = "LimitsPolicy.dev_stall_grace_s"
+description = "silence grace for a dev/review session, armed at launch and re-armed by transport activity or fresh Stop/idle evidence, before bounded nudges/stalled classification · 0 = no launch timer, but a result-less turn end still fails fast"
+[[section.field]]
+key = "dev_stall_nudges"
+kind = "int"
+minimum = 0
+default_ref = "LimitsPolicy.dev_stall_nudges"
+description = "best-effort wake nudges for a silent dev/review session on grace expiry before it is called stalled; transport activity re-arms the grace and fresh Stop/idle evidence restores this budget · 0 = stall on grace expiry"
+[[section.field]]
+key = "dev_stall_nudges_cap"
+kind = "int"
+minimum = 0
+default_ref = "LimitsPolicy.dev_stall_nudges_cap"
+description = "total (never-restored) best-effort stall nudges for a dev/review session; bounds launch-time recovery and Stop/idle budget refills because an accepted nudge does not guarantee a wake · 0 = stall on first grace expiry"
+[[section.field]]
+key = "workflow_stall_nudges_cap"
+kind = "int"
+minimum = 0
+default_ref = "LimitsPolicy.workflow_stall_nudges_cap"
+description = "total (never-restored) stall nudges for an injected plugin-workflow session before it is called stalled; bounds a session that finished its work but never wrote its completion marker · 0 = stall on first grace expiry"
+[[section.field]]
+key = "dev_contract_nudge"
+kind = "switch"
+default_ref = "LimitsPolicy.dev_contract_nudge"
+label = "dev contract nudge"
+description = "ON: one targeted nudge per session when a Stop finds a spec finalized to a terminal frontmatter status but missing its `## Auto Run Result` marker, asking the skill to append it and end its turn (sent exactly once, never refilled, touches no stall counters) · OFF: rely only on harness-side frontmatter synthesis"
+[[section.field]]
+key = "max_tokens_per_story"
+kind = "int"
+minimum = 1
+default_ref = "LimitsPolicy.max_tokens_per_story"
+label = "story budget (weighted tokens)"
+description = "advisory cap on one story's cumulative weighted spend across all its sessions, re-checked at every session boundary · crossing it raises one ATTENTION + desktop notice per story and nothing else — the story runs on · for a cap that can END a session see session budget mode below"
+[[section.field]]
+key = "cache_read_weight"
+kind = "float"
+minimum = 0.0
+maximum = 1.0
+default_ref = "LimitsPolicy.cache_read_weight"
+description = "weight of cache-read tokens in every token total — budgets and displays alike · cache reads bill at ~0.1x base input on all supported vendors and are 80-95% of the raw count on agentic work, so the default keeps totals proportional to spend rather than to context re-reads · 1.0 = count cache reads at full price (raw)"
+[[section.field]]
+key = "session_budget_mode"
+kind = "select"
+options_ref = "SESSION_BUDGET_MODES"
+default_ref = "LimitsPolicy.session_budget_mode"
+label = "session budget mode"
+description = "mid-session guard on the weighted per-session spend, sampled every ~30s · off: no sampling · warn: one ATTENTION + breadcrumb · enforce: wrap-up nudge then over_budget termination (retry→defer)"
+[[section.field]]
+key = "max_tokens_per_session"
+kind = "int"
+minimum = 1
+default_ref = "LimitsPolicy.max_tokens_per_session"
+description = "weighted (cache-discounted) token cap a single session may spend before the budget guard trips; healthy sessions run ~1-2.5M weighted, so the default trips only true runaways"
+[[section.field]]
+key = "session_budget_grace_s"
+kind = "int"
+minimum = 0
+default_ref = "LimitsPolicy.session_budget_grace_s"
+description = "enforce mode: seconds a tripped session gets to wrap up after the nudge before it is terminated over_budget · 0 = terminate at trip, no nudge"
+
+[[section]]
+name = "verify"
+description = "post-implementation verification commands"
+[[section.field]]
+key = "commands"
+kind = "lines"
+[[section.field]]
+key = "stream_capture_kb"
+kind = "int"
+minimum = 0
+default_ref = "VerifyPolicy.stream_capture_kb"
+label = "verifier stream capture (KiB)"
+description = "per-stream cap on the verifier stdout/stderr retained under the run's verify/ directory (the tail is kept; the journal records the full size and a truncation flag) · 0 = capture nothing"
+
+[[section]]
+name = "notify"
+description = "desktop & file notifications"
+[[section.field]]
+key = "desktop"
+kind = "switch"
+default_ref = "NotifyPolicy.desktop"
+[[section.field]]
+key = "file"
+kind = "switch"
+default_ref = "NotifyPolicy.file"
+
+[[section]]
+name = "adapter"
+description = "CLI client, model & bypass flags (base for all stages)"
+[[section.field]]
+key = "name"
+kind = "str"
+placeholder = "CLI profile — default: claude"
+[[section.field]]
+key = "model"
+kind = "str"
+placeholder = "CLI default model"
+[[section.field]]
+key = "extra_args"
+kind = "args"
+[[section.field]]
+key = "cleanup_session_on_finish"
+kind = "switch"
+default_ref = "AdapterPolicy.cleanup_session_on_finish"
+[[section.field]]
+key = "usage_grace_s"
+kind = "float"
+minimum = 0
+default_ref = "AdapterPolicy.usage_grace_s"
+placeholder = "inherit from CLI profile (copilot ships 8s)"
+description = "seconds to poll the transcript for token usage after a session ends; CLIs that flush totals on shutdown (copilot) need a grace"
+[[section.field]]
+key = "stop_without_result_nudges"
+kind = "int"
+minimum = 0
+default_ref = "AdapterPolicy.stop_without_result_nudges"
+placeholder = "inherit (copilot profile ships 5)"
+description = "result-less Stop signals tolerated before a session is called stalled; overrides the global limits value for this CLI"
+
+# Per-stage adapter overrides. One section per [adapter.dev|review|triage] table,
+# expanded from this single template by the STAGES loop so they never drift.
+[[section]]
+name = "adapter.{stage}"
+expand_stages = true
+description = "{stage}-stage adapter overrides"
+[[section.field]]
+key = "name"
+kind = "str"
+placeholder = "inherit from [adapter]"
+[[section.field]]
+key = "model"
+kind = "str"
+placeholder = "inherit / client default"
+[[section.field]]
+key = "extra_args"
+kind = "args"
+[[section.field]]
+key = "usage_grace_s"
+kind = "float"
+minimum = 0
+default_ref = "StageAdapterPolicy.usage_grace_s"
+placeholder = "inherit from [adapter]"
+[[section.field]]
+key = "stop_without_result_nudges"
+kind = "int"
+minimum = 0
+default_ref = "StageAdapterPolicy.stop_without_result_nudges"
+placeholder = "inherit from [adapter]"
+
+[[section]]
+name = "sweep"
+description = "deferred-work sweep automation"
+[[section.field]]
+key = "auto"
+kind = "select"
+options_ref = "SWEEP_AUTO_MODES"
+default_ref = "SweepPolicy.auto"
+[[section.field]]
+key = "max_bundles"
+kind = "int"
+minimum = 1
+default_ref = "SweepPolicy.max_bundles"
+[[section.field]]
+key = "max_triage_attempts"
+kind = "int"
+minimum = 1
+default_ref = "SweepPolicy.max_triage_attempts"
+[[section.field]]
+key = "repeat"
+kind = "switch"
+default_ref = "SweepPolicy.repeat"
+[[section.field]]
+key = "max_cycles"
+kind = "int"
+minimum = 1
+default_ref = "SweepPolicy.max_cycles"
+
+[[section]]
+name = "scm"
+description = "git isolation, branching & merge-back"
+[[section.field]]
+key = "isolation"
+kind = "select"
+options_ref = "ISOLATION_MODES"
+default_ref = "ScmPolicy.isolation"
+description = "none: work in place on the checked-out branch (default) · worktree: run each story in its own git worktree, merge back to the target branch"
+[[section.field]]
+key = "branch_per"
+kind = "select"
+options_ref = "BRANCH_PER_MODES"
+default_ref = "ScmPolicy.branch_per"
+description = "worktree mode: one branch per story, or one shared branch per run (run forces delete-branch off so the shared branch survives)"
+[[section.field]]
+key = "target_branch"
+kind = "str"
+placeholder = "default: the branch checked out at run start"
+description = "worktree mode: branch all units merge back into (created if missing)"
+[[section.field]]
+key = "merge_strategy"
+kind = "select"
+options_ref = "MERGE_STRATEGIES"
+default_ref = "ScmPolicy.merge_strategy"
+description = "worktree mode: how a unit branch lands on the target — ff, merge, or squash"
+[[section.field]]
+key = "delete_branch"
+kind = "switch"
+default_ref = "ScmPolicy.delete_branch"
+description = "worktree mode: delete the unit branch after a successful merge"
+[[section.field]]
+key = "keep_failed"
+kind = "switch"
+default_ref = "ScmPolicy.keep_failed"
+description = "worktree mode: keep a failed unit's worktree + branch mounted for inspection"
+[[section.field]]
+key = "rollback_on_failure"
+kind = "switch"
+default_ref = "ScmPolicy.rollback_on_failure"
+label = "auto-rollback failed attempts"
+description = "⚠ in-place mode (isolation=none): when ON, a failed attempt's tracked changes are auto-reverted and the untracked files this run created are deleted (its uncommitted work is lost). When OFF (default), the orchestrator never touches your tree — it pauses with manual recovery steps. Governs unattended/stopped attempts only: a resolved escalation's re-drive always auto-recovers regardless (reverts the failed source, keeps the corrected spec). Prefer isolation=worktree to keep failures off your main checkout."
+[[section.field]]
+key = "preserve_keep"
+kind = "int"
+minimum = 0
+default_ref = "ScmPolicy.preserve_keep"
+label = "preserve-ref retention"
+description = "attempt-preserve/* recovery branches and attempt-preserve-dirty/* worktree snapshots kept at each run start (per family) · the newest by committer date survive and the tail is deleted (0 = never prune)"
+[[section.field]]
+key = "seed_adapter_defaults"
+kind = "switch"
+default_ref = "ScmPolicy.seed_adapter_defaults"
+label = "seed adapter configs"
+description = "worktree mode: copy each loaded adapter's gitignored MCP/CLI configs (.mcp.json, .claude/settings.json, .codex/config.toml …) into the worktree so isolated sessions can reach their MCP server"
+[[section.field]]
+key = "worktree_seed"
+kind = "lines"
+label = "extra worktree seed files"
+description = "worktree mode: additional project-relative gitignored files to copy into each worktree, one per line — on top of the adapter defaults above"
+[[section.field]]
+key = "commit_message_template"
+kind = "str"
+placeholder = "blank = built-in default; {story_key} / {run_id} / {story_title} substituted"
+label = "commit message template"
+description = "commit message dev sessions use for a story/bundle commit when set"
+[[section.field]]
+key = "failed_diff_max_mb"
+kind = "int"
+minimum = 1
+default_ref = "ScmPolicy.failed_diff_max_mb"
+label = "failed-diff size cap (MB)"
+description = "per-file size limit for untracked files captured into a kept-failed unit's changes.patch · oversized files are skipped with a marker"
+[[section.field]]
+key = "failed_diff_unlimited"
+kind = "switch"
+default_ref = "ScmPolicy.failed_diff_unlimited"
+label = "uncap failed-diff size"
+description = "⚠ ON: capture failed-unit diffs with NO size limit (overrides the cap above) — may produce very large patches; a warning is logged when active"
+
+[[section]]
+name = "cleanup"
+description = "disk reclamation for .froid-loop/runs, plus each run's out-of-tree control-plane dir (terminal runs only)"
+[[section.field]]
+key = "run_retention"
+kind = "int"
+minimum = 0
+default_ref = "CleanupPolicy.run_retention"
+label = "run retention (count)"
+description = "newest concluded runs kept whole · older ones are trimmed or archived by `froid-loop clean` (0 = keep none by count)"
+[[section.field]]
+key = "retention_days"
+kind = "int"
+minimum = 0
+default_ref = "CleanupPolicy.retention_days"
+label = "run retention (days)"
+description = "0 = disabled · else also keep runs newer than N days regardless of the count above"
+[[section.field]]
+key = "trim_artifacts"
+kind = "switch"
+default_ref = "CleanupPolicy.trim_artifacts"
+label = "trim heavy artifacts"
+description = "drop the heavy worktrees/ tree from concluded runs · the run still lists in the dashboard with full status/journal/logs"
+[[section.field]]
+key = "archive_old"
+kind = "switch"
+default_ref = "CleanupPolicy.archive_old"
+label = "archive past the window"
+description = "archive (.froid-loop/archive/<id>.tar.gz) rather than permanently delete runs beyond the retention window"
+[[section.field]]
+key = "auto_clean_on_finish"
+kind = "switch"
+default_ref = "CleanupPolicy.auto_clean_on_finish"
+label = "auto-clean on finish"
+description = "reconcile worktrees leaked by a mid-flight stop + apply retention each time a run finishes cleanly"
+[[section.field]]
+key = "clean_tmp"
+kind = "switch"
+default_ref = "CleanupPolicy.clean_tmp"
+label = "clean plugin /tmp scratch"
+description = "let engine plugins clean their /tmp scratch on finish (e.g. the Unity MCP server's downloaded zips)"
+
+# The game-engine layer (Unity) is no longer a core section — it is a plugin.
+# Its settings render from the plugin's own schema (data/plugins/unity/plugin.toml)
+# under [plugins.unity] when "unity" is in [plugins] enabled.
+
+[[section]]
+name = "tui"
+description = "dashboard rendering (slow-link / SSH tuning)"
+[[section.field]]
+key = "low_frame_rate"
+kind = "switch"
+default_ref = "TuiPolicy.low_frame_rate"
+label = "low frame rate"
+description = "cap to 15fps + disable animations — fixes repaint tearing/garbage over slow or SSH links · takes effect next time the TUI launches"
+
+[[section]]
+name = "operator"
+description = "stories that owe external, human-only actions"
+[[section.field]]
+key = "enabled"
+kind = "switch"
+default_ref = "OperatorPolicy.enabled"
+label = "allow awaiting-operator parks"
+description = "let a session finish + commit a story whose acceptance criteria need a human action (buy a domain, publish a DNS record) and park it as awaiting-operator instead of forcing done or blocked · what is owed is recorded in the story spec's operator_actions: frontmatter, and `froid-loop confirm <story-key>` completes the story once you have done it"
+
+[[section]]
+name = "mux"
+description = "terminal-multiplexer backend (machine-specific — policy.toml is gitignored)"
+# options are injected at build-registry time from detect_multiplexers() (plus any
+# already-forced value), since registered backends are a runtime fact, not an enum.
+[[section.field]]
+key = "backend"
+kind = "select"
+default_ref = "MuxPolicy.backend"
+label = "backend"
+description = "force a registered transport backend by name (see `froid-loop mux`); leave blank to auto-select — FROID_LOOP_MUX_BACKEND outranks it · takes effect on the next froid-loop invocation"

froid_loop/data/skills/README.md

@@ -0,0 +1,93 @@
+# FROID Loop module (`froid-loop`)
+
+A FROID module pairing the automation skills with the
+[froid-loop orchestrator tool](https://github.com/cordya-ai/froid-loop) (the
+Python program that drives the loop). The skills can be installed by the FROID
+installer, or laid down by `froid-loop init` (the orchestrator's wheel **bundles**
+them); either way `froid-loop-setup` installs the `froid-loop` package from its
+Git repository, so installing this module gives you a working system — skills
+plus the orchestrator that invokes them. Standard FROID installs are never
+modified; the skills are froid-loop-owned, standalone or froid-loop-native (see
+the table below).
+
+| Component           | Forked from          | Role                                                                                                                                              |
+| ------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `froid-loop`         | — (this repo, Git)   | the orchestrator: ralph-loop, hooks, tmux adapters, TUI. CLI `froid-loop`. Installed by `froid-loop-setup` from Git.                                |
+| `froid-loop-resolve` | — (froid-loop-native) | interactive CRITICAL-escalation resolution: a human disambiguates a frozen spec so a paused story can be re-driven (`/froid-loop-resolve <story>`) |
+| `froid-loop-sweep`   | — (froid-loop-native) | read-only deferred-work ledger triage; owns the canonical `deferred-work-format.md`                                                               |
+| `froid-loop-setup`   | — (scaffolded)       | **installs the orchestrator tool from Git**, runs `froid-loop init` + `validate`, refreshes `_froid/froid-loop/module-help.csv`                      |
+
+The **inner dev primitive is the upstream `froid-build-auto` skill** (Froid Plane's
+generic unattended dev session; `froid-dev-auto` on pre-rename releases, resolved
+from disk and invoked under whichever name is there). It is **not** owned or
+bundled here — the orchestrator drives it as an external skill that must already be installed
+(by the Froid installer / bmm-core). The froid-loop orchestrator synthesizes its `result.json`
+from the spec the session leaves on disk (see `froid_loop.devcontract`). The skill
+self-reviews inline (its step-04 review layers) and commits its own
+work each iteration; the orchestrator's **follow-up review is just a re-invocation
+of the primitive on the done spec** (Froid Plane #2508 routes a `done` spec to a
+fresh review pass), so there is no separate review skill.
+
+## Install into a project
+
+The orchestrator tool now bundles these skills, so `froid-loop init` lays them
+down for you:
+
+```bash
+uv tool install "froid-loop[tui] @ git+https://github.com/cordya-ai/froid-loop.git"
+froid-loop init --project /path/to/project --cli claude   # add --cli codex/gemini as needed
+claude "/froid-loop-setup accept all defaults"            # installs the tool + wires the project
+```
+
+`froid-loop init` installs the `froid-loop-*` skills into `.claude/skills/`
+(claude) and/or `.agents/skills/` (codex/gemini), registers hooks, writes
+`.froid-loop/policy.toml`, and gitignores the runs dir. Existing skill dirs are
+left untouched (`--force-skills` to overwrite, `--no-skills` to skip).
+`froid-loop-setup` is one-shot for the bootstrap the FROID installer cannot do: it
+ensures the orchestrator tool is installed, then runs `froid-loop init` and
+`froid-loop validate` (preflight). Module registration — `_froid/froid-loop/`, the
+central `config.toml`, the `/froid-help` catalog — belongs to the FROID installer,
+which regenerates it on every run; the only file the skill writes there is
+`_froid/froid-loop/module-help.csv`.
+
+The skills must be installed **together**: `froid-loop-sweep` owns the canonical
+`deferred-work-format.md` that the ledger normalizes to, and the upstream dev
+primitive must also be present (since Froid Plane 6.10.1-next.33 it records
+deferred findings in its spec's frontmatter for the orchestrator to harvest into
+the ledger; pre-rename copies append flat entries the sweep normalizes instead).
+Requires the Froid Plane (bmm) module (`_froid/bmm/config.yaml`) and a `sprint-status.yaml` from
+`froid-sprint-planning`.
+
+`_froid/custom/<skill-name>.toml` customization overrides are keyed by skill
+directory name.
+
+## Maintaining the skills
+
+- This directory (`src/froid_loop/data/skills/`) is **canonical** for the skills
+  and is bundled into the wheel as package data, so `froid-loop init` can install
+  them. The repo's `.claude/skills/` and `.agents/skills/` hold dev-workspace
+  copies; `tests/test_module_skills_sync.py` fails if they drift. After editing
+  here, re-copy the skill dirs into both trees.
+- The orchestrator tool is **not** bundled in the skill dirs — the FROID installer
+  copies only the skill directories, so a sibling `tool/` would never reach an
+  installed project. `froid-loop-setup` installs the `froid-loop` package from
+  <https://github.com/cordya-ai/froid-loop> (`src/froid_loop`, `pyproject.toml`
+  are canonical at the repo root). (The skills, by contrast, ride along inside
+  the package wheel.)
+- The inner dev primitive (`froid-build-auto`, or `froid-dev-auto` pre-rename) is
+  **not** maintained here — it is the upstream bmm-core skill, driven unmodified.
+  Nothing in this directory mirrors it; the orchestrator adapts to it via
+  `froid_loop.devcontract`.
+- Do **not** rename the result.json `workflow` values — they are machine
+  contracts the orchestrator validates, not skill names:
+  - dev → `"auto-dev"` (checked by `verify.DEV_WORKFLOW` in
+    `verify_dev` / `verify_dev_bundle`; the orchestrator forges this value in
+    `devcontract` when synthesizing the dev result from the spec).
+  - sweep triage / migrate → `"deferred-sweep-triage"` / `"deferred-sweep-migrate"`
+    (checked in `sweep.py`).
+
+Validate after changes (from the repo root):
+
+```bash
+python3 .claude/skills/froid-module-builder/scripts/validate-module.py src/froid_loop/data/skills
+```