Agent skill

Development Guidelines

by GenerativeAgents in GenerativeAgents/claude-code-book-chapter8

チーム全体で統一された開発プロセスとコーディング規約を確立するための包括的なガイドとテンプレート。開発ガイドライン作成時、コード実装時に使用する。

MITAuto-check passedProduct & Project Management

Install Development Guidelines

skills CLI
$ npx skills add GenerativeAgents/claude-code-book-chapter8 --skill development-guidelines -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install GenerativeAgents/claude-code-book-chapter8 development-guidelines --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/GenerativeAgents/claude-code-book-chapter8.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/development-guidelines .claude/skills/development-guidelines && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
development-guidelines
GitHub stars
119
Token cost
~521 tokens
SKILL.md length
112 words
Files
4
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

チーム全体で統一された開発プロセスとコーディング規約を確立するための包括的なガイドとテンプレート。開発ガイドライン作成時、コード実装時に使用する。

  • Works in 2 steps: 実装時のコーディング規約 (implementation-guide.md) → 開発プロセスの標準化 (process-guide.md)
  • Product & Project Management work in your project
  • SKILL.md covers 前提条件, 既存ドキュメントの優先順位, 出力先 and クイックリファレンス, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Development Guidelines is an agent skill from GenerativeAgents/claude-code-book-chapter8. チーム全体で統一された開発プロセスとコーディング規約を確立するための包括的なガイドとテンプレート。開発ガイドライン作成時、コード実装時に使用する。

Its SKILL.md is about 520 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `guides/implementation.md`, `guides/process.md` and `template.md`).

It sits in Product & Project Management. It works with Git. The licence is MIT.

When your agent uses it

  • Product & Project Management work in your project

Example prompts

  • “/development-guidelines”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. 実装時のコーディング規約 (implementation-guide.md)
  2. 開発プロセスの標準化 (process-guide.md)

What it can do on your machine

Read from SKILL.md and the folder at commit 27c4191. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Development Guidelines loads about 521 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 112 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~521

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from GenerativeAgents/claude-code-book-chapter8 at commit 27c4191, republished under its MIT licence (© GenerativeAgents). 112 words, ~521 tokens.

Download SKILL.mdSave it as .claude/skills/development-guidelines/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
development-guidelines
description
チーム全体で統一された開発プロセスとコーディング規約を確立するための包括的なガイドとテンプレート。開発ガイドライン作成時、コード実装時に使用する。
allowed-tools
Read, Write, Edit

開発ガイドラインスキル

チーム開発に必要な2つの要素をカバーします:

  1. 実装時のコーディング規約 (implementation-guide.md)
  2. 開発プロセスの標準化 (process-guide.md)

前提条件

開発ガイドライン作成を開始する前に、以下を確認してください:

推奨ドキュメント
  1. docs/architecture.md (アーキテクチャ設計書) - 技術スタックの確認
  2. docs/repository-structure.md (リポジトリ構造) - ディレクトリ構造の確認

開発ガイドラインは、プロジェクトの技術スタックとディレクトリ構造に 基づいた具体的なコーディング規約と開発プロセスを定義します。

既存ドキュメントの優先順位

重要: docs/development-guidelines.md に既存の開発ガイドラインがある場合、 以下の優先順位に従ってください:

  1. 既存の開発ガイドライン (docs/development-guidelines.md) - 最優先

    • プロジェクト固有の規約とプロセスが記載されている
    • このスキルのガイドより優先する
  2. このスキルのガイド - 参考資料

    • ./guides/implementation.md: 汎用的なコーディング規約
    • ./guides/process.md: 汎用的な開発プロセス
    • 既存ガイドラインがない場合、または補足として使用

新規作成時: このスキルのガイドとテンプレートを参照 更新時: 既存ガイドラインの構造と内容を維持しながら更新

出力先

作成した開発ガイドラインは以下に保存してください:

docs/development-guidelines.md

クイックリファレンス

コード実装時

コード実装時のルールと規約: ./guides/implementation.md

含まれる内容:

  • TypeScript/JavaScript規約
  • 型定義・命名規則
  • 関数設計とエラーハンドリング
  • コメント規約
  • セキュリティとパフォーマンス
  • テストコード実装
  • リファクタリング手法
開発プロセスの参照/策定時

Git運用、テスト戦略、コードレビュー: ./guides/process.md

含まれる内容:

  • 基本原則(具体例の重要性、理由説明)
  • Git運用ルール(Git Flow ブランチ戦略)
  • コミットメッセージとPRプロセス
  • テスト戦略(ピラミッドとカバレッジ)
  • コードレビューのプロセス
  • 品質自動化
テンプレート

開発ガイドライン作成時: ./template.md

使用シーン別ガイド

新規開発時
  1. ./guides/implementation.md で命名規則・コーディング規約を確認
  2. ./guides/process.md でブランチ戦略・PR処理を確認
  3. テストを先に書く(TDD)
コードレビュー時
  • ./guides/process.md の「コードレビュープロセス」を参照
  • ./guides/implementation.md で規約違反がないか確認
テスト設計時
  • ./guides/process.md の「テスト戦略」(ピラミッド、カバレッジ)
  • ./guides/implementation.md の「テストコード」(実装パターン)
リリース準備時
  • ./guides/process.md の「Git運用ルール」(main へのマージ方針)
  • コミットメッセージが Conventional Commits に従っているか確認

チェックリスト

  • コーディング規約が具体例付きで定義されている
  • 命名規則が明確である(言語別・プロジェクト固有)
  • エラーハンドリングの方針が定義されている
  • ブランチ戦略が決まっている(Git Flow推奨)
  • コミットメッセージ規約が明確である
  • PRテンプレートが用意されている
  • テストの種類とカバレッジ目標が設定されている
  • コードレビュープロセスが定義されている
  • CI/CDパイプラインが構築されている

© GenerativeAgents, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in .claude/skills/development-guidelines of GenerativeAgents/claude-code-book-chapter8.

  • SKILL.md
  • guides/implementation.md
  • guides/process.md
  • template.md

Open the folder on GitHubat commit 27c4191

Compare with similar skills

Development Guidelines next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Development Guidelines compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Development Guidelines this skillGenerativeAgents/claude-code-book-chapter8119—~521Automated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Weekly Engineering Retrogarrytan/gstack136k—~2.4kAutomated safety check: PassMIT
Reviewfossasia/eventyay-interpretation1.6k34 repos~996Automated safety check: PassApache-2.0
Graphsmallnest/goal-workflow288—~3.9kAutomated safety check: PassMIT
Dough Story Wrap Upterryyin/lizard2.5k—~4.3kAutomated safety check: PassCustom licence

Similar skills

  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Builds a weekly engineering retrospective from git history: commit counts, per-person contributions, work patterns and code quality numbers over a chosen window.

    136k GitHub stars~2.4k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Review

    fossasia/eventyay-interpretation

    Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match…

    1.6k GitHub starsUsed in 34 repos~996 tokens
    Product & Project ManagementAuto-check passed
  • Graph

    smallnest/goal-workflow

    Graph engineering for parallel task execution: convert a task, PRD, SPEC, or issue set into a dependency graph (DAG), layer it into supersteps, then implement each independent node concurrently with…

    288 GitHub stars~3.9k tokensUpdated 24 days ago
    Product & Project ManagementAuto-check passed
  • Dough Story Wrap Up

    terryyin/lizard

    Closes one completed feature story, bounded retrospective correction, or context-only planless execution using available execution context.

    2.5k GitHub stars~4.3k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Start Task

    devoxx/DevoxxGenieIDEAPlugin

    Create a feature branch for a backlog task, switch to it, and start implementation.

    684 GitHub stars~792 tokensUpdated 8 days ago
    Product & Project ManagementAuto-check passed

More from GenerativeAgents/claude-code-book-chapter8

  • Prd Writing

    GenerativeAgents/claude-code-book-chapter8

    プロダクト要求定義書(PRD)を作成するための詳細ガイドとテンプレート。PRD作成時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

    119 GitHub stars~1.3k tokensUpdated 7 mo ago
    Auto-check passed
  • Steering

    GenerativeAgents/claude-code-book-chapter8

    作業指示毎の作業計画、タスクリストをドキュメントに記録するためのスキル。ユーザーからの指示をトリガーとした作業計画時、実装時、検証時に読み込む。

    119 GitHub stars~1.7k tokensUpdated 7 mo ago
    Auto-check passed
  • Architecture Design

    GenerativeAgents/claude-code-book-chapter8

    アーキテクチャ設計書を作成するための詳細ガイドとテンプレート。アーキテクチャ設計時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

    119 GitHub stars~217 tokensUpdated 7 mo ago
    Auto-check passed
  • Functional Design

    GenerativeAgents/claude-code-book-chapter8

    機能設計書を作成するための詳細ガイドとテンプレート。機能設計書作成時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

    119 GitHub stars~214 tokensUpdated 7 mo ago
    Auto-check passed
  • Repository Structure

    GenerativeAgents/claude-code-book-chapter8

    リポジトリ構造定義書を作成するための詳細ガイドとテンプレート。リポジトリ構造定義時にのみ使用. An agent skill from GenerativeAgents/claude-code-book-chapter8.

    119 GitHub stars~237 tokensUpdated 7 mo ago
    Auto-check passed
  • Glossary Creation

    GenerativeAgents/claude-code-book-chapter8

    用語集を作成するための詳細ガイドとテンプレート。用語集作成時にのみ使用。

    119 GitHub stars~241 tokensUpdated 7 mo ago
    Auto-check passed

Works with

Questions about Development Guidelines

What does Development Guidelines do?

チーム全体で統一された開発プロセスとコーディング規約を確立するための包括的なガイドとテンプレート。開発ガイドライン作成時、コード実装時に使用する。. Development Guidelines is an agent skill from GenerativeAgents/claude-code-book-chapter8.

When should I use Development Guidelines?

Development Guidelines fits situations like: product & Project Management work in your project.

How do I install Development Guidelines in Claude Code?

Run `npx skills add GenerativeAgents/claude-code-book-chapter8 --skill development-guidelines -a claude-code`. Or copy the skill folder (.claude/skills/development-guidelines in GenerativeAgents/claude-code-book-chapter8) into .claude/skills/development-guidelines in your project. Claude Code loads it when a task matches its description.

How do I install Development Guidelines in Codex?

Run `npx skills add GenerativeAgents/claude-code-book-chapter8 --skill development-guidelines -a codex`. Or copy the skill folder (.claude/skills/development-guidelines in GenerativeAgents/claude-code-book-chapter8) into .agents/skills/development-guidelines in your project. Codex loads it when a task matches its description.

Can I use Development Guidelines in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add GenerativeAgents/claude-code-book-chapter8 --skill development-guidelines -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/development-guidelines, .gemini/skills/development-guidelines, .github/skills/development-guidelines and .opencode/skills/development-guidelines in your project.

What does Development Guidelines need to run?

SKILL.md names no scripts, command-line tools or credentials: Development Guidelines is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit.

Does Development Guidelines access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Development Guidelines safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Development Guidelines use?

Development Guidelines is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Development Guidelines use?

About 521 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Development Guidelines?

Skills that share tags, products or a category with Development Guidelines: CCPM Project Management (automazeio/ccpm, 8.4k stars), Weekly Engineering Retro (garrytan/gstack, 136k stars), Review (fossasia/eventyay-interpretation, 1.6k stars) and Graph (smallnest/goal-workflow, 288 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Development Guidelines?

GenerativeAgents (a GitHub organization) maintains it in GenerativeAgents/claude-code-book-chapter8, which has 119 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on February 28, 2026.

Source: GenerativeAgents/claude-code-book-chapter8 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.