# Agent Guidance

This is Thortiq developer kit `1.0.0` for Plugin API
`1.0.0`.

Read `docs/quickstart.md`, `docs/runtime-choice.md`,
`docs/compatibility.md`, and the relevant recipe.
Read `docs/development-lifecycle.md` before link, install, uninstall, or handoff.
Use `docs/api-reference.md`, `types/`, and `schemas/` as the authoritative
contract. This file routes to those sources and does not duplicate the API.

- Never read, write, scaffold into, or use a user's live Thortiq vault as a
  fixture.
- Import only public `@thortiq/plugin-*` packages and project-local modules.
  Never import `@thortiq/data`, `/shared/*`, `shell/*`, filesystem handles, or
  application internals.
- Use synthetic fixtures and mocked network responses.
- Run the template's validate, test, typecheck, build, and package commands
  before asking Thortiq to install or link its prebuilt output.
- Treat native plugins as full-trust code. Prefer an isolated runtime whenever
  the required capabilities fit.
