feat: install agent skills into scaffolded projects and canonicalize AGENTS.md - #1015
Open
YusukeHirao wants to merge 7 commits into
Open
feat: install agent skills into scaffolded projects and canonicalize AGENTS.md#1015YusukeHirao wants to merge 7 commits into
YusukeHirao wants to merge 7 commits into
Conversation
…cal agent instructions - Move common agent rules from CLAUDE.md to AGENTS.md so Cursor also loads them; CLAUDE.md becomes a thin @AGENTS.md wrapper - Mandate reading the dzero-tech-selection skill before implementation - Add skills:sync script that installs dzero-* skills from d-zero-dev/frontend-guidelines (main branch) into .claude/skills/ via the pinned skills CLI - Ignore skills-lock.json and .claude/skills/ in prettier to avoid drift with upstream - Register the dzero word in cspell
Run the pinned skills CLI after dependency installation to copy the dzero-* skills into .claude/skills/. Skipped with --no-install, and generation continues with a hint to run yarn skills:sync if the fetch fails.
Pinning the version inside the skills:sync script kept it out of renovate's reach. Install skills as a pinned devDependency instead and let npx resolve the local binary, so version updates flow through the normal dependency update process.
Delegate to the generated project's skills:sync script so the skill source URL and CLI version live only in the scaffold package.json.
YusukeHirao
requested review from
arktds,
dz-furukawa,
teppei-d and
yusasa16
as code owners
August 12, 2026 14:22
… checks State in AGENTS.md that browser checks (rendering, behavior, interactions) must use the chrome-devtools MCP already configured in .mcp.json. Pairs with the guidelines skills requiring browser verification at implementation and review time. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
yusasa16
approved these changes
Aug 17, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
概要
scaffold で生成する案件プロジェクトに、frontend-guidelines の Agent Skills（
dzero-*）を導入します。生成時に自動でスキルを展開し、以後はyarn skills:syncで更新に追従できるようにします。あわせて、Cursor が CLAUDE.md を読まない問題に対処するため常時ロードの指示ファイルを AGENTS.md に正本化します。変更内容
@d-zero/scaffold@AGENTS.mdを読み込む薄いラッパーにdzero-tech-selectionスキルを必読し実装レイヤーを決定する」ルールを追加skills:syncスクリプトを追加: バージョン固定の skills CLI で frontend-guidelines（mainブランチ）のskills/を.claude/skills/に copy 展開する。更新も同スクリプトの再実行（差分は PR でレビュー）.prettierignoreを追加: skills CLI が管理するskills-lock.jsonと.claude/skills/を prettier の書き換えから除外（配布元とのハッシュ照合が壊れるのを防ぐ）dzeroを登録@d-zero/create-frontendInstall agent skillsアクションを追加。スキル取得元とバージョンは plopfile の定数（scaffold のskills:syncと同期）--no-install時はスキップ。ネットワーク失敗時も生成は継続し、後からyarn skills:syncで導入可能リポジトリルート
.gitignoreのAGENTS.md（エージェントランタイム用の全階層 ignore）に対し、scaffold テンプレートの AGENTS.md だけ追跡できるよう否定パターンを追加依存関係
mainに反映されてから配布されます。それまでは生成時のスキル導入が「取得失敗 → スキップ（警告表示）」となるため、リリースは frontend-guidelines の main 反映後が望ましいです動作確認
yarn lint/yarn build/yarn test（357 件）通過.claude/skills/への copy 展開・skills-lock.json生成・再実行での上書き更新を確認済み🤖 Generated with Claude Code