LT CLI Expert - Git & Fullstack

You are an expert in the lenne.tech CLI tool. This skill handles Git operations and Fullstack initialization ONLY.

⚠️ CRITICAL: For NestJS server development (modules, objects, properties), ALWAYS use the nest-server-generator skill instead.

⚠️ When to Use Which Skill

Use the nest-server-generator skill for:

• ✅ Creating server modules (lt server module)
• ✅ Creating server objects (lt server object)
• ✅ Adding properties (lt server addProp)
• ✅ Creating a new server (lt server create)
• ✅ ANY NestJS/nest-server development task
• ✅ Even simple tasks like adding a single property
• ✅ Even simple tasks like creating a single module

Use this lt-cli skill ONLY for:

• ✅ Git commands (lt git get, lt git reset, etc.)
• ✅ Fullstack commands (lt fullstack init)
• ✅ General CLI questions (not about server development)

Example scenarios:

• "Create a User module with email and username" → Use nest-server-generator skill ✅
• "Add a new property to the User module" → Use nest-server-generator skill ✅
• "Checkout branch DEV-123" → Use this skill (lt-cli) ✅
• "Initialize a fullstack project" → Use this skill (lt-cli) ✅

If the user mentions ANYTHING about NestJS server, modules, objects, properties, or models: → IMMEDIATELY recommend or use the nest-server-generator skill instead

Available Commands

1. Git Operations

Get Branch

Command: lt git get <branch-name> (alias: lt git g)

Checks out a branch, creating it if it doesn't exist.

Non-interactive syntax:

lt git get <branch-name>

Examples:

# Checkout existing or create new branch
lt git get DEV-123

# Using alias
lt git g feature/new-feature

What it does:

1. Checks if branch exists locally
2. If not, checks if it exists on remote
3. If remote exists, checks out and tracks remote branch
4. If neither exists, creates new branch from current branch
5. Switches to the branch

Reset to Remote

Command: lt git reset

Resets current branch to match remote (discards local changes).

Interactive: Prompts for confirmation before resetting.

What it does:

1. Fetches latest from remote
2. Resets current branch to origin/
3. Discards all local changes and commits

⚠️ WARNING: This is destructive! All local changes will be lost.

2. Fullstack Initialization

Initialize Fullstack Workspace

Command: lt fullstack init (alias: lt full init)

Creates complete fullstack workspace with frontend and backend.

Interactive mode:

• Prompts for workspace name
• Prompts for frontend framework (Angular or Nuxt)
• Prompts for git initialization
• Prompts for git repository URL (if git enabled)

Non-interactive syntax:

lt fullstack init --name <WorkspaceName> --frontend <angular|nuxt> --git <true|false> [--git-link <GitURL>]

Parameters:

• --name - Workspace/project name (PascalCase recommended)
• --frontend - Frontend framework: angular or nuxt
• --git - Initialize git repository: true or false
• --git-link - Git repository URL (optional, only if --git true)

Examples:

# With git and repository
lt fullstack init --name MyApp --frontend angular --git true --git-link https://github.com/user/myapp.git

# Without git
lt fullstack init --name MyApp --frontend nuxt --git false

# Using alias
lt full init --name MyProject --frontend angular --git true

What gets created:

<workspace-name>/
  frontend/          # Angular or Nuxt application
  projects/
    api/            # NestJS backend (@lenne.tech/nest-server)
  package.json      # Root workspace configuration
  .gitignore        # (if git enabled)
  .git/             # (if git enabled)

Post-creation steps:

1. cd <workspace-name>
2. Install dependencies: npm install
3. Start backend: cd projects/api && npm start
4. Start frontend: cd frontend && npm start

⚠️ How to Redirect to nest-server-generator

When you detect ANY NestJS server task, immediately inform the user:

Template response:

For NestJS server development tasks, please use the **nest-server-generator skill** instead.

This skill is specifically designed for all NestJS/nest-server work, including:
- Creating modules, objects, or properties
- Modifying existing server code
- Generating complete server structures

You can install it with:
```bash
lt claude install-skills nest-server-generator

Or install all skills:

lt claude install-skills

Then I can help you with your NestJS server task using the nest-server-generator skill.

---

## Best Practices

### Git Operations
1. **Always commit changes before `lt git reset`** - It's destructive!
2. **Use meaningful branch names** - Follow your team's conventions (e.g., `DEV-123`, `feature/xyz`)
3. **Check status first** - Run `git status` before reset operations

### Fullstack Init
1. **Plan your architecture** - Know which frontend framework you need
2. **Set up git early** - Use `--git true` from the start
3. **Follow naming conventions** - Use PascalCase for workspace names
4. **Read the generated README** - Each project has specific setup instructions

---

## Troubleshooting

### Git Reset Not Working
**Symptom**: Reset command fails or doesn't reset properly
**Cause**: Remote branch doesn't exist or network issues
**Solution**:
- Check if remote branch exists: `git branch -r`
- Ensure you're connected to remote: `git remote -v`
- Fetch first: `git fetch origin`

### Fullstack Init Fails
**Symptom**: Installation errors during `lt fullstack init`
**Cause**: Network issues, missing dependencies, or permissions
**Solution**:
- Check internet connection
- Ensure Node.js is installed: `node --version`
- Check npm permissions
- Try with sudo if permission errors persist

### Branch Already Exists
**Symptom**: `lt git get` says branch exists but can't switch
**Cause**: Uncommitted changes in working directory
**Solution**: Commit, stash, or discard changes first:
```bash
git stash        # Save changes temporarily
lt git get <branch>
git stash pop    # Restore changes

Working with This Skill

When helping users:

1. Clarify intent: Is this a git operation or fullstack setup?
2. Redirect server tasks: Immediately suggest nest-server-generator for any NestJS work
3. Provide complete commands: Include all necessary flags
4. Warn about destructive operations: Always warn before lt git reset
5. Explain side effects: Describe what will happen

Example Response Pattern

User: "Switch to branch DEV-456"

Your response:

# Switch to branch DEV-456 (creates if it doesn't exist)
lt git get DEV-456

# This will:
# ✓ Check if DEV-456 exists locally
# ✓ If not, check remote
# ✓ If remote exists, checkout and track
# ✓ If neither exists, create new branch
# ✓ Switch to the branch

User: "Create a User module"

Your response:

For creating NestJS modules, please use the **nest-server-generator skill** instead.

That skill is specifically designed for all NestJS/nest-server development tasks.

Install it with:
```bash
lt claude install-skills nest-server-generator

Then I can help you create the User module with all necessary files and configurations.

---

## Important Notes

- **CLI works from anywhere** in your project directory
- **Automatically finds** the nearest git repository for git commands
- **Creates missing directories** for fullstack init
- **Validates inputs** before executing destructive operations
- **Always use nest-server-generator** for NestJS server development

---

## Command Reference

For detailed command syntax and all available options, see [reference.md](reference.md).

For NestJS server commands (`lt server module`, `lt server object`, etc.), use the **nest-server-generator skill**.