Files changed: - .gitea/workflows/ci.yml - .gitignore - .vibe/hooks.toml - AGENTS.md - CHANGES.md - EVALS.md - INSTALL-MCP.md - INSTALL.md - README.md - VERSION - docs/dev/development.md - docs/explanation/README.md - docs/explanation/architecture.md - docs/explanation/language-boundaries.md - docs/explanation/telemetry-and-evaluation.md - docs/how-to/README.md - docs/how-to/browse-with-obsidian.md - docs/how-to/capture-repository-docs.md - docs/how-to/export-guidelines.md - docs/how-to/ingest-a-source.md - docs/how-to/maintain-the-wiki.md - docs/how-to/query-the-wiki.md - docs/how-to/run-the-weekly-review.md - docs/how-to/set-up-the-mcp-server.md - docs/how-to/trace-and-score-sessions.md - docs/how-to/troubleshoot.md - docs/how-to/update-an-instance.md - docs/reference/README.md - docs/reference/commands/distribution-and-versioning.md - docs/reference/commands/instance-health.md - docs/reference/commands/raw-material-and-uploads.md - docs/reference/commands/telemetry.md - docs/reference/commands/types-instructions-and-docs.md - docs/reference/configuration.md - instructions/dev/dev-setup.md - instructions/dev/doc-pull-through.md - instructions/dev/stack-build/SKILL.md - instructions/dev/testing-conventions.md - instructions/dev/version-parts.md - instructions/setup-instance.md - instructions/upgrade-instance.md - reports/CONTRACT.md - tools/.coveragerc - tools/CONTRACT.md - tools/README.md - tools/chemenu/commands/dist_cmd.py - tools/chemenu/commands/docs_verify.py - tools/chemenu/commands/doctor.py - tools/chemenu/commands/eval_cmd.py - tools/chemenu/commands/git_publish.py - tools/chemenu/commands/upload_cmd.py - tools/chemenu/commands/version_cmd.py - tools/chemenu/evals/__init__.py - tools/chemenu/evals/scorecard.py - tools/chemenu/evals/trajectory.py - tools/chemenu/telemetry/policy.py - tools/chemenu/tests/test_dist_cmd.py - tools/chemenu/tests/test_git_publish.py - tools/chemenu/tests/test_instructions_shell.py - tools/chemenu/tests/test_pipeline_l0.py - tools/chemenu/toc.py Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
30 lines
1.5 KiB
Markdown
30 lines
1.5 KiB
Markdown
# 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](ingest-a-source.md) - a file, a folder, a web page, or a document submitted
|
|
through the MCP server
|
|
- [Capture documentation from a git repository](capture-repository-docs.md) - and keep it current
|
|
- [Export guidelines to captured repositories](export-guidelines.md)
|
|
- [Query the wiki](query-the-wiki.md) - asking, and searching yourself
|
|
- [Maintain the wiki](maintain-the-wiki.md) - lint, provenance, and the gates on the way to a publish
|
|
- [Run the weekly review](run-the-weekly-review.md) - commitments in a task tracker against the
|
|
project pages
|
|
- [Browse the wiki in Obsidian](browse-with-obsidian.md) - and how pages are named
|
|
|
|
Running the instance:
|
|
|
|
- [Update an instance](update-an-instance.md) - to a newer release of the stack
|
|
- [Troubleshoot an instance](troubleshoot.md)
|
|
- [Set up the MCP read server](set-up-the-mcp-server.md) - for a consumer that is not a terminal
|
|
on this machine
|
|
- [Trace and score agent sessions](trace-and-score-sessions.md)
|
|
|
|
Installing a new instance is [INSTALL.md](../../INSTALL.md) at the repository root.
|