Skip to content

[VIBES-1] PLU-758: add agent skills + tighten claude.md rules#1664

Merged
graphite-app[bot] merged 1 commit into
develop-v2from
chore/claude/skills
Jun 5, 2026
Merged

[VIBES-1] PLU-758: add agent skills + tighten claude.md rules#1664
graphite-app[bot] merged 1 commit into
develop-v2from
chore/claude/skills

Conversation

@ogp-weeloong
Copy link
Copy Markdown
Contributor

@ogp-weeloong ogp-weeloong commented May 29, 2026

Summary

Install agent skills + tighten repo-wide rules for a better "vibe coding" experience. No runtime code changes.

Changes

Skills installed (via skills.sh, tracked in skills-lock.json):

  • Root: caveman, graphite
  • Frontend: vercel-react-best-practices, vercel-composition-patterns

Tooling

  • New lint:fix script (eslint --fix && tsc --noEmit) in both workspaces + root fan-out
  • This is to allow the agent to apply our lints after authoring files.

.claude/CLAUDE.md — new conventions:

  • npm-only; install with -E.
  • Run lint:fix then lint before committing; scope to the workspace touched.
  • Branches / PRs via Graphite + the graphite skill; ask before naming a branch (feat/... or chore/...).
  • Skills section: upstream (in skills-lock.json) is read-only; overrides go in CLAUDE.md. Plumber-specific skills scaffold via skills init.

.claude/rules/backend.md: add unit tests for new code; prefer REST over new root GraphQL fields.

Review notes

~12k LoC of the diff is vendored skill content — focus on CLAUDE.md, rules/backend.md, the package.json changes, and the skills-lock.json files. Engineers need skills.sh installed globally.

Copy link
Copy Markdown
Contributor Author

ogp-weeloong commented May 29, 2026


How to use the Graphite Merge Queue

Add the label lfg to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

@ogp-weeloong ogp-weeloong changed the title chore: add agent skills + tighten claude.md rules [VIBES-1] PLU-758: add agent skills + tighten claude.md rules May 29, 2026
@linear
Copy link
Copy Markdown

linear Bot commented May 29, 2026

PLU-758

@ogp-weeloong ogp-weeloong marked this pull request as ready for review May 29, 2026 08:16
@ogp-weeloong ogp-weeloong requested a review from a team as a code owner May 29, 2026 08:16
Copy link
Copy Markdown
Contributor

@pregnantboy pregnantboy left a comment

Choose a reason for hiding this comment

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

lets get this merged in asap
but some comments first:

  • there's quite a lot of framework-specific files (react 19, next, nest, trpc, etc.), will claude get confused by this if we dont?
  • what's skills-lock.json for?

Copy link
Copy Markdown
Contributor Author

removed backend skills (which also removes these framework-specific references etc) for now, let's look at backend skills later

@ogp-weeloong ogp-weeloong force-pushed the chore/claude/skills branch 2 times, most recently from cf117f7 to 48961c3 Compare June 5, 2026 05:06
Copy link
Copy Markdown
Contributor

@kevinkim-ogp kevinkim-ogp left a comment

Choose a reason for hiding this comment

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

sick 🚀

@graphite-app
Copy link
Copy Markdown

graphite-app Bot commented Jun 5, 2026

Merge activity

## Summary

Install agent skills + tighten repo-wide rules for a better "vibe coding" experience. No runtime code changes.

## Changes

**Skills installed** (via [`skills.sh`](https://skills.sh), tracked in `skills-lock.json`):

- Root: `caveman`, `graphite`
- Frontend: `vercel-react-best-practices`, `vercel-composition-patterns`

**Tooling**

- New `lint:fix` script (`eslint --fix && tsc --noEmit`) in both workspaces + root fan-out
- This is to allow the agent to apply our lints after authoring files.

**`.claude/CLAUDE.md`** — new conventions:

- npm-only; install with `-E`.
- Run `lint:fix` then `lint` before committing; scope to the workspace touched.
- Branches / PRs via Graphite + the `graphite` skill; ask before naming a branch (`feat/...` or `chore/...`).
- Skills section: upstream (in `skills-lock.json`) is read-only; overrides go in `CLAUDE.md`. Plumber-specific skills scaffold via `skills init`.

**`.claude/rules/backend.md`**: add unit tests for new code; prefer REST over new root GraphQL fields.

## Review notes

~12k LoC of the diff is vendored skill content — focus on `CLAUDE.md`, `rules/backend.md`, the `package.json` changes, and the `skills-lock.json` files. Engineers need `skills.sh` installed globally.
@graphite-app graphite-app Bot force-pushed the chore/claude/skills branch from 48961c3 to 793fe29 Compare June 5, 2026 07:30
@graphite-app graphite-app Bot merged commit 793fe29 into develop-v2 Jun 5, 2026
7 checks passed
@graphite-app graphite-app Bot deleted the chore/claude/skills branch June 5, 2026 07:32
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.

3 participants