Instruction file imported from randy-girard/flynn-plugin-template (
.cursor/rules/docs-sync.mdc). Copyright stays with the author.
Docs stay current
Follow AGENTS.md.
Do not ship behavior without updating the docs in the same change. When the plugin's behavior, flynn-plugin.json (kind, provider, cli actions, setup prompts, env / inject_env / generate_env, routes, hooks, webhooks, wait, ports, TLS), injected connection env vars, install/update/uninstall flow, or release flow changes:
- Update
README.md(install, usage, commands table, env vars, ports, layout, release steps) andAGENTS.mdwhen the change is agent-facing (tests, contract, layout). - Write
flynn/flynn-hostcommands in the canonicalnoun:verbform (flynn-host plugin:install,flynn redis:cli,flynn kafka:topics:create); mention the space form only as an alias. - The Flynn repo documents this plugin too:
docs/content/plugins.mdand, for resource providers,docs/content/databases/<engine>.mdinrandy-girard/flynnmay need a matching change. Make it when a sibling../flynncheckout exists; otherwise note it in the commit body or PR. - Use GitHub-relative markdown links. Do not leave docs describing removed or replaced behavior (old versions, plaintext defaults,
develop, DCO sign-off).
Skip docs only when the change has no user- or operator-visible effect; say so in the commit body.
