{"id":51055976,"url":"https://github.com/kawasima/evolutionary-naming","last_synced_at":"2026-06-22T21:01:58.676Z","repository":{"id":351692953,"uuid":"1211213013","full_name":"kawasima/evolutionary-naming","owner":"kawasima","description":"Claude Code skill for evolutionary naming — improve names step-by-step through 3 phases (audit + improve modes)","archived":false,"fork":false,"pushed_at":"2026-06-02T13:45:12.000Z","size":34,"stargazers_count":57,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-02T15:25:24.227Z","etag":null,"topics":["claude-code","claude-skill","code-quality","naming","refactoring"],"latest_commit_sha":null,"homepage":"https://github.com/kawasima/evolutionary-naming","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kawasima.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-15T07:10:54.000Z","updated_at":"2026-06-02T13:46:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kawasima/evolutionary-naming","commit_stats":null,"previous_names":["kawasima/evolutionary-naming"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kawasima/evolutionary-naming","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kawasima%2Fevolutionary-naming","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kawasima%2Fevolutionary-naming/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kawasima%2Fevolutionary-naming/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kawasima%2Fevolutionary-naming/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kawasima","download_url":"https://codeload.github.com/kawasima/evolutionary-naming/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kawasima%2Fevolutionary-naming/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34665261,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-22T02:00:06.391Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","claude-skill","code-quality","naming","refactoring"],"created_at":"2026-06-22T21:01:57.690Z","updated_at":"2026-06-22T21:01:58.667Z","avatar_url":"https://github.com/kawasima.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# evolutionary-naming\n\n[![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)\n[![GitHub release](https://img.shields.io/github/v/release/kawasima/evolutionary-naming)](https://github.com/kawasima/evolutionary-naming/releases)\n[![Claude Code Skill](https://img.shields.io/badge/Claude%20Code-Skill-blue)](https://code.claude.com/docs/en/skills)\n\nA Claude Code skill for **evolutionary naming** — improving names step-by-step through progressive refinement instead of trying to find the perfect name in one shot.\n\nNaming is a process, not a single step. This skill walks names through 7 progressive steps grouped into 3 phases, with one commit per step, so improvements are safe, incremental, and reversible.\n\nThe skill is **advisory**: it reads code (Read/Grep/Glob) and proposes each rename plus the commit message you'd use — it doesn't edit files or run git. You apply the changes.\n\n## What it does\n\n| Phase | Steps | Nature |\n|-------|-------|--------|\n| Phase 1: Insight to Name | Missing → Nonsense → Honest → Honest and Complete | Universal. Pure naming. Safe. |\n| Phase 2: Name to Structure | Honest and Complete → Does the Right Thing | Structural refactoring. Asks permission. |\n| Phase 3: Combine for Design | Does the Right Thing → Intent → Domain Abstraction | Domain-level. Asks permission. |\n\nThe skill operates in two modes:\n\n- **audit-mode** — exhaustive scan of provided code, classifies every identifier by its current step, outputs a structured table grouped by phase. Does not rename.\n- **improve-mode** — interactive single-target improvement. Walks Phase 1 continuously, pauses before Phase 2 and Phase 3.\n\nMatch the depth of work to the user's actual story. Most naming improvements should stop after Phase 1.\n\n## Installation\n\n### Via marketplace (recommended)\n\n```\n/plugin marketplace add kawasima/evolutionary-naming\n/plugin install evolutionary-naming@kawasima-skills\n```\n\n### Via [skills.sh](https://skills.sh/)\n\n```bash\nnpx skills add kawasima/evolutionary-naming\n```\n\n### Manual install (single user)\n\n```bash\ngit clone https://github.com/kawasima/evolutionary-naming.git\ncp -r evolutionary-naming/skills/evolutionary-naming ~/.claude/skills/\n```\n\nClaude Code auto-discovers skills from `~/.claude/skills/`. No configuration required.\n\n## Usage\n\nThe skill activates automatically when you ask Claude to improve naming, refactor a class/method, or review naming quality.\n\n**Audit mode triggers:**\n- \"このコードの命名で改善余地ある?\"\n- \"命名レビューして\"\n- \"naming audit\"\n\n**Improve mode triggers:**\n- \"`d` を改善して\"\n- \"DocumentManager をリファクタリング\"\n- \"this method's name is unclear\"\n\nWhen the request is ambiguous (large code paste with no specific target), the skill asks which mode to use.\n\n## Files\n\n```\nskills/evolutionary-naming/\n├── SKILL.md          router and overview\n├── reference.md      shared 7-step diagnosis, transitions, red flags\n├── audit-mode.md     exhaustive scan workflow + table output\n└── improve-mode.md   interactive single-target + pause protocol\n```\n\n## License\n\nCC BY 4.0. See [LICENSE](./LICENSE).\n\n## Background and Acknowledgments\n\nThe 7-step / 3-phase model used in this skill is based on Arlo Belshee's \"Naming as a Process\" series (CC BY 3.0), one of the most thorough public treatments of evolutionary naming. The skill adapts that material into Claude Code's skill format with audit/improve modes and phase-boundary safety gates.\n\nReferences:\n- Original blog series: https://arlobelshee.com/tag/naming-is-a-process\n- Updated edition: https://www.digdeeproots.com/articles/naming-process/\n\nOther influences worth exploring:\n- Refactoring catalogs (extract method, rename, introduce parameter object) — Martin Fowler\n- Domain-Driven Design (Whole Value, Ubiquitous Language) — Eric Evans\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkawasima%2Fevolutionary-naming","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkawasima%2Fevolutionary-naming","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkawasima%2Fevolutionary-naming/lists"}