Files changed: - CHANGES.md - INSTALL.md - VERSION - docs/how-to/README.md - docs/how-to/fetch-pages-behind-a-login.md - docs/how-to/ingest-a-source.md - docs/reference/commands/README.md - docs/reference/commands/instance-health.md - docs/reference/commands/raw-material-and-uploads.md - docs/reference/configuration.md - docs/reference/exit-codes.md - instructions/preflight.md - instructions/wiki-ingest/SKILL.md - raw/CONTRACT.md - sites/CONTRACT.md - tools/CONTRACT.md - tools/README.md - tools/chemenu/browser.py - tools/chemenu/cli_contract.py - tools/chemenu/commands/doctor.py - tools/chemenu/commands/raw/__init__.py - tools/chemenu/commands/raw/fetch.py - tools/chemenu/commands/raw/login.py - tools/chemenu/config_shapes.py - tools/chemenu/fetch_routes.py - tools/chemenu/reference_doc.py - tools/chemenu/settings.py - tools/chemenu/sites/__init__.py - tools/chemenu/sites/data.py - tools/chemenu/sites/site.schema.json - tools/chemenu/tests/test_cli.py - tools/chemenu/tests/test_config_shapes.py - tools/chemenu/tests/test_doctor.py - tools/chemenu/tests/test_preflight.py - tools/chemenu/tests/test_preflight_pwsh.py - tools/chemenu/tests/test_raw_fetch_routes.py - tools/chemenu/tests/test_raw_login.py - tools/chemenu/tests/test_site_files.py - tools/chemenu/web_capture.py - tools/chemenu/web_session.py - tools/preflight.ps1 - tools/preflight.sh - tools/requirements-browser.txt Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
1.8 KiB
1.8 KiB
How-to guides
Task-oriented pages for the operator of an instance: one goal per page - upgrade an instance,
set up the MCP read server, run a weekly review - with the steps a human takes and the sentence
handed to the agent. A how-to guide never retells an agent's procedure: the steps an agent runs
live in instructions/, and a guide here says what to prepare, what to ask for and where the
agent stops.
Working with the wiki:
- Ingest a source - a file, a folder, a web page, or a document submitted through the MCP server
- Write a site handler - teach
raw fetchhow a website serves its pages - Fetch pages behind a login - with your own session, through a browser, or through a fetch program of your own
- Capture documentation from a git repository - and keep it current
- Export guidelines to captured repositories
- Query the wiki - asking, and searching yourself
- Maintain the wiki - lint, provenance, and the gates on the way to a publish
- Run the weekly review - commitments in a task tracker against the project pages
- Browse the wiki in Obsidian - and how pages are named
Running the instance:
- Update an instance - to a newer release of the stack
- Troubleshoot an instance
- Set up the MCP read server - for a consumer that is not a terminal on this machine
- Trace and score agent sessions
- Use 1Password for settings - secrets and private values out of the tree, on the desktop and in CI
Installing a new instance is INSTALL.md at the repository root.