playbooks

home / skills / chachamaru127 / claude-code-harness / principles

principles skill

/skills/principles

This skill helps you apply development principles and guidelines, read context, and use diff-aware editing to guide high-quality work.

npx playbooks add skill chachamaru127/claude-code-harness --skill principles

Review the files below or copy the command above to add this skill to your agents.

Files (5)
SKILL.md
1.5 KB
---
name: principles
description: "開発原則、ガイドライン、VibeCoder向けガイダンスを提供。Use when user mentions principles, guidelines, safety, or diff-aware editing. Do not use for actual implementation—use the impl skill instead."
description-en: "Provides development principles, guidelines, and VibeCoder guidance. Use when user mentions principles, guidelines, safety, or diff-aware editing. Do not use for actual implementation—use the impl skill instead."
description-ja: "開発原則、ガイドライン、VibeCoder向けガイダンスを提供。Use when user mentions principles, guidelines, safety, or diff-aware editing. Do not use for actual implementation—use the impl skill instead."
allowed-tools: ["Read"]
user-invocable: false
---

# Principles Skills

開発原則とガイドラインを提供するスキル群です。

## 機能詳細

| 機能 | 詳細 |
|------|------|
| **基本原則** | See [references/general-principles.md](references/general-principles.md) |
| **差分編集** | See [references/diff-aware-editing.md](references/diff-aware-editing.md) |
| **コンテキスト読み取り** | See [references/repo-context-reading.md](references/repo-context-reading.md) |
| **VibeCoder** | See [references/vibecoder-guide.md](references/vibecoder-guide.md) |

## 実行手順

1. ユーザーのリクエストを分類
2. 上記の「機能詳細」から適切な参照ファイルを読む
3. その内容を参照・適用

Overview

This skill provides development principles, high-level guidelines, and VibeCoder-style guidance for planning and reviewing changes. It focuses on design intent, safety constraints, and diff-aware editing practices rather than producing executable code. Do not use this skill to implement changes—use the implementation skill for actual code edits.

How this skill works

When you ask about principles or guidelines, the skill classifies the request and reads relevant internal references for general principles, diff-aware editing, repository context reading, and VibeCoder guidance. It synthesizes clear, actionable recommendations, checklists, and review criteria tailored to your request. For concrete code changes or patches, it will point you to use the implementation skill instead.

When to use it

  • When you mention principles, best practices, or design guidelines
  • When you need diff-aware editing guidance or change-scope advice
  • When you want VibeCoder-style behavioral guidance or persona tuning
  • When you need safety, security, or risk-mitigation constraints for a change
  • When preparing a review checklist or design rationale summary

Best practices

  • Keep recommendations high-level and rationale-driven; avoid providing implementation-level diffs here
  • Focus on observable behavior, compatibility, and minimal blast radius for changes
  • Use diff-aware advice: prefer small, reversible commits and clear intent-bearing messages
  • Explicitly call out safety and rollback criteria when proposing risky changes
  • If you need exact code edits, request the implementation skill and link to the diff or files

Example use cases

  • Request a checklist for safe API changes across services
  • Ask for diff-aware strategies to refactor a module with minimal runtime impact
  • Get VibeCoder guidance for setting an agent’s editing persona and decision rules
  • Ask for safety constraints and testing requirements before a large refactor
  • Request a concise design rationale to include with a pull request

FAQ

How is this different from the implementation skill?

This skill provides high-level principles, guidelines, and review criteria. It does not produce code edits or patches. For actual implementation or applying diffs, use the implementation skill.

Will this skill examine my repository files?

Yes — it reads internal reference materials and repo context to tailor guidance, but it will not perform file edits. Provide links or context when you want more targeted recommendations.