Skip to the content.

agentfs-setup Changelog

Updated Change    
2026-10-15 21:50 v7.3.6 — Session Canary rule: rewrite to CNL-style numbered Do: list — one instruction per sentence, active imperative voice    
2026-10-15 21:44 v7.3.5 — Extend rule format mandate: Do: block with 2+ actions must use numbered list, no multi-action prose paragraphs    
2026-10-15 15:37 v7.3.4 — Fix: regen-skill-index.py exit code 1 (version warnings) killed post-edit.sh via set -e before knowledge index regen could run. Added   true to suppress.
2026-10-02 22:02 v7.3.3 — v7.3.3 Rule 4: ‘start your response with’ replaces ‘Emit’ — unambiguous formatting instruction for canary placement    
2026-10-02 21:23 v7.3.2 — v7.3.2 Rule 4: simplified — ‘These rules are already in your context. Treat as authoritative.’ Removed file-reference abstraction.    
2026-10-02 21:04 v7.3.1 — v7.3.1 Rule 4: explicit ‘this document is AGENTS.md — already in context, do not search on disk’. Authoritative statement preserved. Canary format specified (two-word, ephemeral, with example). Anti-daydreaming: remember in-session, do not write anywhere.    
2026-10-02 16:22 v7.3.0 — v7.3.0: Rule 2 cross-references Rule 3 (Post-Write) and Rule 6 (Checkpoint). Rule 4 noise removal — clearer obligations. Rule 1 step 2 trimmed redundancy. Quick Orientation and Scope Definitions signal-to-noise improvements. Harvest dispatch row trimmed.    
2026-10-02 13:35 v7.2.3 — Added concrete tool call example to Signal Dispatch Rule 1 Path B: shows knowledgegraphmemory__search_nodes(query:…) for weaker model reliability    
2026-09-29 22:34 v7.2.2 — Checkpoint rule: explicit version-bump step for seed edits; pre-push-scan Category 12: seed-version-bump guard    
2026-09-29 21:42 v7.2.1 — git push gate in Pre-Flight, versioning policy in design-spec    
2026-09-29 21:27 v7.2.0 — v7.2.0 — rules consolidated 10→8, severity tags removed    
2026-09-29 17:55 v7.1.2 — v7.1.2 — Added load_skill failure handling to Signal Dispatch Path B step 3    
2026-09-29 16:59 v7.1.1 — Add Category 10: post-write coverage check — L3→L2 graduation for Rule 3 enforcement    
2026-09-29 16:16 v7.1.0 — v7.1.0 — Reordered rules by frequency: Pre-Flight and Post-Write promoted to HIGH (position 2-3), Session Start/Canary/Conflict Resolution moved to NORMAL (position 4-6). Post-Write Hook renamed to Post-Write.    
2026-09-29 14:23 v7.0.0 — v7.0.0 — Prose rules with priority tags, generated Signal Dispatch table from patterns.txt, named rule references    
2026-09-28 14:45 v6.0.9 — Rule 2 prose polish: -16 words, removed redundant clauses, tightened fallback chain    
2026-09-28 14:27 v6.0.8 — Added Scope Definitions to PROJECT template heredoc — fixes sync/verify misalignment    
2026-09-28 14:02 v6.0.7 — Tier 2 fixes: Rule 2 search_nodes fallback, Rules 4/7 script-not-found guards, Rule 10 adaptive canary cadence    
2026-09-28 13:48 v6.0.6 — Rule 4: added template ownership guard — edit seed-agents-md.sh not project copy for template-owned content    
2026-09-28 13:43 v6.0.5 — Tier 1 clarity: added keyword definition+example to Rule 2, added multi-step threshold to Rule 8 in project template    
2026-09-28 11:05 v6.0.4 — Rule 2: Added query construction constraint — use literal signal keywords only, no expansion/padding; progressive narrowing on miss (drop rightmost first)    
2026-09-28 10:51 v6.0.3 — Vendor-neutral SOUL.md fallback: added plain-text instruction for non-Goose agents. Moved context lookup fallback from top-of-file to Quick Orientation section. Applied same SOUL.md pattern to lite template.    
2026-09-27 23:47 v6.0.2 — Rule 2: mandatory search_nodes first — ‘first tool call MUST be search_nodes’, closes smart-model shortcut    
2026-09-27 22:11 v6.0.1 — v6.0.1: Patch — SOUL.md sync via seed-soul.sh, plugin version detection in post-write, Rule 10 unconditional re-read    
2026-09-27 20:02 v6.0.0 — v6.0.0: Added plugins/ and scripts/ directories to USER scope scaffolding and index.md template    
2026-09-25 23:36 v6.0.0 — v6.0.0: Updated SOUL/AGENTS layer descriptions, signal dispatch architecture, scope tables (added plugins/ scripts/), KI-1 mitigated status, added v6.0.0 changelog entry    
2026-09-25 01:46 v5.16.0 — v5.16.0 — Remove Tool Priority section and Rule 8; generalize Rule 7 to ‘hey ' dispatch; renumber rules 8-17; -190 tokens    
2026-09-25 00:50 v5.15.0 — v5.15.0 — Generic Rule 7: ‘hey ' → search_nodes dispatch prefix for reliable skill invocation on weaker models    
2026-09-25 00:22 v5.14.0 — Add Known Issues section: KI-1 command-shaped signal phrase vs shell tool dispatch ambiguity    
2026-09-24 23:26 v5.14.0 — v5.14.0 — Add Tool Priority section, strengthen Rule 8 anti-shell clause for weaker models    
2026-09-24 20:46 v5.13.0 — Delete Discovery Tiers section, add context lookup fallback note, Rule 8 uses search_nodes    
2026-09-24 19:24 v5.12.0 — Rule 8: KGM-based skill dispatch via search_nodes, fallback to # Skills    
2026-09-24 17:43 v5.11.3 — Rule 8: add anti-pattern clause and concrete example (audit context → agentfs-ctx-chk → load_skill)    
2026-09-24 16:09 v5.11.2 — post-write.sh now fails (exit 1) instead of warning when skill file modified without –version    
2026-09-24 14:54 v5.11.1 — Rule 1 agent-agnostic, USER.md read at session start, fix USER.md orphan    
2026-09-24 12:39 v5.11.0 — Reorder sections (Scopes→Discovery→Rules→Orientation), merge Discovery tier table with Action column, remove redundant CRITICAL preamble and WHY prose from rules, add anti-pattern callout, trim ~22% tokens    
2026-09-16 11:46 v5.10.1 — Added regen_knowledge_index to post-edit checks — regenerates knowledge/index.md using rebuild-index.sh (reverse-chronological ordering) before auditing    
2026-09-16 09:11 v5.10.0 — Discovery Tiers restructured: split Tier 2 into 2a (skills), 2b (KGM preferred), 2c (knowledge index fallback); added staleness guard and freshness check rules    
2026-09-10 21:31 v5.9.0 — Added Rule 18 (Pre-Flight Checklist) to AGENTS.md template    
2026-09-10 17:39 v5.8.1 — post-edit.sh: added log drift detection — compares skill file modification times against latest log entry timestamp, warns on unlogged modifications to catch missed Rule 13 obligations.    
2026-09-10 13:56 v5.8.0 — Updated Skill Placement guardrail: default to PROJECT, promote to USER when cross-project demand is proven. Updated design-spec.md to match.    
2026-09-09 22:16 v5.7.0 — agentfs-setup v5.7.0: Added post-write.sh orchestrator script. Redesigned Rule 13 — trigger moved from ‘after each write’ to ‘before sending response’ (end-of-turn audit); action collapsed from 4 manual steps to single post-write.sh call. Updated seed-agents-md.sh template, filesystem-integrity.md, and project AGENTS.md.    
2026-09-08 15:33 v5.6.0 — Added Anti-Action-Sycophancy: Rule 17 (no action on assumed inputs — state missing info, ask, do not execute; flag low confidence at top) to seed-agents-md.sh template; added anti-assumption identity principle to author-soul.sh default SOUL.md template; updated SKILL.md rule inventory (12→13 rules). Addresses action sycophancy gap exposed by Agentbox weather session.    
2026-09-04 15:01 v5.5.0 — Added Script Input/Output Conventions section to SKILL.md (log entry format: bullet-prefixed). Fixed merge-log-entry.sh header comment: removed format prescription, now mechanical-only (SoC). Added Cross-Skill Script Execution priority table to filesystem-integrity.md.    
2026-09-04 13:12 v5.4.0 — Redesigned Rules system: merged Signal Routing + Rules into single typed table (Signal/Event/Always); added Discovery Tiers section (Frontmatter → Index → KGM fallback chain); added mandatory enforcement preamble; grouped rules by phase (session-start → dispatch → before-read → before-write → after-write → always); inlined script paths pointing directly to ~/.agents/skills/agentfs-setup/scripts/; absorbed old Rule 8 into Discovery Tiers; clarified trigger thresholds for destructive ops and .agents/ access; added Rule 12/13 complementary note for memories writes    
2026-08-31 20:45 v5.3.0 — Rule #1 KGM triage tightened: MUST read Source files for top 3 results before answering, summaries alone are insufficient (replaces ambiguous review-then-read wording)    
2026-08-31 20:31 v5.2.0 — Added post-sync Rule re-read requirement: agent MUST re-evaluate AGENTS.md rules after sync and load KGM JSONL into live graph when search_nodes tools are available but graph is empty (fixes bootstrap ordering problem where KGM clause only exists after template upgrade)    
2026-08-31 16:50 v5.1.0 — Rule #1 KGM-aware dispatch (search_nodes → read Source files, agent-agnostic wording), LITE template: removed Idempotency rule and aligned git safety to v5 pattern, rewrote test-agents-md-fidelity.sh for v5 structure (78 checks), added KGM to README.md Semantic Memory section, CHANGELOG format fixes across 3 skills    
2026-08-31 15:58 v5.0.0 — AGENTS.md template rewrite: 12-rule flat Trigger/Action table (69% token reduction, 1227 tokens), externalized Git Push Safety to agentfs-git-push skill, added context enrichment rule, split Anti-Sycophancy into communication + conflict resolution, removed Idempotency and Quick Reference table, conditional KGM reindex in post-edit.sh    
2026-08-26 21:34 v4.19.0 — Scope consolidation: renamed –mode to –scope (user/project/lite). Added LITE scope for small-context models. LITE AGENTS.md template (~850 tokens). Scope metadata in AGENTS.md (agentfs-scope: project/lite). sync-agents-md.sh detects and preserves scope. verify-setup.sh supports –scope lite. Added LITE scope usage section with inference rule, lifecycle model, updated Sync and Verification sections.    
2026-08-26 13:40 v4.18.0 — Added Guardrail #0 (Signal-First Dispatch) — ⛔ GATE requiring models to scan skill description signals before generic interpretation. Addresses routing failures on smaller models. Updated Quick Reference table and guardrail body text.    
2026-08-26 12:36 v4.17.8 — post-edit.sh: added knowledge index audit (calls okf-bundle-index audit-index.sh). Guardrail #5 Gate 3: MUST use rebuild-index.sh for knowledge indexes.    
2026-08-26 12:22 v4.17.7 — Guardrail #5 Delegation: log.md entries MUST use merge-log-entry.sh (no direct write/edit except initial file creation). Added knowledge root log to scope table.    
2026-08-21 00:04 v4.17.6 — seed-agents-md.sh + AGENTS.md: add Guardrail #5 scope note clarifying that README.md at ~/.agents/ is AgentFS-managed and not exempt from post-edit.sh and log.md requirements    
2026-08-20 23:27 v4.17.5 — author-soul.sh: fix is_stub() — replace grep-based line filter with awk multi-line comment stripper (matches sync-agents-md.sh logic); content inside example blocks no longer falsely marks file as non-stub    
2026-08-20 23:24 v4.17.4 — sync-agents-md.sh + SKILL.md: replace raw bash hints with SOUL_ACTION_REQUIRED machine signal; agent now guides user conversationally (apply default / customise / skip) instead of printing bare shell commands. Updated SKILL.md with agent post-sync action spec.    
2026-08-20 23:17 v4.17.3 — sync-agents-md.sh: detect stub SOUL.md during sync (both up-to-date and upgrade paths); emit actionable warning with author-soul.sh command when SOUL is empty or missing. Uses awk-based multi-line comment stripping for accurate stub detection.    
2026-08-20 22:55 v4.17.2 — Fix merge-changelog-entry.sh: use YYYY-MM-DD HH:MM timestamp (consistent with merge-log-entry.sh); fix dedup to match on date+version regardless of time component    
2026-08-20 00:00 v4.17.1 — Backlog: add test-pre-push-scan.sh Category 9+10 tests (25/25 pass); fix test setup (log.md pre-seeded, README assertion); update test-agents-md-fidelity.sh (merge-changelog-entry.sh + WAIT-in-same-turn assertions, 84/84); sync-agents-md.sh pre-versioning fallback    
2026-08-20 00:00 v4.17.0 — Add sync-agents-md.sh: deterministic idempotent AGENTS.md sync (version check, profile row extraction excluding default, awk-based re-injection, SPECKIT preservation); fix Agent Profiles duplication bug from ad-hoc sed commands; update SKILL.md sync mode docs and Scripts table    
2026-08-20 00:00 v4.16.0 — Guardrail #10: add rendered Markdown requirement for report presentation (no code fence); add Category 10 memory file PII detection to pre-push-scan.sh; add 5th violation (skip semantic PII review); update Quick Reference row    
2026-08-20 00:00 v4.15.0 — Harden Guardrail #10 Git Push Safety: numbered 8-step workflow; README audit trigger clarified (staged AND staleness Clean); ‘same turn’ confirmation requirement; 4 explicit violations listed; Quick Reference row updated    
2026-08-20 00:00 v4.14.0 — Add merge-changelog-entry.sh (deterministic CHANGELOG updates, repair, dedup); add CHANGELOG coverage check to pre-push-scan.sh (Category 9); update post-edit.sh reminder; update seed-agents-md.sh delegation table; update README Guardrail #5 summary    
2026-08-20 00:00 v4.13.0 — Add author-soul.sh (interactive SOUL authoring); refactor scaffold-dotagents.sh to delegate SOUL creation; add @.agents/SOUL.md import to AGENTS.md template; expand Guardrail #7 anti-sycophancy (pushback capitulation, steelman, praise-opener ban); update verify-setup.sh with SOUL content checks; add test-soul-authoring.sh (21 tests); fix test-agents-md-fidelity.sh assertion    
2026-08-19 00:00 v4.12.0 — Guardrail #10 Git Push Safety: added .pre-push-allowlist semantic filtering step. Agent reads allowlist at repo root and semantically matches scan findings against known false positive descriptions. Findings matching allowlist are reported as Known FP and don’t block. Updated workflow and Quick Reference in seed-agents-md.sh.    
2026-08-18 00:00 Fixed regen-skill-index.py: uses max mtime across all files in skill directory instead of SKILL.md only    
2026-08-17 11:20 v4.11.0 — Enhanced Gate guardrails: changed type icon from 🚧 to ⛔ GATE for #5 (Filesystem Integrity), #9 (Checkpoints), #10 (Git Push Safety). Added “STOP before” language, explicit violation definitions, and stronger Key Action phrasing in Quick Reference table. Updated seed-agents-md.sh template and design-spec.md to match. Template version 4.10→4.11.    
2026-08-16 19:36 v4.10.0 — merge-log-entry.sh: fixed duplicate heading bug — replaced echo-pipe-grep with direct grep on file for heading detection. Eliminates false-miss when piping large file content through echo.    
2026-08-16 19:27 v4.9.0 — Guardrail #5: added edit-time logging rule to seed-agents-md.sh template (log immediately after each edit, not batch-at-end). Added log coverage check (Category 8) to pre-push-scan.sh — flags ⚠️ GAP when staged files lack same-day log.md entry. README.md updated.    
2026-08-16 19:11 v4.8.0 — Guardrail #10 Git Push Safety: integrated agentfs-readme-audit skill as semantic README alignment check after pre-push-scan.sh returns ✅ Clean for README staleness. Updated Quick Reference row and workflow description.    
2026-08-16 18:40 v4.7.0 — pre-push-scan.sh: promoted README staleness from interactive prompt to structured report row (Category 7); removed swallowable y/n notice; exit code 1 when stale    
2026-08-16 17:44 v4.6.0 — Guardrail #5 Filesystem Integrity rewrite: separated WHAT (completion gate) from HOW (delegation table) with Gate column for traceability; added scope rule table (USER/PROJECT/knowledge log mapping); removed inline code block (scripts path declared once); Quick Reference row updated    
2026-08-16 17:12 v4.5.0 — Guardrail #10 Git Push Safety: clarified workflow order (stage → scan → report → wait → commit → push); scan MUST run before commit on staged changes; README staleness check preserved in pre-push-scan.sh    
2026-08-16 16:52 v4.4.0 — Template version in seed-agents-md.sh now reads from SKILL.md metadata.version (single source of truth). Eliminates manual template version bumps.    
2026-08-16 16:49 v4.3.0 — Made Guardrail #5 completion gate explicit with 4-item checklist (post-edit.sh, log.md, CHANGELOG, metadata.version). Aligned Quick Reference #5 row to match.    
2026-08-16 16:39 v4.2.0 — Added metadata.version bump to Guardrail #5 completion gate checklist (3 key actions: post-edit.sh, log/CHANGELOG, version bump). Template version updated.    
2026-08-16 16:36 v4.1.0 — Added version-CHANGELOG alignment check to regen-skill-index.py: compares metadata.version against latest CHANGELOG entry, warns on mismatch. Normalizes trailing .0 to avoid false positives (e.g., 1.0.0 matches 1.0).    
2026-08-16 16:22 v4.0.0 — AGENTS.md token optimization (39% reduction). Extracted regen-skill-index.py from post-edit.sh inline heredoc (DRY). Created pre-push-scan.sh (replaces Guardrail #10 prose), checkpoint.sh (replaces #9 prose). Compressed guardrails #2, #3, #7, #8 prose; removed #1, #6 detail (table-only). Added completion gate to Guardrail #5 (forward-carry pattern). Added test scripts: test-pre-push-scan.sh, test-checkpoint.sh, test-agents-md-fidelity.sh. Template version 3.14→4.0.    
2026-08-16 13:26 v3.14.0 — Moved merge-log-entry.sh from okf-bundle-gen to agentfs-setup (foundational skill owns shared utilities). Updated 17 references across 6 skills. Removed Root Log Format subsection from Guardrail #5 (mechanics now in script). Updated delegation table: root logs use merge-log-entry.sh, skills index uses post-edit.sh. Template version 3.13→3.14.    
2026-08-15 11:57 v3.13.0 — Added post-edit.sh script: automates fragile post-edit steps (skills index regeneration, log.md anchor validation). Guardrail #5 STOP block now references post-edit.sh instead of delegation table. Quick Reference row updated. Follows skill-gen principle: loose steps → instructions, fragile steps → code.    
2026-08-14 19:40 v3.12.0 — Removed Post-Edit Completeness subsection from Guardrail #5 (redundant with delegation table). STOP block moved to top as one-liner. 64→45 lines. Template version 3.11→3.12.    
2026-08-14 19:19 v3.11.0 — Rewrote Guardrail #5 (Filesystem Integrity): replaced 4 subsections (Link Integrity, Log & Changelog Currency, Index Currency, Post-Edit Completeness) with 4 focused sections (Editing Rules, Log & Index Delegation table, Root Log Format, Post-Edit Gate). Added delegation table mapping every log/index file to its owning skill and update method. Removed 26 lines of redundancy. Updated Quick Reference row. Template version 3.10→3.11.    
2026-08-12 22:55 v3.10.1 — Guardrail #5 (Log & Changelog Currency): added 24-hour format hint with date command to ISO 8601 timestamp rule. Index Currency: consolidated skill-index requirement into the MUST-stay-current bullet (removed separate bullet); explicit load_skill(name: "skill-index") call-out.    
2026-08-11 11:48 v3.10.0 — Added Guardrail Type System (Gate 🚧, Rule ⚖️, Habit 🔄): Type column in Quick Reference table with verb-chain Key Actions; type badges on all 10 guardrail headings; gate blockquote notices on #5 (Filesystem Integrity), #9 (Checkpoints), #10 (Git Push Safety); design-spec updated with type rationale and Trigger/Invariant collapse analysis; template version 3.9→3.10    
2026-08-08 10:55 v3.9.0 — Added “Never improvise when a skill exists” routing rule; added “Backup untracked files” to Guardrail #9 (Checkpoints); template version 3.8→3.9    
2026-08-04 19:40 v3.8.1 — Strengthened Index Currency guardrail in AGENTS.md template: explicitly prohibits ad-hoc scripts for index generation; requires load_skill and following skill-index instructions    
2026-07-31 21:42 v3.8 — Added Guardrail #8 Anti-Daydreaming (ephemeral session canary name for context-drift detection); renumbered Checkpoints → #9, Git Push Safety → #10; clarified Index Currency trigger to include metadata-only changes; updated design-spec and all cross-references    
2026-07-27 17:10 v3.7 — Added metadata.signals frontmatter field spec to design-spec; slimmed Signal Routing table to LLM-direct + ambiguous routes only (11→9 rows); added skill discovery note for signal-routed intents; added template version stamp (<!-- agentfs-template-version: X.Y -->); added --sync mode for updating existing AGENTS.md from latest template; added project-owned section markers; added metadata.signals to SKILL.md frontmatter    
2026-07-15 16:50 v3.6 — Added Guardrail Quick Reference table after Signal Routing: one-line scannable checklist with anchor links to detailed guardrail sections; promotes post-edit discipline and all 9 guardrails to high-attention position    
2026-07-15 15:00 v3.5 — AGENTS.md template: promoted Signal Routing to standalone section after Quick Orientation (was under Guardrail #2); renamed Guardrail #2 to “Memory Scope”; added “hey git” signal; added Post-Edit Completeness sub-section to Guardrail #5; added log insertion anchor rule; changed knowledge index link to backtick format (no more [blocked] in renderers)    
2026-07-14 19:26 v3.4 — AGENTS.md template compacted 277→207 lines (25%): removed Resolves To column and Rule of Thumb blockquote from Scope Definitions; dropped Executor/Scope columns from routing table; collapsed Skill Resolution Chain; merged Content File Currency into Log & Changelog Currency; replaced Git Push Safety verbose template with compact 5-step list; updated sed insertion block for Scope Definitions    
2026-07-14 17:49 v3.3 — AGENTS.md template consolidated from 13 to 9 guardrails (reordered by usage frequency): merged Memory Scope + Signal Routing into #2, merged Link/Log/Changelog/Index integrity into #5 (Filesystem Integrity); Quick Orientation now includes SOUL.md and knowledge index for agent-agnostic progressive loading; removed redundant skill-placement and log-scope restatements    
2026-07-14 15:22 v3.2 — AGENTS.md template now includes thirteen guardrails (was nine): added #10 Idempotency, #11 Checkpoints & Resumability, #12 Anti-Sycophancy, #13 Git Push Safety (mandatory 5-step preflight before any git push)    
2026-07-13 15:44 v3.1 — Git init now runs by default in PROJECT mode (calls init-git.sh at project root); .gitignore no longer excludes .agents/memories/ (full audit trail); updated for agentfs-eval compatibility    
2026-07-10 18:07 v3.0 — PROJECT is now the default mode; added canonical Scope Definitions section; documented two USER setup paths (full clone vs minimal install); added Prerequisites section; AGENTS.md template now includes Scope Definitions; nine guardrails (was eight)    
2026-07-08 13:38 v2.10 — Recreated SKILL.md after accidental deletion; reflects memory redesign (knowledge USER-only, memories PROJECT-only, 8 guardrails, updated layer reference)    
2026-07-07 16:52 v2.9 — Added Cross-Agent Context Discovery guardrail (§7) to AGENTS.md template    
2026-06-30 23:49 v2.7 — Expanded guardrail §2: explicit USER/PROJECT/sub-bundle scope; mandatory skill/concept change logging    
2026-06-30 23:36 v2.6 — Changelog tables now use Updated header and YYYY-MM-DD HH:MM timestamps    
2026-06-30 23:31 v2.5 — Renamed index column Added → Updated; timestamp precision YYYY-MM-DD HH:MM    
2026-06-30 23:16 v2.4 — Added Index Currency guardrail (§6); expanded Profiles Layer    
2026-06-30 18:30 v2.3 — Added profiles/index.md; fixed link targets    
2026-06-30 17:30 v2.2 — Idempotent re-run verify --fix mode    
2026-06-30 15:30 v2.1 — Added Agent Profiles table to AGENTS.md    
2026-06-30 14:00 v2.0 — Renamed modes; memory/ → memories/; roles/ → profiles/; added SOUL.md, USER.md, MEMORY.md    
2026-06-26 22:00 v1.1 — Added optional git/spec-kit init; verify script    
2026-06-26 14:00 v1.0 — Initial design: USER/PROJECT dual-mode