Skip to content

fix: verify the site formatter and build the ui first - #131

Merged
retr0h merged 1 commit into
mainfrom
fix/skill-verify-docs-formatter
Sep 17, 2026
Merged

retr0h merged 1 commit into
mainfrom
fix/skill-verify-docs-formatter

Conversation

@retr0h

@retr0h retr0h commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

Two things the skill's verify gate was missing, both learned by getting them wrong this week.

The site formatter is not in just ready or just test. md-fmt excludes docs/ because Prettier owns that tree via just docusaurus-fmt. Three merged security fixes each edited a feature page, a CLI page or the configuration reference, passed both gates locally, and left main's Docusaurus Lint red from a48daffe8 until osapi-io/osapi#512. Step 5 now runs just docusaurus-fmt-check, and says why.

just ready lints before it builds the UI. In a fresh worktree ui/dist/ is empty, so golangci-lint cannot import the //go:embed package and reports typecheck on cmd/controller_setup.go — a file the change never touched. That cost two gate runs to recognise, twice. Step 5 now starts with just react-build.

Both are the skill's own correction rule applied to itself: fix the guidance in its own change, before continuing the work that found it.

🤖 Generated with Claude Code

https://claude.ai/code/session_01FuKUsHFG1EqZXamffh9M2c

Three merged security fixes each edited pages under docs/ and left five
of them unformatted, so Docusaurus Lint failed on main until
osapi-io/osapi#512. The skill's verify gate listed just ready and just
test, and neither covers the site: md-fmt excludes docs/ because
Prettier owns that tree.

Also records the fresh-worktree ordering. just ready lints before it
builds the UI, so in a new worktree the linter cannot import the embed
package and reports a typecheck error on a file nobody touched, which
cost two gate runs to recognise.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FuKUsHFG1EqZXamffh9M2c
@github-actions

Copy link
Copy Markdown

Thank you for contributing to this project! 😊🕹️

@retr0h
retr0h merged commit e60b714 into main Sep 17, 2026
6 checks passed
@retr0h
retr0h deleted the fix/skill-verify-docs-formatter branch September 17, 2026 21:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant