fix(ci): green markdownlint and link-check

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.
This commit is contained in:
Wesam Abousaid
2026-05-18 20:26:07 +02:00
parent 8937f9da4b
commit 4d5ed82511
8 changed files with 14 additions and 5 deletions
+5 -2
View File
@@ -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]
}
+2 -1
View File
@@ -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,
+1
View File
@@ -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
+1
View File
@@ -28,6 +28,7 @@ gh release create v<version> --title "<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?"
+1
View File
@@ -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.
+1
View File
@@ -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.
+1
View File
@@ -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)
@@ -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