Skip to content

CLAUDE.md

Latest commit

 

History

History
180 lines (157 loc) · 6.51 KB

CLAUDE.md

File metadata and controls

180 lines (157 loc) · 6.51 KB

MoiCle

Overview

NPM CLI package providing AI agents, commands, skills, and architecture references to accelerate project development with Claude Code.

Quick Reference

# Installation
npm install -g moicle
moicle install

# Commands
moicle install --global   # Symlinks to ~/.claude/
moicle install --project  # Copies to ./.claude/
moicle list               # List installed
moicle status             # Show enabled/disabled
moicle enable <item>      # Enable agent/command/skill
moicle disable <item>     # Disable agent/command/skill
moicle uninstall          # Remove

Project Structure

moicle/
├── bin/cli.js                      # CLI entry point
├── src/                            # TypeScript source
│   ├── types.ts                    # Type definitions
│   ├── index.ts                    # Exports
│   ├── commands/
│   │   ├── install.ts              # Interactive install
│   │   ├── uninstall.ts            # Remove installations
│   │   ├── list.ts                 # List installed items
│   │   ├── enable.ts               # Enable items (tabs UI)
│   │   ├── disable.ts              # Disable items (tabs UI)
│   │   ├── status.ts               # Show status
│   │   └── postinstall.ts          # npm postinstall message
│   └── utils/
│       ├── symlink.ts              # File operations
│       └── config.ts               # Config management
├── dist/                           # Compiled JS (gitignored)
├── assets/
│   ├── agents/
│   │   ├── developers/             # 5 stack-specific agents
│   │   └── utilities/              # 10 utility agents
│   ├── architecture/               # Architecture references
│   │   ├── clean-architecture.md
│   │   ├── go-backend.md
│   │   ├── laravel-backend.md
│   │   ├── react-frontend.md
│   │   ├── remix-fullstack.md
│   │   ├── flutter-mobile.md
│   │   └── monorepo.md
│   ├── commands/
│   │   ├── bootstrap.md
│   │   ├── brainstorm.md
│   │   └── marketing.md
│   └── skills/
│       ├── new-feature/
│       ├── hotfix/
│       ├── pr-review/
│       ├── release/
│       ├── refactor/
│       ├── tdd/
│       ├── onboarding/
│       ├── spike/
│       ├── documentation/
│       ├── api-integration/
│       ├── incident-response/
│       ├── deprecation/
│       ├── fix-pr-comment/
│       ├── logo-design/
│       ├── video-content/
│       ├── content-writer/
│       ├── architect-review/
│       └── sync-docs/
├── package.json
└── README.md

Architecture References

All agents reference these architecture files before coding:

File Use For
clean-architecture.md Core principles, all stacks
go-backend.md Go + Gin projects
laravel-backend.md Laravel + PHP projects
nodejs-nestjs.md Node.js + NestJS + Prisma projects
react-frontend.md React + Vite projects
remix-fullstack.md Remix projects
flutter-mobile.md Flutter projects
monorepo.md Monorepo projects

Agents

Developer Agents

Agent Tech Stack
@flutter-mobile-dev Flutter, Dart
@go-backend-dev Go, Gin
@laravel-backend-dev Laravel, PHP
@nodejs-backend-dev Node.js, NestJS, TypeScript, Prisma
@react-frontend-dev React, TypeScript, Vite
@remix-fullstack-dev Remix, React

Utility Agents

Agent Purpose
@api-designer REST/GraphQL API design
@clean-architect Clean Architecture + MVVM
@code-reviewer Code review
@db-designer Database schema
@devops CI/CD, Docker, K8s
@docs-writer Documentation
@perf-optimizer Performance
@refactor Refactoring
@security-audit Security
@test-writer Testing

Commands

/bootstrap

Project wizard with 5 stacks - reads architecture files first.

/brainstorm

6 ideation frameworks: First Principles, SCAMPER, Design Thinking, Working Backwards, 5 Whys, Rapid Fire.

/marketing

Comprehensive marketing plan wizard - combines logo design, video content, and content writing skills into a unified go-to-market strategy.

Skills (21)

Skill Trigger
new-feature "implement feature", "add feature", "build feature"
hotfix "fix bug", "hotfix", "urgent fix", "production issue"
deep-debug "deep debug", "trace bug", "find root cause", "hard bug", "investigate bug"
pr-review "review pr", "check pr", "review code"
review-changes "review changes", "review branch", "check branch", "review before pr"
release "release", "deploy"
refactor "refactor", "clean up", "improve code"
tdd "tdd", "test first", "test driven"
onboarding "explain codebase", "onboard", "new to project"
spike "spike", "prototype", "poc"
research "research", "tìm giải pháp", "find best practice", "so sánh giải pháp"
documentation "document", "generate docs", "write docs"
api-integration "integrate api", "add endpoint", "new api"
incident-response "incident", "outage", "production down"
deprecation "deprecate", "remove feature", "sunset"
fix-pr-comment "fix pr comment", "gh-fix-comment", "address pr feedback"
logo-design "design logo", "create logo", "brand identity", "visual identity"
video-content "create video", "video content", "video script", "video strategy"
content-writer "write content", "content strategy", "blog post", "social media content"
architect-review "architect-review", "architecture review", "review architecture", "review ddd"
sync-docs "sync docs", "sync documentation", "doc sync", "generate structured docs"

Development

Tech Stack

  • Node.js >= 18, TypeScript, ES Modules
  • Dependencies: chalk, commander, inquirer, ora
  • DevDependencies: typescript, @types/node, @types/inquirer

Build & Test

bun install
bun run build
bun link
moicle install

Key Conventions

  • Agents MUST read architecture files before coding
  • Config stored at ~/.claude/moicle-config.json
  • Disabled items renamed to .md.disabled
  • Enable/disable commands have interactive tabs UI (Agents, Commands, Skills)