diff options
| author | Shoubhit Dash <[email protected]> | 2026-04-01 21:37:25 +0530 |
|---|---|---|
| committer | GitHub <[email protected]> | 2026-04-01 21:37:25 +0530 |
| commit | 897d83c589528bf56c529179a47ebade89b0a3cc (patch) | |
| tree | eed74dde830da30ac74563ce668bde7468fb1630 /packages/web/src/content | |
| parent | 0a125e5d4d76f2ea8b015d7bd716b54f30f01d90 (diff) | |
| download | opencode-897d83c589528bf56c529179a47ebade89b0a3cc.tar.gz opencode-897d83c589528bf56c529179a47ebade89b0a3cc.zip | |
refactor(init): tighten AGENTS guidance (#20422)
Diffstat (limited to 'packages/web/src/content')
| -rw-r--r-- | packages/web/src/content/docs/rules.mdx | 12 | ||||
| -rw-r--r-- | packages/web/src/content/docs/tui.mdx | 2 |
2 files changed, 11 insertions, 3 deletions
diff --git a/packages/web/src/content/docs/rules.mdx b/packages/web/src/content/docs/rules.mdx index 26e6de906..6db5d45b1 100644 --- a/packages/web/src/content/docs/rules.mdx +++ b/packages/web/src/content/docs/rules.mdx @@ -15,9 +15,17 @@ To create a new `AGENTS.md` file, you can run the `/init` command in opencode. You should commit your project's `AGENTS.md` file to Git. ::: -This will scan your project and all its contents to understand what the project is about and generate an `AGENTS.md` file with it. This helps opencode to navigate the project better. +`/init` scans the important files in your repo, may ask a couple of targeted questions when the codebase cannot answer them, and then creates or updates `AGENTS.md` with concise project-specific guidance. -If you have an existing `AGENTS.md` file, this will try to add to it. +It focuses on the things future agent sessions are most likely to need: + +- build, lint, and test commands +- command order and focused verification steps when they matter +- architecture and repo structure that are not obvious from filenames alone +- project-specific conventions, setup quirks, and operational gotchas +- references to existing instruction sources like Cursor or Copilot rules + +If you already have an `AGENTS.md`, `/init` will improve it in place instead of blindly replacing it. --- diff --git a/packages/web/src/content/docs/tui.mdx b/packages/web/src/content/docs/tui.mdx index 010e8328f..6dfa7b312 100644 --- a/packages/web/src/content/docs/tui.mdx +++ b/packages/web/src/content/docs/tui.mdx @@ -153,7 +153,7 @@ Show the help dialog. ### init -Create or update `AGENTS.md` file. [Learn more](/docs/rules). +Guided setup for creating or updating `AGENTS.md`. [Learn more](/docs/rules). ```bash frame="none" /init |