Skip to content

ci: add contributor guidelines, agent skills and commit message checks - #37

Draft
erkamyaman wants to merge 2 commits into
santoshyadavdev:mainfrom
erkamyaman:ci/contributor-guidelines
Draft

erkamyaman wants to merge 2 commits into
santoshyadavdev:mainfrom
erkamyaman:ci/contributor-guidelines

Conversation

@erkamyaman

Copy link
Copy Markdown
Contributor

Stacked on #36; the diff shrinks to the files below once #36 is merged.

What and why

Contributors and AI agents had no shared rules for commits, code or UI. This adds them, and the checks that keep them.

  • Guides in docs/contributing/: commit message format with this repo's scopes, coding standards (including how inspectors read the running app), UI guidelines (theme tokens, one-line brand change, page anatomy, accessibility), and fixup commits.
  • Agent skills in .claude/skills/: devtools-ui, devtools-inspector, devtools-verify, devtools-commit.
  • Agent roles in .claude/agents/: ui-engineer, inspector-engineer, a11y-reviewer, devtools-reviewer.
  • Git hooks in .githooks/, turned on by pnpm install: pre-commit formats staged files, commit-msg warns when a message doesn't follow the format. .gitmessage is set as the commit template.
  • CI: a Commit message workflow checks the PR title and every commit; ci.yml runs pnpm skills:check.
  • Scripts: pnpm commit:check (commits on your branch) and pnpm skills:check (skills and roles frontmatter, links and paths).
  • Templates: pull request template with a verification checklist, bug and feature issue forms.
  • Docs: CONTRIBUTING rewritten, README, AGENTS.md and CLAUDE.md point to the guides, skills and roles. .gitattributes marks extension/ui and the lockfile as generated.

How it was verified

  • pnpm format:check, pnpm skills:check (8 skills and roles), pnpm commit:check on this branch's commit
  • The commit message script against valid and invalid headers, bodies, scopes, merges and fixups
  • The commit-msg hook warns without blocking

Notes for reviewers

  • The format needs a body of at least 20 characters on every commit except docs. Older commits in open pull requests will fail the new check until they are reworded or squashed.
  • Making Commit message a required check needs a branch protection change.

@coderabbitai

coderabbitai Bot commented Sep 28, 2026

Copy link
Copy Markdown
Contributor

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

Comment @coderabbitai help to get the list of available commands.

@erkamyaman
erkamyaman force-pushed the ci/contributor-guidelines branch 3 times, most recently from 42e0235 to fb40407 Compare September 28, 2026 16:14
…efreshed UI

The devtools ran as a single panel with data mostly from source scans,
and every inspector looked a little different. Move them into
@devframes/hub with a dock per tool (Angular, NgRx, Analog, plus
NativeScript and Capacitor as coming soon), give every inspector live
data from the running app, and restyle the whole panel around one
theme.

- Hub: one shared frame follows the rail, the amber launcher opens the
  whole hub, WebSocket transport, and hub connections stay local
- Components: live tree, one row per instance, with inputs, outputs,
  listeners and injected services
- Injectors: real injectors only, the environment chain, the lookup
  path, and which injector supplied each dependency
- Signals: component picker, linkedSignal values, history kept across
  components
- NgRx: @ngrx/signals and classic stores found through the environment
  injectors, with a change log, diffs and restore
- Forms, Router, SSR & HTTP, Analog, Pipes, Dashboard: stable ids,
  per-tab data with expiry, correct counts, fewer false findings,
  lighter pushes
- UI: SCSS theme with a one-line accent change, shared mixins, a custom
  accessible dropdown, consistent toolbars and states; axe clean in
  dark and light
- Demo: rebuilt as Angular Travel with destinations, a signal store,
  resolvers and guards, a Signal Forms booking flow and a restyled
  DevTools Lab
Contributors and AI agents had no shared rules for commits, code or UI,
so every change drifted a little from the last one. Add guides for the
commit format, coding standards, UI and fixup commits, skills and roles
that carry the same rules for agents, git hooks that format staged files
and check commit messages, a CI workflow that validates the pull request
title and every commit, a skills check, and pull request and issue
templates.
@erkamyaman
erkamyaman force-pushed the ci/contributor-guidelines branch from fb40407 to cfc37e9 Compare September 28, 2026 16:19
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.

1 participant