f-flat-minor

Search `.agents/` durable knowledge using a local JSON index generated from markdown sources. Use `index-docs.py` to refresh search data, and optionally run docs-compile when you also want durable section index files regenerated.

Regenerate optional durable docs indexes and rebuild docs-search cache from local markdown sources. Use after editing `.agents/docs/` (any section), and before maintenance passes that validate index alignment.

Check the `.agents/` knowledge layer for duplication, contradiction, staleness, oversized guidance, broken or stale links, missing index coverage, uncategorized or misplaced knowledge, and consistency between `decisions/` and `troubleshooting/` indexes and their entry files. Use as a periodic maintenance pass.

Read a completed temporary session bundle from `.agents/sessions/` and distill durable repo knowledge into `.agents/` files. Use only after task-closeout has produced a bundle and when the goal is to separate stable guidance from temporary task notes.

Use whenever working with maintainer plans under .agents/docs/plans/. Covers reading a plan before implementation, creating or scaffolding a plan, and updating status or body during or after work. Trigger when the user asks to plan, scope deferred work, check what is planned, or record a plan. Also trigger at the start of implementation to see whether a plan already exists.

Capture the current task into a structured temporary session bundle under `.agents/sessions/` so a learning agent can later distill durable repo knowledge. Use for completed, blocked, or abandoned tasks with meaningful changes, debugging, validation, or reusable lessons.

Scaffold a new maintainer plan under `.agents/docs/plans/<id>.md` with valid YAML frontmatter, collision-checked ids, optional body stub sections (link decisions in a

Use when writing, debugging, or refactoring f-flat-minor programs (.ff or .ffp), including syntax rules, stack-effect-first design, control flow, and runtime-specific validation.

Use when editing or debugging Project Euler programs in ff/euler/*.ffp, including preserving prompt data, implementing algorithmic solutions, and validating with the Node/Deno preprocessor runtime.

Expand a complex F♭m word to primitives (or core normal form), reduce with stack-safe rewrites, then resynthesize to canonical readable words. Supports autonomous multi-word passes with success/failure tracking and iteration.

Regenerate _docs/supplemental/ff-lib-word-definition-rankings.md — a table ranking every word in ff/lib by definition token count.

Use when refactoring non-Euler ff/*.ffp code into reusable ff/lib modules and when wiring libraries/examples into the web playground.

Use when defining internal constants and helper words in f-flat-minor math library modules to avoid global namespace collisions.