Skip to content

docs(slang): frontend design law and review skill - #700

Merged
hedgar2017 merged 3 commits into
mainfrom
az-slang-conventions
Sep 15, 2026
Merged

hedgar2017 merged 3 commits into
mainfrom
az-slang-conventions

Conversation

@hedgar2017

@hedgar2017 hedgar2017 commented Sep 10, 2026 •

Copy link
Copy Markdown
Contributor

Records the Slang frontend's design law and adds a read-only review skill that reviews a change against it.

  • CLAUDE.md: the Slang pipeline, its build and test commands, and the frontend's design law as numbered rules.
  • .claude/skills/review/SKILL.md: four lenses, ambiguities as questions, findings as a report, posted on request.
  • README.md: Slang named as the frontend, and the test suites split into what the tester runs and what is planned.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Changes recommended

The documented fixture rule conflicts with the suite, and the skill does not implement its promised ambiguity handling.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Documents Slang frontend conventions and adds a read-only review skill enforcing them.

Changes:

  • Expands Slang build, test, and LIT guidance.
  • Defines frontend design laws and PR conventions.
  • Adds and tracks the review skill.
File summaries
File Description
CLAUDE.md Adds Slang workflows and design rules.
.gitignore Allows Claude skills to be tracked.
.claude/skills/review/SKILL.md Defines the read-only review process.
Review details
  • Files reviewed: 2/3 changed files
  • Comments generated: 3
  • Review effort level: Balanced

💡 Configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread .claude/skills/review/SKILL.md Outdated
Comment thread CLAUDE.md
Comment thread CLAUDE.md Outdated
@hedgar2017
hedgar2017 force-pushed the az-slang-conventions branch 4 times, most recently from 44138ea to 3fa2cf6 Compare September 10, 2026 10:49
@github-actions

github-actions Bot commented Sep 10, 2026 •

Copy link
Copy Markdown

Coverage Summary

Crate Line Coverage Function Coverage
solx 🟢 83.6% 🔴 20.0%
solx-benchmark-converter 🔴 0.0% 🔴 0.0%
solx-codegen-evm 🔴 25.6% 🔴 13.4%
solx-compiler-downloader 🔴 0.0% 🔴 0.0%
solx-core 🔴 38.6% 🔴 46.9%
solx-dev 🔴 2.4% 🔴 3.0%
solx-evm-assembly 🔴 0.0% 🔴 0.0%
solx-mlir 🟡 58.2% 🟡 54.7%
solx-slang 🔴 23.2% 🔴 34.1%
solx-solc-test-adapter 🔴 1.7% 🔴 2.1%
solx-standard-json 🔴 42.8% 🔴 47.7%
solx-tester 🔴 36.2% 🔴 34.0%
solx-utils 🔴 29.0% 🔴 32.5%
solx-yul 🔴 0.0% 🔴 0.0%
Total 🔴 10.9% 🔴 13.1%

Codecov Report | HTML Report | Workflow Run

@hedgar2017
hedgar2017 force-pushed the az-slang-conventions branch 6 times, most recently from 4834342 to 015271e Compare September 10, 2026 13:35
@hedgar2017 hedgar2017 self-assigned this Sep 10, 2026
@hedgar2017
hedgar2017 force-pushed the az-slang-conventions branch 2 times, most recently from f701ce4 to b6c4c55 Compare September 10, 2026 13:48
Records the Slang frontend's design law in CLAUDE.md and adds a read-only review skill that reviews a change against it. The skill puts every ambiguity to the user as a question and applies nothing itself.
Comment thread .claude/skills/review/SKILL.md Outdated
Comment thread .claude/skills/review/SKILL.md Outdated
Comment thread .claude/skills/review/SKILL.md Outdated
Comment thread .claude/skills/review/SKILL.md Outdated
Comment thread .claude/skills/review/SKILL.md Outdated
Comment thread CLAUDE.md
Comment thread CLAUDE.md
Comment thread CLAUDE.md Outdated
Comment thread CLAUDE.md
Comment thread CLAUDE.md Outdated
Comment thread CLAUDE.md
Comment thread README.md
Comment thread README.md Outdated
Comment thread README.md

@nebasuke nebasuke left a comment •

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tried the skill on #702. It was a bit expensive with >500K tokens due to all the lenses, but did match up with what I did myself in #703.

I used the test review to let Claude iterate on the skill.md/claude.md and kept what I thought was possibly relevant.

Adds a posting step to the review skill: one comment per finding on the line it is about, anchored inside a diff hunk, and a review body for the findings that have no line. The report goes up only when the user asks, and the verdict stays with the user.
Answers the review of #700. The frontend's design law now sits directly under
Architecture, with the build, test and pull request mechanics below it, and the
CI labels and the Renovate validator check are back as prose. The review skill
cites the rule each finding rests on, prompts with a fixed set of options under
any harness, and splits posting into inline comments and the review comment. The
README names the suites the tester runs and the ones that are planned, and the
missing_docs_in_private_items lint is dropped.

@ChristopherDedominici ChristopherDedominici left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I reviewed only the skill since it's the only file where I have context. Looks good to me.

One point we might want to talk about is making this skill generic for all the Nomic teams. The skill itself is already generic. The "problem" we'll need to fix is having every team define all the rules needed for reviewing files in CLAUDE.md (or providing into it links to references with this info).

@hedgar2017
hedgar2017 added this pull request to the merge queue Sep 15, 2026
Merged via the queue into main with commit 938876a Sep 15, 2026
44 checks passed
@hedgar2017
hedgar2017 deleted the az-slang-conventions branch September 15, 2026 15:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants