devlyn-cli 0.0.1 → 0.0.4

package/CLAUDE.md

@@ -0,0 +1,41 @@
+# Project Instructions
+
+## General
+
+- Proactively use subagents and skills where needed
+- Follow commit conventions in `.claude/commit-conventions.md`
+- Follow design system in `docs/design-system.md` for UI/UX work if exist
+
+## Investigation Workflow
+
+When investigating bugs, analyzing features, or exploring code:
+
+1. **Define exit criteria upfront** - Ask "What does 'done' look like?" before starting
+2. **Checkpoint progress** - Use TodoWrite every 5-10 minutes to save findings
+3. **Output intermediate summaries** - Provide "Current Understanding" snapshots so work isn't lost if interrupted
+4. **Always deliver findings** - Never end mid-analysis; at minimum output:
+   - Files examined
+   - Key findings
+   - Remaining unknowns
+   - Recommended next steps
+
+For complex investigations, use `/investigate` skill or spawn parallel Task agents to explore different areas simultaneously.
+
+## Feature Development
+
+1. **Plan first** - Always output a concrete implementation plan with specific file changes before writing code
+2. **Track progress** - Use TodoWrite to checkpoint each phase
+3. **Test validation** - Write tests alongside implementation; iterate until green
+4. **Small commits** - Commit working increments rather than large changesets
+
+For complex features, use the Plan agent to design the approach before implementation.
+
+## Debugging Workflow
+
+Use `/devlyn.resolve` for systematic bug fixing with test-driven validation.
+
+## Communication Style
+
+- Lead with **objective data** (popularity, benchmarks, community adoption) before personal opinions
+- When user asks "what's popular" or "what do others use", provide data-driven answers
+- Keep recommendations actionable and specific

package/README.md

@@ -1,43 +1,131 @@
+<div align="center">
+
 # devlyn-cli
 
-Claude Code 설정을 팀과 프로젝트 간에 공유하는 CLI 도구.
+**A shared configuration toolkit for Claude Code — standardize AI-powered workflows across your team and projects.**
+
+[![npm version](https://img.shields.io/npm/v/devlyn-cli.svg)](https://www.npmjs.com/package/devlyn-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+</div>
+
+---
+
+## Why devlyn-cli?
+
+[Claude Code](https://docs.anthropic.com/en/docs/claude-code) is powerful out of the box, but teams need **consistent workflows** — shared commands, proven prompts, commit conventions, and reusable skills.
+
+devlyn-cli installs a curated `.claude/` configuration into any project, giving your team:
+
+- Battle-tested slash commands for debugging, code review, UI design, and more
+- Reusable AI agent skills for investigation and prompt engineering
+- Product and feature spec templates
+- Commit message conventions
+
+Zero dependencies. One command. Works with any project.
 
-## 사용법
+## Quick Start
 
 ```bash
-# 새 프로젝트에 .claude 설정 설치
 npx devlyn-cli
+```
+
+That's it. The interactive installer walks you through the setup.
 
-# 프롬프트 없이 설치 (CI용)
+```bash
+# Non-interactive mode (for CI/CD)
 npx devlyn-cli -y
 
-# 최신 버전으로 업데이트
+# Update to the latest config
 npx devlyn-cli@latest
+
+# List all available commands and templates
+npx devlyn-cli list
+```
+
+## What Gets Installed
+
+```
+your-project/
+├── .claude/
+│   ├── commands/              # 9 slash commands
+│   ├── skills/                # 3 reusable AI skills
+│   ├── templates/             # Document templates
+│   └── commit-conventions.md  # Commit message standards
+└── CLAUDE.md                  # Project-level instructions
 ```
 
-## 포함된 Core Config
+## Commands
 
-- **commands/** - 커스텀 슬래시 커맨드 (devlyn.ui, devlyn.review 등)
-- **skills/** - AI 에이전트 스킬 (investigate, prompt-engineering 등)
-- **templates/** - 코드 템플릿
-- **commit-conventions.md** - 커밋 메시지 컨벤션
+Slash commands are invoked directly in Claude Code conversations (e.g., `/devlyn.resolve`).
+
+| Command | Description |
+|---|---|
+| `/devlyn.resolve` | Systematic bug fixing with root-cause analysis and test-driven validation |
+| `/devlyn.review` | Post-implementation code review — security, quality, best practices |
+| `/devlyn.ui` | Generate 5 distinct UI style explorations from a spec or reference image |
+| `/devlyn.feature-spec` | Transform product specs into implementable feature specifications |
+| `/devlyn.product-spec` | Generate or incrementally update product spec documents |
+| `/devlyn.discover-product` | Scan a codebase to generate feature-oriented product documentation |
+| `/devlyn.recommend-features` | Prioritize top 5 features to build next based on value and readiness |
+| `/devlyn.design-system` | Design system reference and guidance |
+| `/devlyn.handoff` | Create structured handoff docs for context window transitions |
+
+## Skills
+
+Skills are triggered automatically based on conversation context.
+
+| Skill | Description |
+|---|---|
+| `investigate` | Parallel code exploration with structured progress checkpoints |
+| `prompt-engineering` | Claude prompt optimization based on Anthropic best practices |
+| `feature-gap-analysis` | Identify missing features by comparing against baselines or competitors |
+
+## Templates
+
+| Template | Description |
+|---|---|
+| `template-product-spec.md` | Comprehensive product specification template |
+| `template-feature.spec.md` | Feature specification template |
+| `prompt-templates.md` | Reusable prompt snippets for common tasks |
 
 ## Optional Skill Packs
 
-설치 시 선택하거나, 나중에 수동 설치:
+During installation, you can choose to add third-party skill packs:
 
 ```bash
-# Vercel - React, Next.js, React Native best practices
+# Vercel — React, Next.js, and React Native best practices
 npx skills add vercel-labs/agent-skills
 
-# Supabase - Supabase integration patterns
+# Supabase — Supabase integration patterns
 npx skills add supabase/agent-skills
 ```
 
-## 업데이트
+## How It Works
 
-새 버전이 배포되면:
+1. Run `npx devlyn-cli` in your project
+2. The CLI copies the config files into `.claude/`
+3. Claude Code automatically reads `.claude/commands` and `.claude/skills`
+4. Invoke commands like `/devlyn.resolve` in your Claude Code session
+
+The installation is **idempotent** — run it again at any time to update to the latest config.
+
+## Requirements
+
+- Node.js 18+
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI
+
+## Contributing
+
+Contributions are welcome! Feel free to open an issue or submit a pull request.
+
+1. Fork the repository
+2. Create your branch (`git checkout -b feat/my-feature`)
+3. Commit your changes following the included [commit conventions](config/commit-conventions.md)
+4. Push to the branch (`git push origin feat/my-feature`)
+5. Open a Pull Request
+
+## License
+
+[MIT](LICENSE) — Donut Studio
 
-```bash
-npx devlyn-cli@latest
-```

package/bin/devlyn.js

@@ -290,6 +290,15 @@ async function init(skipPrompts = false) {
   const targetDir = getTargetDir();
   log('\n📁 Installing core config to .claude/', 'green');
   copyRecursive(CONFIG_SOURCE, targetDir, targetDir);
+
+  // Copy CLAUDE.md to project root
+  const claudeMdSrc = path.join(__dirname, '..', 'CLAUDE.md');
+  const claudeMdDest = path.join(process.cwd(), 'CLAUDE.md');
+  if (fs.existsSync(claudeMdSrc)) {
+    fs.copyFileSync(claudeMdSrc, claudeMdDest);
+    log('  → CLAUDE.md', 'dim');
+  }
+
   log('\n✅ Core config installed!', 'green');
 
   // Skip prompts if -y flag or non-interactive

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "devlyn-cli",
-  "version": "0.0.1",
+  "version": "0.0.4",
   "description": "Claude Code configuration toolkit for teams",
   "bin": {
     "devlyn": "bin/devlyn.js"
   },
   "files": [
     "bin",
-    "config"
+    "config",
+    "CLAUDE.md"
   ],
   "keywords": [
     "claude",
@@ -22,4 +23,4 @@
     "type": "git",
     "url": "git+https://github.com/fysoul17/devlyn-cli.git"
   }
-}
+}