Repository navigation
finolabs-vibecode v0.1.7
Added
-
fnl-scan-agentsrefreshes the local agent inventory and user-confirmed allowed models;fnl-delegateroutes only among recorded present families and warns once per session when the section is older than 30 days. The scan runs only three fixed--versioncalls, readshost.md, uses no network and stores nothing outsidehost.md; a clear yes is required for its atomic section-only write. -
fnl-set-modeshows effective Delegation mode and Routing with their sources and environment overrides, previews changes and writes only those settings after a clear yes. Setup uses the scan, Check reports missing/stale inventory and retired context pointers, and the README includes light/dark skill architecture diagrams. -
New behavior evals for the router in a Spec Kit repository, a repository with mattpocock/skills, and one with no workflow pack.
-
fnl-delegate"Keep or hand off": a coordinator holding two or more independent tasks with clear acceptance tests dispatches them or records why it kept them, before starting the first; undersuggest(the default), it asks first. The coding router points to it.record.py keepprints one line with a count, a fixed reason and who settled it, and with usage metrics on the hook stores it as a newkeptevent, under the same consent, retention and purge as other events; existing consents cover it. Thefnl-statusdelegation pane shows the tasks kept beside the implementation runs handed off. -
Add user-chosen Delegation mode (manual, suggest or auto) and Routing (on/off), with a read-only settings reader, setup choices and honest Check reporting. Claude Code and Codex session-start reminders honor Routing; Antigravity’s static rule cannot, and safety gates remain unchanged.
-
Add a default-on, cached release check and synchronous startup notice, verified on Claude Code and unverified on Codex and Antigravity (Codex ships a hook; Antigravity has none), with
FNL_UPDATE_CHECK=offand the user-invokedfnl-updateskill for explicit update approval, skip and never-ask choices; the detached GET sends nothing about the user and works independently of metrics consent. -
fnl-setuphas a Check mode: a read-only local check reports setup evidence and runtime limits per host, with a small optional smoke task.fnl-askroutes setup checks to it. -
The
fnl-statusdashboard updates itself while its tab is open: the page reloadsdata.jsevery 5 seconds while visible and redraws when the numbers changed, and the hooks rebuild the file at most once per 10 seconds during a session and at each stop and session start (Claude Code and Codex; on Antigravity the page follows rebuilds made elsewhere). Checked in Chrome; Safari and Firefox are unverified. It stays local: no server and no listener. -
Plain-language guidance in
fnl-askandfnl-setup: lead with the result, use everyday words and ask only the user's decisions. Both skills carry an identical reference so each works alone; CI checks the copies match. -
fnl-handoffhas a Resume mode: it writes a handover for a later session or another agent without dispatching anything. The handover is a note in the knowledge base the user's instructions name (taggedhandoff, with a pointer line at the top of the project's state entry), or a brief file without one, and the agent's native memory holds at most a pointer. The agent that continues reads the latest handover, trusts the repository where they disagree, does the first unfinished step, asks before a merge, a deploy or a deletion, and updates the same note as it goes. The brief template gains two optional headings, "Waiting on" and "Linked runs or sessions". -
fnl-setupnow suggests thediagram-designskill set (MIT, cathrynlavery/diagram-design) for users who draw architecture or flow diagrams, with install commands. Our skills work without it.
Fixed
fnl-delegate: undersuggestthe coordinator no longer asks the user to approve a session of its own kind (for example a Codex session in its own worktree started from Codex, or one a repository's rules require); that is the coordinator doing the work, and an offer names an agent of another family.- The three usage-metrics hook commands on Claude Code now end with
; exit 0, as the Codex and update hooks already did, so a missing or broken script can never return a blocking exit code. A test pins the guard on every shipped hook command. - The update-check tests no longer depend on the manifest version, so a version bump cannot break them.
Changed
-
Consolidate 20 skill folders into 17:
fnl-committee→fnl-advisor(references/committee.md),fnl-coordinator-sessions→fnl-delegate(references/coordinator-sessions.md), andfnl-knowledge→fnl-session-hygiene(references/knowledge.md). Use the surviving skill names; committee and knowledge procedures load only when needed, and session hygiene owns saved handovers. -
Clarify six own-kind delegation follow-ups: use sessions or headless runs, limit offer-free starts under manual to project requirements or context pressure with a one-line reason, define own kind by the recorded coordinator family, else the host family, retain delegate authority limits, respect project session rules, and reject Codex hand-off offers in the keep-own-kind eval.
-
The README explains the bricks idea (small skills plus a guideline, inspired by the LEGO Group's turnaround under Jørgen Vig Knudstorp; independent of and not endorsed by the LEGO Group), says what you hand over and what stays with you, and gains a Check step in the three-minute start. The repository social preview shows a robot built from bricks.
-
fnl-coding-routernow works in any repository. Depth, the review and security gates, proof, "Proportion" and the stop-before-a-third-fix checkpoint are the core; the workflow is a short first step that reads one adapter underreferences/workflows/:speckit.md(every Spec Kit rule and the Spec Kit depth gate, unchanged in meaning),mattpocock.md,superpowers.md, ornone.md, a self-contained procedure (bounded clarification, a genuine red, the smallest change, proof, review) for repositories with no workflow pack. The description is workflow-neutral, and the fallback table that pointed to skills a user might not have is gone. -
fnl-session-hygienemarks the 60% compaction rule advisory unless enforced by the host or a hook, with enforcement unverified until verified. The README andfnl-askcontents also list session wrap-up as a trigger forfnl-handoff. -
fnl-setup-instructionsoffers user, project or both scopes, with repository context sourced fromAGENTS.md, a Claude include and private local context kept out of git. Its user contract asks for delegation and compaction preferences and distinguishes advisory rules from verified enforcement. -
fnl-askroutes Start, Contents, Explain and Route questions to references, reads the target before answering and still invokes nothing; all modes share the beginner definition and register, with one question first for a bare invocation. The onboarding order is/fnl-ask, Quick setup, a first task, user instructions (immediately after setup on Codex), and the dashboard later. -
The README opens in plain words, with a three-minute start and a glossary, and teaches the same onboarding order to users and agents.
-
fnl-setupoffers a beginner path before the mode choice and uses it only for users who say they are new to coding or accept the offer. Its closing handover lists user instructions (immediately on Codex, after the first result elsewhere), matching companion suggestions and the skipped sections to revisit later.
What to do
- Update the plugin through your host's plugin update (the new update check, on by default, will tell you from now on; type
/fnl-update,$fnl-updateon Codex), or on Antigravity reinstall withagy plugin install https://github.com/finolabs/finolabs-vibecode. Claude Code needs a restart; Codex hooks need your trust again. - Delegation mode defaults to
suggest(the agent names who could take a task and waits for your yes). Use/fnl-set-mode($fnl-set-modeon Codex) to see or change it and Routing, and/fnl-scan-agentsto refresh present families and confirmed models. - The update check makes one GitHub request every 24 hours. Set
FNL_UPDATE_CHECK=offto stop it; seePRIVACY.md. - Run
/fnl-setupand choose Check to see what runs on its own on your host and what is unverified.