agent-configs 1.0.0

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "agent-configs",
+  "version": "1.0.0",
+  "description": "CLI tool to install curated Claude Code and Cursor configurations",
+  "main": "cli.js",
+  "bin": {
+    "agent-configs": "cli.js"
+  },
+  "engines": {
+    "node": ">=14.14.0"
+  },
+  "files": [
+    "cli.js",
+    "configs.json",
+    "README.md",
+    "commands/",
+    "skills/",
+    "rules/",
+    "agents/",
+    "hooks/",
+    "bundles/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/forrany/Agent-configs.git"
+  },
+  "keywords": [
+    "claude-code",
+    "cursor",
+    "ai-agent",
+    "skills",
+    "commands",
+    "rules",
+    "hooks",
+    "shared-memory",
+    "tdd",
+    "code-review",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "prepublishOnly": "node cli.js --help",
+    "publish:npm": "npm publish --registry https://registry.npmjs.org/"
+  },
+  "bugs": {
+    "url": "https://github.com/forrany/Agent-configs/issues"
+  },
+  "homepage": "https://github.com/forrany/Agent-configs#readme",
+  "packageManager": "pnpm@10.12.1+sha512.f0dda8580f0ee9481c5c79a1d927b9164f2c478e90992ad268bbb2465a736984391d6333d2c327913578b2804af33474ca554ba29c04a8b13060a717675ae3ac",
+  "dependencies": {
+    "@inquirer/prompts": "^8.2.0"
+  }
+}

package/rules/agents.md

@@ -0,0 +1,49 @@
+# Agent Orchestration
+
+## Available Agents
+
+Located in `~/.claude/agents/`:
+
+| Agent | Purpose | When to Use |
+|-------|---------|-------------|
+| planner | Implementation planning | Complex features, refactoring |
+| architect | System design | Architectural decisions |
+| tdd-guide | Test-driven development | New features, bug fixes |
+| code-reviewer | Code review | After writing code |
+| security-reviewer | Security analysis | Before commits |
+| build-error-resolver | Fix build errors | When build fails |
+| e2e-runner | E2E testing | Critical user flows |
+| refactor-cleaner | Dead code cleanup | Code maintenance |
+| doc-updater | Documentation | Updating docs |
+
+## Immediate Agent Usage
+
+No user prompt needed:
+1. Complex feature requests - Use **planner** agent
+2. Code just written/modified - Use **code-reviewer** agent
+3. Bug fix or new feature - Use **tdd-guide** agent
+4. Architectural decision - Use **architect** agent
+
+## Parallel Task Execution
+
+ALWAYS use parallel Task execution for independent operations:
+
+```markdown
+# GOOD: Parallel execution
+Launch 3 agents in parallel:
+1. Agent 1: Security analysis of auth.ts
+2. Agent 2: Performance review of cache system
+3. Agent 3: Type checking of utils.ts
+
+# BAD: Sequential when unnecessary
+First agent 1, then agent 2, then agent 3
+```
+
+## Multi-Perspective Analysis
+
+For complex problems, use split role sub-agents:
+- Factual reviewer
+- Senior engineer
+- Security expert
+- Consistency reviewer
+- Redundancy checker

package/rules/coding-style.md

@@ -0,0 +1,70 @@
+# Coding Style
+
+## Immutability (CRITICAL)
+
+ALWAYS create new objects, NEVER mutate:
+
+```javascript
+// WRONG: Mutation
+function updateUser(user, name) {
+  user.name = name  // MUTATION!
+  return user
+}
+
+// CORRECT: Immutability
+function updateUser(user, name) {
+  return {
+    ...user,
+    name
+  }
+}
+```
+
+## File Organization
+
+MANY SMALL FILES > FEW LARGE FILES:
+- High cohesion, low coupling
+- 200-400 lines typical, 800 max
+- Extract utilities from large components
+- Organize by feature/domain, not by type
+
+## Error Handling
+
+ALWAYS handle errors comprehensively:
+
+```typescript
+try {
+  const result = await riskyOperation()
+  return result
+} catch (error) {
+  console.error('Operation failed:', error)
+  throw new Error('Detailed user-friendly message')
+}
+```
+
+## Input Validation
+
+ALWAYS validate user input:
+
+```typescript
+import { z } from 'zod'
+
+const schema = z.object({
+  email: z.string().email(),
+  age: z.number().int().min(0).max(150)
+})
+
+const validated = schema.parse(input)
+```
+
+## Code Quality Checklist
+
+Before marking work complete:
+- [ ] Code is readable and well-named
+- [ ] Functions are small (<50 lines)
+- [ ] Files are focused (<800 lines)
+- [ ] No deep nesting (>4 levels)
+- [ ] Proper error handling
+- [ ] No console.log statements
+- [ ] No hardcoded values
+- [ ] No mutation (immutable patterns used)

package/rules/git-workflow.md

@@ -0,0 +1,45 @@
+# Git Workflow
+
+## Commit Message Format
+
+```
+<type>: <description>
+
+<optional body>
+```
+
+Types: feat, fix, refactor, docs, test, chore, perf, ci
+
+Note: Attribution disabled globally via ~/.claude/settings.json.
+
+## Pull Request Workflow
+
+When creating PRs:
+1. Analyze full commit history (not just latest commit)
+2. Use `git diff [base-branch]...HEAD` to see all changes
+3. Draft comprehensive PR summary
+4. Include test plan with TODOs
+5. Push with `-u` flag if new branch
+
+## Feature Implementation Workflow
+
+1. **Plan First**
+   - Use **planner** agent to create implementation plan
+   - Identify dependencies and risks
+   - Break down into phases
+
+2. **TDD Approach**
+   - Use **tdd-guide** agent
+   - Write tests first (RED)
+   - Implement to pass tests (GREEN)
+   - Refactor (IMPROVE)
+   - Verify 80%+ coverage
+
+3. **Code Review**
+   - Use **code-reviewer** agent immediately after writing code
+   - Address CRITICAL and HIGH issues
+   - Fix MEDIUM issues when possible
+
+4. **Commit & Push**
+   - Detailed commit messages
+   - Follow conventional commits format

package/rules/hooks.md

@@ -0,0 +1,46 @@
+# Hooks System
+
+## Hook Types
+
+- **PreToolUse**: Before tool execution (validation, parameter modification)
+- **PostToolUse**: After tool execution (auto-format, checks)
+- **Stop**: When session ends (final verification)
+
+## Current Hooks (in ~/.claude/settings.json)
+
+### PreToolUse
+- **tmux reminder**: Suggests tmux for long-running commands (npm, pnpm, yarn, cargo, etc.)
+- **git push review**: Opens Zed for review before push
+- **doc blocker**: Blocks creation of unnecessary .md/.txt files
+
+### PostToolUse
+- **PR creation**: Logs PR URL and GitHub Actions status
+- **Prettier**: Auto-formats JS/TS files after edit
+- **TypeScript check**: Runs tsc after editing .ts/.tsx files
+- **console.log warning**: Warns about console.log in edited files
+
+### Stop
+- **console.log audit**: Checks all modified files for console.log before session ends
+
+## Auto-Accept Permissions
+
+Use with caution:
+- Enable for trusted, well-defined plans
+- Disable for exploratory work
+- Never use dangerously-skip-permissions flag
+- Configure `allowedTools` in `~/.claude.json` instead
+
+## TodoWrite Best Practices
+
+Use TodoWrite tool to:
+- Track progress on multi-step tasks
+- Verify understanding of instructions
+- Enable real-time steering
+- Show granular implementation steps
+
+Todo list reveals:
+- Out of order steps
+- Missing items
+- Extra unnecessary items
+- Wrong granularity
+- Misinterpreted requirements

package/rules/patterns.md

@@ -0,0 +1,55 @@
+# Common Patterns
+
+## API Response Format
+
+```typescript
+interface ApiResponse<T> {
+  success: boolean
+  data?: T
+  error?: string
+  meta?: {
+    total: number
+    page: number
+    limit: number
+  }
+}
+```
+
+## Custom Hooks Pattern
+
+```typescript
+export function useDebounce<T>(value: T, delay: number): T {
+  const [debouncedValue, setDebouncedValue] = useState<T>(value)
+
+  useEffect(() => {
+    const handler = setTimeout(() => setDebouncedValue(value), delay)
+    return () => clearTimeout(handler)
+  }, [value, delay])
+
+  return debouncedValue
+}
+```
+
+## Repository Pattern
+
+```typescript
+interface Repository<T> {
+  findAll(filters?: Filters): Promise<T[]>
+  findById(id: string): Promise<T | null>
+  create(data: CreateDto): Promise<T>
+  update(id: string, data: UpdateDto): Promise<T>
+  delete(id: string): Promise<void>
+}
+```
+
+## Skeleton Projects
+
+When implementing new functionality:
+1. Search for battle-tested skeleton projects
+2. Use parallel agents to evaluate options:
+   - Security assessment
+   - Extensibility analysis
+   - Relevance scoring
+   - Implementation planning
+3. Clone best match as foundation
+4. Iterate within proven structure

package/rules/performance.md

@@ -0,0 +1,47 @@
+# Performance Optimization
+
+## Model Selection Strategy
+
+**Haiku 4.5** (90% of Sonnet capability, 3x cost savings):
+- Lightweight agents with frequent invocation
+- Pair programming and code generation
+- Worker agents in multi-agent systems
+
+**Sonnet 4.5** (Best coding model):
+- Main development work
+- Orchestrating multi-agent workflows
+- Complex coding tasks
+
+**Opus 4.5** (Deepest reasoning):
+- Complex architectural decisions
+- Maximum reasoning requirements
+- Research and analysis tasks
+
+## Context Window Management
+
+Avoid last 20% of context window for:
+- Large-scale refactoring
+- Feature implementation spanning multiple files
+- Debugging complex interactions
+
+Lower context sensitivity tasks:
+- Single-file edits
+- Independent utility creation
+- Documentation updates
+- Simple bug fixes
+
+## Ultrathink + Plan Mode
+
+For complex tasks requiring deep reasoning:
+1. Use `ultrathink` for enhanced thinking
+2. Enable **Plan Mode** for structured approach
+3. "Rev the engine" with multiple critique rounds
+4. Use split role sub-agents for diverse analysis
+
+## Build Troubleshooting
+
+If build fails:
+1. Use **build-error-resolver** agent
+2. Analyze error messages
+3. Fix incrementally
+4. Verify after each fix

package/rules/security.md

@@ -0,0 +1,36 @@
+# Security Guidelines
+
+## Mandatory Security Checks
+
+Before ANY commit:
+- [ ] No hardcoded secrets (API keys, passwords, tokens)
+- [ ] All user inputs validated
+- [ ] SQL injection prevention (parameterized queries)
+- [ ] XSS prevention (sanitized HTML)
+- [ ] CSRF protection enabled
+- [ ] Authentication/authorization verified
+- [ ] Rate limiting on all endpoints
+- [ ] Error messages don't leak sensitive data
+
+## Secret Management
+
+```typescript
+// NEVER: Hardcoded secrets
+const apiKey = "sk-proj-xxxxx"
+
+// ALWAYS: Environment variables
+const apiKey = process.env.OPENAI_API_KEY
+
+if (!apiKey) {
+  throw new Error('OPENAI_API_KEY not configured')
+}
+```
+
+## Security Response Protocol
+
+If security issue found:
+1. STOP immediately
+2. Use **security-reviewer** agent
+3. Fix CRITICAL issues before continuing
+4. Rotate any exposed secrets
+5. Review entire codebase for similar issues

package/rules/testing.md

@@ -0,0 +1,30 @@
+# Testing Requirements
+
+## Minimum Test Coverage: 80%
+
+Test Types (ALL required):
+1. **Unit Tests** - Individual functions, utilities, components
+2. **Integration Tests** - API endpoints, database operations
+3. **E2E Tests** - Critical user flows (Playwright)
+
+## Test-Driven Development
+
+MANDATORY workflow:
+1. Write test first (RED)
+2. Run test - it should FAIL
+3. Write minimal implementation (GREEN)
+4. Run test - it should PASS
+5. Refactor (IMPROVE)
+6. Verify coverage (80%+)
+
+## Troubleshooting Test Failures
+
+1. Use **tdd-guide** agent
+2. Check test isolation
+3. Verify mocks are correct
+4. Fix implementation, not tests (unless tests are wrong)
+
+## Agent Support
+
+- **tdd-guide** - Use PROACTIVELY for new features, enforces write-tests-first
+- **e2e-runner** - Playwright E2E testing specialist

package/skills/ai-config-architect/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: ai-config-architect
+description: AI 编程工具配置架构师。支持 Claude Code 和 Cursor 双平台，生成 rules、skills、commands、hooks、agents 配置。触发场景：(1) 总结项目经验为规则 (2) 创建工作流技能 (3) 设计自动化 hooks (4) 配置子代理 (5) 决策配置类型。使用前会询问目标平台和作用域。
+metadata:
+  author: everything-claude-code
+  version: "1.0"
+---
+
+# AI Config Architect
+
+支持 Claude Code / Cursor 双平台的配置生成器。
+
+## 使用流程
+
+生成配置前，先确认：
+
+1. **目标平台**: Claude Code 或 Cursor
+2. **作用域**: 全局 (global) 或 项目 (project)
+
+## 平台路径映射
+
+| 类型 | Claude Global | Claude Project | Cursor Global | Cursor Project |
+|------|---------------|----------------|---------------|----------------|
+| Commands | `~/.claude/commands/` | `.claude/commands/` | `~/.cursor/commands/` | `.cursor/commands/` |
+| Skills | `~/.claude/skills/` | `.claude/skills/` | `~/.cursor/skills/` | `.cursor/skills/` |
+| Agents | `~/.claude/agents/` | `.claude/agents/` | `~/.cursor/agents/` | `.cursor/agents/` |
+| Rules | `~/.claude/rules/` | `CLAUDE.md` | - | `.cursor/rules/` |
+| Hooks | `~/.claude/settings.json` | `.claude/settings.json` | `~/.cursor/hooks.json` | `.cursor/hooks.json` |
+
+## 配置类型决策
+
+```
+需求 → 类型
+├── 始终遵守的约束 → Rules
+├── 触发式工作流   → Skills
+├── 快捷命令入口   → Commands
+├── 事件自动响应   → Hooks
+└── 专家代理范围   → Agents
+```
+
+## 平台差异
+
+| 特性 | Claude Code | Cursor |
+|------|-------------|--------|
+| Rules 位置 | `CLAUDE.md` 或 `.claude/rules/` | `.cursor/rules/` (仅项目级) |
+| Hooks 格式 | 合并到 `settings.json` | 独立 `hooks.json` |
+| 全局 Rules | 支持 | 不支持 |
+
+## 详细指南
+
+按需查阅：
+
+- [平台配置详解](references/platforms.md) - Claude vs Cursor 差异
+- [Rules 模板](references/rules.md)
+- [Skills 模板](references/skills.md)
+- [Commands 模板](references/commands.md)
+- [Hooks 模板](references/hooks.md)
+- [Agents 模板](references/agents.md)
+- [组合方案](references/patterns.md)

package/skills/ai-config-architect/references/agents.md

@@ -0,0 +1,77 @@
+# Agents 模板
+
+## 用途
+
+具有特定范围和工具权限的专家代理。
+
+## 平台路径
+
+| 平台 | 全局 | 项目 |
+|------|------|------|
+| Claude | `~/.claude/agents/` | `.claude/agents/` |
+| Cursor | `~/.cursor/agents/` | `.cursor/agents/` |
+
+## 模板
+
+```markdown
+---
+name: [agent-name]
+description: [专业领域和触发场景]
+tools: ["Read", "Grep", "Glob", "Bash"]
+model: opus|sonnet|haiku
+---
+
+You are a [角色描述].
+
+When invoked:
+1. [操作 1]
+2. [操作 2]
+
+## [检查类别] (CRITICAL)
+- 检查项
+
+## Output Format
+[格式说明]
+
+## Approval Criteria
+- ✅ Approve: [条件]
+- ❌ Block: [条件]
+```
+
+## 示例
+
+```markdown
+---
+name: code-reviewer
+description: Code review specialist
+tools: ["Read", "Grep", "Glob", "Bash"]
+model: opus
+---
+
+You are a senior code reviewer.
+
+When invoked:
+1. Run git diff
+2. Review modified files
+
+## Security (CRITICAL)
+- Hardcoded credentials
+- SQL injection
+
+## Output Format
+\`\`\`
+[CRITICAL] Issue
+File: path:42
+Fix: How to fix
+\`\`\`
+```
+
+## 模型选择
+
+| 任务 | 模型 |
+|------|------|
+| 探索/搜索 | Haiku |
+| 简单编辑 | Haiku |
+| 多文件实现 | Sonnet |
+| 复杂架构 | Opus |
+| 安全分析 | Opus |

package/skills/ai-config-architect/references/commands.md

@@ -0,0 +1,66 @@
+# Commands 模板
+
+## 用途
+
+通过 `/command` 快速触发的工作流入口。
+
+## 平台路径
+
+| 平台 | 全局 | 项目 |
+|------|------|------|
+| Claude | `~/.claude/commands/` | `.claude/commands/` |
+| Cursor | `~/.cursor/commands/` | `.cursor/commands/` |
+
+## 模板
+
+```markdown
+---
+description: [简短描述]
+---
+
+# [Command Name]
+
+## What This Command Does
+
+1. **Step 1** - [描述]
+2. **Step 2** - [描述]
+
+## When to Use
+
+Use `/[command]` when:
+- 场景 1
+- 场景 2
+
+## Related
+
+- Agent: `agents/[name].md`
+- Skill: `skills/[name]/`
+```
+
+## 示例
+
+```markdown
+---
+description: TDD 工作流，测试先行
+---
+
+# TDD Command
+
+## What This Command Does
+
+1. **RED** - 写失败测试
+2. **GREEN** - 最小实现
+3. **REFACTOR** - 保持绿灯重构
+
+## Related
+
+Invokes `tdd-guide` agent
+```
+
+## Command vs Skill
+
+| Command | Skill |
+|---------|-------|
+| 快捷入口 | 完整知识 |
+| 简短 | 详细模式 |
+| 调用 agent | 被引用 |