| 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 "$EXISTING" | grep pipe 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 |
|
|
|
|