docs: rename context/→doc/, document the installer, restructure skill wrapper guides

[yannrichet-asnr]

Reorganizes the user- and agent-facing documentation surface for clarity and completeness. Docs-only — no code changes.

What changed

context/ → doc/

• git mv so history is preserved; updated every path reference in llms.txt, README.md, CLAUDE.md, and internal cross-links.
• NEWS.md mentions intentionally left as a historical record of past releases.
• No code, packaging, or CI references the directory, so nothing breaks functionally.

New: doc/installing-models.md

The installer was a public API + CLI surface (fz install model|algorithm, fz uninstall, fz list, install_model/install_algorithm/list_installed_*) documented in the README and the skill but absent from context/ — a gap against the CLAUDE.md rule that API/CLI changes update all three doc surfaces. This adds it: CLI + Python usage, source resolution (name → github.com/Funz/fz-<code>, URL, local zip), the fz-<code> convention, and project-local vs --global. Wired into llms.txt, README.md, doc/INDEX.md, and doc/README.md.

Fixed stale "four core functions" framing

doc/overview.md, doc/README.md, and doc/INDEX.md still presented fz as having four core functions (fzi/fzc/fzo/fzr); corrected to six (adds fzl, fzd) with usage examples.

Skill guide renames + expansion

• skills/fz/wrapper.md → code-wrapper.md
• skills/fz/algorithms.md → algorithm-wrapper.md, expanded to a true peer of code-wrapper.md: metadata-header semantics (#options constructor defaults, #require auto-pip-install on load) and an fz-<name> packaging/publishing section (.fz/algorithms/<name>.py, fz install algorithm, testing, publish conventions).
• Updated all references in SKILL.md, howto.md, both e2e test files, and the static test's filename assertion.

Verification

• tests/test_skill_static.py — 10 passed (validates skill claims against the code, incl. file existence).
• No dangling context/ / wrapper.md / algorithms.md references remain outside the intentional NEWS.md history.
• CLI flags in the new docs verified against fz/cli.py (--output_expression, --options/-o).

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR reorganizes and expands the project’s documentation surface: it renames the modular docs directory from context/ to doc/, adds installer documentation, and updates skill guides and tests to reflect renamed/expanded wrapper docs.

Changes:

• Renamed modular docs directory references (context/ → doc/) across top-level docs and internal cross-links.
• Added new documentation pages (installer usage, core functions, calculators, syntax, formulas, caching, examples, fzd content formats).
• Renamed/expanded the fz skill’s algorithm wrapper guide and updated e2e/static tests accordingly.

Reviewed changes

Copilot reviewed 17 out of 26 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
tests/test_skill_static.py	Updates static skill assertions for renamed algorithm wrapper doc.
tests/test_skill_e2e.py	Updates e2e guidance strings to reference code-wrapper.md.
skills/test_skill_e2e.md	Updates skill test walkthrough references to code-wrapper.md.
skills/howto.md	Updates how-to link from algorithms.md to algorithm-wrapper.md.
skills/fz/SKILL.md	Updates wrapper/algorithm guide links to renamed docs.
skills/fz/code-wrapper.md	Points algorithm packaging guidance to the new algorithm wrapper guide.
skills/fz/algorithms.md	Removes the old algorithm guide (replaced by algorithm-wrapper.md).
skills/fz/algorithm-wrapper.md	New/expanded algorithm wrapper + packaging/publishing guidance.
README.md	Updates references from context/ to doc/ and adds installing-models.md to the docs list.
llms.txt	Updates doc links to doc/ (but still needs skill algorithm link fix per PR comment).
doc/syntax-guide.md	New syntax guide (contains a couple of inaccuracies called out in comments).
doc/shell-path.md	Updates cross-links from context/ to doc/.
doc/README.md	Updates “core functions” framing and doc tree to include new pages.
doc/quick-examples.md	New “common patterns”/examples page.
doc/parallel-and-caching.md	New parallelism + caching guide.
doc/overview.md	Updates overview to “six core functions” and links to new installer doc.
doc/model-definition.md	New model definition guide.
doc/installing-models.md	New installer documentation (CLI + Python API).
doc/INDEX.md	Updates the index and adds an installer section (title wording needs tweak per comment).
doc/fzd_content_format.md	Documents fzd analysis content detection/serialization behavior.
doc/funz-protocol.md	Updates a cross-link from context/ to doc/.
doc/formulas-and-interpreters.md	New formulas/interpreters guide.
doc/core-functions.md	New core functions guide (algorithm interface snippet needs correction per comment).
doc/calculators.md	New calculators guide (intro needed correction per comment).
CLAUDE.md	Updates repo “docs surface” reference from context/ to doc/.

Comments suppressed due to low confidence (1)

doc/INDEX.md:9

• Even after the directory rename to doc/, this index still labels the documentation as “Context” in the title/description, which is inconsistent with the new directory naming and may confuse navigation.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.