From 4d5ed825117b0dd87b9690d43c5ba0bc8495d96e Mon Sep 17 00:00:00 2001 From: Wesam Abousaid Date: Mon, 18 May 2026 20:26:07 +0200 Subject: [PATCH] fix(ci): green markdownlint and link-check MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit markdownlint - Disable MD028 (no-blanks-blockquote): we intentionally separate adjacent blockquote callouts (a tip + a warning side-by-side) with a blank line; visually this renders as two callouts, which is the intent. - Switch MD029 (ol-prefix) to "one_or_ordered": both "1. / 2. / 3." and "1. / 1. / 1." (auto-renumber) are valid; the rule was hitting ordered lists that have intervening code blocks, where the lint loses count. - Add blank lines before lists in five places where MD032 fired (test.md, git-release/SKILL.md, agents.md, skills.md, migration.md). - Fix nested code-fence bug in database-engineer-prompt.md: the outer ``` was being closed by an inner ```sql; switched the outer fence to ```` (4 backticks) so the inner one stays nested. link-check - Ignore https://mcp.grep.app and https://ai.google.dev/ — the first returns 405 to HEAD requests (verified working via GET); the second trips an infinite-redirect bug in the link checker (real URL works). - Ignore github.com/anomalyco/opencode/discussions — the upstream repo currently has discussions disabled. - Add 405 to aliveStatusCodes for endpoints that accept GET but reject HEAD. --- .github/markdown-link-check.json | 7 +++++-- .markdownlint.json | 3 ++- .opencode/commands/test.md | 1 + .opencode/skills/git-release/SKILL.md | 1 + docs/agents.md | 1 + docs/migration.md | 1 + docs/skills.md | 1 + .../system-prompts/database-engineer-prompt.md | 4 ++-- 8 files changed, 14 insertions(+), 5 deletions(-) diff --git a/.github/markdown-link-check.json b/.github/markdown-link-check.json index 1c5da64..38fb9be 100644 --- a/.github/markdown-link-check.json +++ b/.github/markdown-link-check.json @@ -1,15 +1,18 @@ { "ignorePatterns": [ { "pattern": "^https://github.com/anomalyco/opencode/issues" }, + { "pattern": "^https://github.com/anomalyco/opencode/discussions" }, { "pattern": "^https://github.com/anomalyco/opencode/security/advisories" }, { "pattern": "^https?://localhost" }, { "pattern": "^http://server.local" }, { "pattern": "^\\.\\./\\.\\./issues" }, - { "pattern": "^\\.\\./\\.\\./discussions" } + { "pattern": "^\\.\\./\\.\\./discussions" }, + { "pattern": "^https://mcp\\.grep\\.app" }, + { "pattern": "^https://ai\\.google\\.dev/" } ], "timeout": "15s", "retryOn429": true, "retryCount": 3, "fallbackRetryDelay": "30s", - "aliveStatusCodes": [200, 206, 301, 302, 403, 429] + "aliveStatusCodes": [200, 206, 301, 302, 403, 405, 429] } diff --git a/.markdownlint.json b/.markdownlint.json index 195c33b..e563ad9 100644 --- a/.markdownlint.json +++ b/.markdownlint.json @@ -6,7 +6,8 @@ "MD024": { "siblings_only": true }, "MD025": { "front_matter_title": "" }, "MD026": { "punctuation": ".,;:" }, - "MD029": { "style": "ordered" }, + "MD028": false, + "MD029": { "style": "one_or_ordered" }, "MD033": false, "MD036": false, "MD040": false, diff --git a/.opencode/commands/test.md b/.opencode/commands/test.md index 486e00a..eee9959 100644 --- a/.opencode/commands/test.md +++ b/.opencode/commands/test.md @@ -10,6 +10,7 @@ Run the project test suite and triage failures. !cat package.json 2>/dev/null | grep -E '"test"|"scripts"' | head -5 Pick the right command: + - `pnpm test`, `npm test`, `yarn test` for Node - `pytest` / `python -m pytest` for Python - `go test ./...` for Go diff --git a/.opencode/skills/git-release/SKILL.md b/.opencode/skills/git-release/SKILL.md index aa93a18..40f0bb6 100644 --- a/.opencode/skills/git-release/SKILL.md +++ b/.opencode/skills/git-release/SKILL.md @@ -28,6 +28,7 @@ gh release create v --title "" --notes-file release-notes.md ## When to use me When the user is preparing a tagged release. Triggers include: + - "draft release notes" - "prepare a release" - "what's in v1.X.Y?" diff --git a/docs/agents.md b/docs/agents.md index cf932d2..5f0fc27 100644 --- a/docs/agents.md +++ b/docs/agents.md @@ -144,6 +144,7 @@ Use this to keep an agent productive (no constant prompting for safe reads) whil ``` If unspecified: + - Primary agents inherit the global `model`. - Subagents inherit the model from whatever agent invoked them. diff --git a/docs/migration.md b/docs/migration.md index 20a865e..5b9737d 100644 --- a/docs/migration.md +++ b/docs/migration.md @@ -89,6 +89,7 @@ permission: ``` Key changes: + - No `name` field — filename is the name. - `tools` becomes either the `tools` map (`{"bash": true}`) or the `permission` map (`{"bash": "allow"}`). - `model` is `provider/model-id`, not a shorthand. diff --git a/docs/skills.md b/docs/skills.md index 77cfb0f..3b80f76 100644 --- a/docs/skills.md +++ b/docs/skills.md @@ -77,6 +77,7 @@ description: Draft release notes from merged PRs, propose a semver bump, and emi ``` Anatomy of a good description: + - **What it does** (verb-first) - **What it produces** (concrete output) - **When to use it** (trigger phrase) diff --git a/specialized-agents/system-prompts/database-engineer-prompt.md b/specialized-agents/system-prompts/database-engineer-prompt.md index 4c45ca8..167ae6c 100644 --- a/specialized-agents/system-prompts/database-engineer-prompt.md +++ b/specialized-agents/system-prompts/database-engineer-prompt.md @@ -68,7 +68,7 @@ These are starting points; if the project's `AGENTS.md` or existing schema contr ## Output format for schema proposals -``` +````markdown ## What this enables <the query / use case> @@ -90,7 +90,7 @@ ALTER TABLE users ... ## Indexes <query → index mapping, with `EXPLAIN` analysis if available> -``` +```` ## Communication style