Files changed: - .gitignore - CHANGES.md - VERSION - docs/explanation/architecture.md - docs/explanation/pipeline-rationale.md - docs/how-to/README.md - docs/how-to/back-up-to-a-synced-folder.md - docs/how-to/collect-from-a-synced-folder.md - docs/how-to/ingest-a-source.md - docs/how-to/set-up-the-mcp-server.md - docs/reference/commands/README.md - docs/reference/commands/git.md - docs/reference/commands/instance-health.md - docs/reference/commands/raw-material-and-uploads.md - docs/reference/configuration.md - instructions/gates.md - instructions/ingest-queue.md - instructions/mcp-read-server.md - instructions/migrations/10.0.0-settings-tiers.md - instructions/wiki-ingest/SKILL.md - raw/CONTRACT.md - tools/CONTRACT.md - tools/README.md - tools/chemenu/cli_contract.py - tools/chemenu/collect.py - tools/chemenu/commands/backup_cmd.py - tools/chemenu/commands/docs_verify.py - tools/chemenu/commands/doctor.py - tools/chemenu/commands/raw/pending.py - tools/chemenu/commands/upload_cmd.py - tools/chemenu/config.py - tools/chemenu/config_shapes.py - tools/chemenu/legacy_settings.py - tools/chemenu/mcp/server.py - tools/chemenu/reference_doc.py - tools/chemenu/tests/test_backup.py - tools/chemenu/tests/test_collect.py - tools/chemenu/tests/test_config_shapes.py - tools/chemenu/tests/test_doctor.py - tools/chemenu/tests/test_legacy_settings.py - tools/chemenu/tests/test_mcp_server.py - tools/chemenu/tests/test_upload.py - tools/chemenu/tests/test_upload_cmd.py - tools/chemenu/upload.py Co-Authored-By: Claude Code <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
2.2 KiB
2.2 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
- Collect documents from a synced folder - a folder OneDrive and the like fill, or a program of your own, as an intake channel into the quarantine
- Back up to a synced folder - OneDrive and the like as the backup of an instance without a git server, and restoring from it
Installing a new instance is INSTALL.md at the repository root.